클로드 코드(Claude Code) 실전 활용법 10가지 — SI 개발자를 위한 2026 꿀팁

SI 파견으로 고객사 상주를 계속하면서 "언젠가 프리랜서로 독립하고 싶다"고 생각하는 사람은 많을 것이다. 나도 그중 한 명이었다. 그런데 독립 준비라는 게 뭐부터 시작해야 할지 몰라서 결국 차일피일 미루기만 했다. 이 상황을 깨 준 게 Claude Code였다.

이 글에서는 매일 Claude Code를 실무에서 쓰고 있는 개발자로서 "이건 진짜 효과 있었다"는 팁을 체험담 형식으로 소개한다. 프리랜서로 독립하기 위한 기술적·실무적 준비에 어떻게 활용할 수 있는지도 함께 쓴다.

Claude Code란 무엇인가 (간단히)

Anthropic이 제공하는 CLI 기반 AI 코딩 어시스턴트다. 터미널에서 직접 호출할 수 있고, 파일 읽기/쓰기·코드 생성·커맨드 실행까지 한 번에 처리해 준다. 에디터 플러그인이 아니라 셸에 자연스럽게 녹아드는 느낌이 특징이다.

# 설치
npm install -g @anthropic-ai/claude-code

# 실행
claude

이것만으로 대화형 세션이 시작된다.

Tips 1: CLAUDE.md로 프로젝트 룰을 내 전용으로 정의해 봤다

처음에 감동한 게 이거다. 프로젝트 루트에 CLAUDE.md라는 파일을 두면 Claude가 그 룰을 반드시 읽고 나서 움직여 준다.

# CLAUDE.md 예시

## 코딩 규약
- TypeScript를 쓴다. any는 쓰지 않는다
- 함수는 100줄 이내로 유지한다
- 주석은 "왜"만 쓴다. "무엇을"은 코드로 전달한다

## 커밋 규칙
- feat: 기능 추가
- fix: 버그 수정
- chore: 잡무(의존성 업데이트 등)

## 금지 사항
- console.log를 코드에 남기지 않는다
- 라우터에 DB 직접 연결 코드를 쓰지 않는다

이것만 써 두면 매번 "TypeScript 써 줘", "any는 쓰지 마"라고 말할 필요가 없다. SI 파견 프로젝트에서 여러 프로젝트를 동시에 굴릴 때 특히 도움이 됐다. 프로젝트마다 CLAUDE.md를 바꾸면 컨텍스트 스위칭 비용이 급감한다.

프리랜서로 독립한 뒤 여러 클라이언트를 동시에 상대하게 됐을 때, 이 관리 방법은 분명히 힘을 발휘한다.

Tips 2: / 커맨드를 외우니 작업 속도가 확 붙었다

Claude Code에는 내장 슬래시 커맨드가 있다. 자주 쓰는 것:

특히 /compact는 장시간 세션에서 요긴하다. 컨텍스트가 비대해지면 응답 정확도가 떨어지는 게 체감되는데, /compact로 요약해 달라고 하면 답변의 날이 다시 선다.

# 긴 대화 도중 컨텍스트를 정리하고 싶을 때
/compact

# 현재 diff 리뷰를 즉시 실행
/code-review

# 커밋(스테이징이 끝난 경우) — 자연어로 요청
"스테이징된 변경 사항을 커밋해 줘"

Tips 3: Bash 툴 경유로 실제로 커맨드를 실행시켜 봤다

Claude Code의 대단한 점은 "코드를 쓴다"만이 아니라 "커맨드를 실행한다"까지 해 준다는 것이다.

실제로 해 본 대화:

나: 이 Next.js 프로젝트에서 사용되지 않는 import를 전부 찾아서 삭제해 줘

Claude: 그럼 먼저 ESLint의 no-unused-vars와 import/no-unused-modules로 조사하겠습니다.
[Bash: npx eslint . --rule '{"no-unused-vars": "error"}' --format json]
...(결과를 해석)
아래 파일에 미사용 import가 발견되었습니다:
- src/components/OldButton.tsx: import { useState } from 'react' 가 미사용
- src/utils/format.ts: import { addDays } from 'date-fns' 가 미사용

삭제해도 괜찮을까요?

이 인터랙티브한 확인 절차가 안전하고 쓰기 편하다. 승인 기반으로 움직이기 때문에 의도치 않은 변경이 실행되는 일이 없다.

Tips 4: 서브에이전트로 병렬 작업을 시켜 봤다 (이게 제일 놀랐다)

Claude Code에는 Agent 툴이 있어서 여러 서브태스크를 병렬로 실행할 수 있다.

실제 사용 사례:

나: 이 리포지토리의 API 엔드포인트를 전부 뽑아내고,
    동시에 테스트 커버리지도 계산하고,
    README도 최신 상태로 업데이트해 줘

Claude: 3개의 태스크를 병렬로 처리합니다:
  - Agent 1: API 엔드포인트 탐색 (grep + 코드 해석)
  - Agent 2: 테스트 커버리지 계산 (jest --coverage)
  - Agent 3: README 현황 확인
...

예전 같으면 하나씩 순서대로 하던 작업이 병렬로 돈다. 체감상 작업 시간이 절반에서 3분의 1로 줄어든 경우도 있었다.

프리랜서로 여러 프로젝트를 굴리면서 개인 개발까지 하는 경우, 이 멀티태스크 처리 능력은 사활이 걸린 문제가 된다.

Tips 5: git 조작은 거의 Claude에게 맡겨 봤다

커밋 메시지 짓는 데 은근히 시간이 샌다는 고민이 있었다. Claude Code에 맡겼더니 해결됐다.

# 스테이징하고 커밋까지 해 달라고 하는 경우
git add src/components/NewFeature.tsx
# Claude Code에 요청
"지금 스테이징한 파일을 적절한 커밋 메시지로 커밋해 줘"

[실행된 커맨드]
git diff --staged  # 변경분 확인
git log --oneline -5  # 최근 커밋 스타일 확인
git commit -m "feat: NewFeature 컴포넌트를 추가하고 사용자 입력 유효성 검사를 구현"

"Conventional Commits 형식으로"라고 한마디 덧붙이는 것만으로 프로젝트 규약에 맞춰 준다.

PR 작성도 마찬가지다:

"이 브랜치의 PR을 GitHub에서 작성해 줘.
본문에는 변경 내용과 테스트 절차를 포함해 줘"

# Claude가 실행하는 커맨드
gh pr create --title "feat: 사용자 인증 흐름 개선" --body "$(cat <<'EOF'
## 변경 내용
- 로그인 폼 유효성 검사 강화
- 에러 메시지 i18n 대응

## 테스트 절차
1. 로컬에서 npm run dev
2. /login 에 접속
3. 빈 필드로 전송해서 에러 확인
EOF
)"

이 흐름에 익숙해지고 나서 PR 리뷰 의뢰까지의 리드타임이 눈에 띄게 단축됐다.

Tips 6: 메모리 기능을 키우면 "내 전용 AI"가 되어 간다

Claude Code에는 영속 메모리 기능이 있다. ~/.claude/projects/<project>/memory/ 아래에 Markdown 파일을 두면 다음 세션에서도 참조해 준다.

[최신 정보] 이 디렉터리는 Claude Code의 '자동 메모리(auto memory)' 디렉터리입니다(v2.1.59부터 기본 활성화). MEMORY.md 인덱스가 매 세션 자동 로드되고, 상세 내용은 토픽별 파일로 나뉩니다. Claude가 작업 중 스스로 기록하는 게 기본이지만, 원문처럼 사용자가 직접 파일을 추가·편집해도 되고 세션 중 "이거 메모리에 기억해 둬"라고 요청해도 됩니다. /memory 커맨드로 파일 목록을 열어 편집할 수도 있습니다.

# memory/user.md
---
name: user-profile
description: 개발자의 스킬셋과 취향
metadata:
  type: user
---

Go와 TypeScript가 주축. React는 쓸 수 있지만 백엔드가 특기.
코드 주석은 필요 최소한파.
과도한 리팩터링을 제안받는 게 싫다.

이 파일을 꾸준히 키우면 매번 '내 취향'을 설명하지 않아도 된다. 몇 주쯤 이어 갔더니 거의 '아, 이 사람이라면 이렇게 쓰겠구나' 하는 느낌으로 결과가 나오기 시작했다.

Tips 7: /code-review로 셀프 리뷰를 자동화해 봤다

내 코드를 내가 리뷰하는 건 어렵다. 맹점이 생기기 마련이다. 그래서 Claude Code의 /code-review를 활용하고 있다.

# 현재 diff를 리뷰
/code-review

# 더 깊은 리뷰 (시간은 걸린다)
/code-review high

# GitHub의 PR을 리뷰 — PR 번호 지정
/review 123

실제로 나온 피드백 예:

## 코드 리뷰 결과

### 버그 가능성
- src/api/users.ts:45 — await 를 잊었을 가능성.
  `getUserById(id)` 는 Promise 를 반환하지만 결과를 직접 사용하고 있다

### 개선 제안
- src/utils/date.ts:12 — `new Date()` 의 직접 사용은
  타임존 문제를 일으키기 쉽다. date-fns의 utcToZonedTime을 검토

### 좋은 점
- 에러 핸들링이 일관적이다
- 타입 정의가 명확하다

프리랜서로 독립하면 코드 리뷰를 해 줄 동료가 없어진다. 이 툴이 그 공백을 메워 준다.

Tips 8: 커스텀 스킬로 반복 작업을 자동화했다

Claude Code에는 "스킬"이라는 개념이 있어서 반복해서 쓰는 프롬프트를 커맨드화할 수 있다. .claude/commands/에 두는 프로젝트 로컬 커맨드와 ~/.claude/commands/에 두는 글로벌 커맨드가 있다.

[최신 정보] 현재는 커스텀 슬래시 커맨드가 스킬로 통합되어, .claude/skills/ 아래 SKILL.md로 만드는 방식이 공식 권장입니다. 다만 .claude/commands/의 기존 파일도 그대로 동작합니다. 같은 이름이 겹치면 스킬 쪽이 우선합니다.

# .claude/commands/check-security.md

이 PR의 보안 관점 체크를 해 주세요:
1. SQL 인젝션 가능성
2. XSS 가능성
3. 인증·인가 누락
4. 기밀 정보 하드코딩
5. 의존 패키지의 알려진 취약점 (package.json을 확인)

문제가 있으면 중요도(고·중·저)를 붙여서 보고해 주세요.

이걸로 /check-security라고 치기만 하면 매번 같은 관점으로 보안 점검이 돌아간다.

프리랜서로 외주 개발을 할 때 "보안 면은 괜찮나요?"라는 클라이언트 질문에 이 점검 로그를 보여 주며 답할 수 있게 됐다.

Tips 9: 핫키와 단축키를 외웠더니 입력 속도가 올랐다

Claude Code 세션 중 쓸 수 있는 키 바인딩:

특히 Ctrl+J로 하는 여러 줄 입력은 긴 프롬프트를 쓸 때 필수가 됐다.

Tips 10: Worktree와 조합해서 리스크 제로로 실험한다

git worktree와 Claude Code를 조합하면 메인 브랜치를 건드리지 않고 과감한 변경을 시험할 수 있다.

# 새 worktree를 생성
git worktree add ../project-experiment feature/ai-refactor
cd ../project-experiment

# Claude Code에 과감한 리팩터링을 요청
claude
> 이 코드베이스 전체를 Clean Architecture에 맞춰 재구성해 줘

실험이 실패해도 메인 worktree는 무사하다. 성공하면? 머지하면 끝.

이 "안전하게 시험한다" 습관은 프리랜서로 독립한 뒤 포트폴리오를 만들 때도 그대로 통한다. 운영 중인 프로젝트를 망가뜨리지 않고 큰 변경을 시험해 볼 수 있으니까.

[프리랜서 독립 준비]Claude Code로 무엇이 바뀌는가

여기서부터는 시선을 조금 바꿔서, SI 파견 탈출과 프리랜서 독립 준비에 Claude Code가 어떤 도움이 되는지 짚어 본다.

기술적 차별화가 된다

2026년 현재, 'AI 툴을 제대로 다루는 개발자'와 '못 다루는 개발자'의 생산성 차이는 무시할 수 없는 수준이 됐다. 프리랜서로 독립한다면 이 차이가 곧 무기가 된다.

클라이언트에게 제안할 때 "Claude Code 기반 코드 리뷰 체계를 구축하겠습니다", "AI 어시스트를 포함해 개발 사이클을 단축하겠습니다"라고 말할 수 있으면 단가 협상에서도 유리해진다.

포트폴리오 제작이 가속된다

프리랜서로 독립하기 위한 준비로서 포트폴리오를 채우는 일은 빼놓을 수 없다. Claude Code를 쓰면 아이디어에서 돌아가는 프로토타입까지 가는 속도가 몰라보게 빨라진다.

나: 심플한 태스크 관리 앱을 만들고 싶어.
    Next.js + Supabase로, 인증 붙은 TODO 앱.
    먼저 설계부터 시작해 줘

Claude: 그럼 요건을 정리하고 나서 기술 구성을 제안하겠습니다...

이 대화에서 출발해 몇 시간이면 움직이는 프로토타입이 완성된다. 그걸 Vercel에 배포해 포트폴리오에 추가한다. 이 사이클이 빠르게 돌아간다.

견적 정밀도가 올라간다

프리랜서가 되고 처음 걸려 넘어지는 게 '견적'이다. SI 파견 시대에는 회사가 내 줬지만 독립하면 자기가 한다. Claude Code와 상의하면서 구현 난이도를 미리 가늠하기가 훨씬 쉬워졌다.

나: 이 README에 쓰여 있는 기능을 구현한다면
    어느 정도 공수가 들 것 같아? 리스크도 알려 줘

Claude: 기능별로 분해해서 추산해 보겠습니다...

한국에서 프리랜서 개발 일감을 구한다면 위시켓, 크몽, 프리모아 같은 플랫폼이 주요 경로입니다. 이런 플랫폼은 견적서·제안서 품질이 수주율에 직결되는데, Claude Code로 요건을 기능 단위로 분해해 공수를 산정한 결과를 제안서에 붙이면 신뢰도를 높일 수 있습니다.

정리: Claude Code는 "사고의 외부화" 툴이라고 생각한다

코드만 써 주는 게 아니다. 설계 아이디어를 받아 주는 스파링 상대, 코드 리뷰어, 문서 작성자, git 관리자까지 온갖 역할을 맡아 준다.

SI 파견 환경에서는 '잘하는 사람 옆에서 배우는' 기회가 있었다. 프리랜서로 독립하면 그 기회가 줄어든다. Claude Code는 그 자리를 어느 정도 대신해 준다(완전하지는 않지만).

일단 직접 손을 움직여 보는 게 먼저다. 설치하고 매일 루틴에 끼워 넣는다. 일주일이면 쓰는 방식이 달라지고, 1개월이면 '이거 없이는 일 못 한다'는 생각이 들 것이다.

# 지금 바로 시작
npm install -g @anthropic-ai/claude-code
claude

이게 전부다.

©2024-2026 ClaudeCode.to, Hand-crafted & made with Jaewoo Kim.

• 이메일문의: jaewoo@claudecode.to
• AI 에이전트 만드는 사람
• 기업 AI 강의 · 에이전트 개발 · 기술자문
• "AI한테 일 시키는 법, 제대로 알려드립니다"