[AI] Claude Code 실용적 활용 팁 9가지 (소스코드 분석 기반)

출처: unclejobs.ai (Threads) 요약: Claude Code 소스코드 분석을 통해 밝혀진, 단순 채팅을 넘어 '에이전트 오케스트레이션 플랫폼'으로 활용하기 위한 구체적인 설정 및 사용법.

---

1. CLAUDE.md는 매 턴마다 다시 읽힙니다.

세션 시작 시 한 번만 읽는 것이 아니라, 메시지를 보낼 때마다 다시 읽습니다. 이는 소스코드에서 확인된 동작으로, AI의 행동을 제어하는 가장 강력한 수단입니다.

• 4단계 계층 구조: 글로벌 (~/.claude/CLAUDE.md), 프로젝트 (./CLAUDE.md), 모듈별 규칙 (.claude/rules/*.md), 로컬 메모 (CLAUDE.local.md) 순으로 적용됩니다.
• 활용법: 아키텍처 결정, 파일 규칙, 테스트 패턴, "절대 하지 말아야 할" 규칙 등을 명시해두면 매번 AI의 판단에 반영됩니다.

2. 서브에이전트 5개를 돌려도 비용은 1개와 거의 같습니다.

서브에이전트를 생성(fork)하면 부모 컨텍스트의 바이트 단위 복사본을 만들고, API가 이 프롬프트를 캐시하기 때문에 비용이 거의 늘어나지 않습니다.

• 3가지 실행 모델:
  • fork: 부모 컨텍스트를 상속하여 캐시 효율을 극대화합니다.
  • teammate: 별도 터미널 패널(tmux/iTerm)에서 파일 기반 메일박스로 통신합니다.
  • worktree: 독립된 git 워크트리로 에이전트별 브랜치를 격리하여 안전하게 작업합니다.
• 시사점: 보안 감사, 리팩토링, 테스트 작성, 문서 업데이트, 버그 수정을 동시에 병렬로 처리할 수 있는 구조가 이미 내장되어 있습니다.

3. 권한 팝업을 매번 클릭하는 것은 설정 실패입니다.

"이 작업을 허용할까요?" 팝업이 뜰 때마다 클릭하는 것은 정상적인 사용 경험이 아닙니다. settings.json에 glob 패턴으로 허용 범위를 미리 지정해두어야 합니다.

• 설정 예시: Bash(npm *), Bash(git *), Edit(src/**) 와 같이 허용할 명령어와 파일 범위를 명시할 수 있습니다.
• Auto 모드: 새로 생긴 auto 모드는 LLM 분류기가 각 동작의 위험도를 판단하여 안전한 작업은 자동으로 승인해줍니다.

4. 5가지 컨텍스트 압축 전략을 이해하고 활용해야 합니다.

Anthropic 엔지니어들이 컨텍스트 초과 문제 해결에 많은 노력을 기울였다는 증거입니다. 자동 압축을 기다리기보다, 필요할 때 수동으로 개입하는 것이 중요합니다.

• 5가지 전략: microcompact(오래된 도구 결과 제거), context collapse(대화 구간 요약), session memory(핵심 맥락 파일 추출), full compact(전체 히스토리 요약), PTL truncation(가장 오래된 메시지 그룹 폐기)
• 핵심 조언: /compact 명령어를 게임의 '수동 세이브'처럼 사용하세요. 중요한 맥락이 날아가기 전에 보존하고 불필요한 내용은 정리할 수 있습니다.

5. Hook 시스템이 진짜 확장 API입니다.

PreToolUse(도구 실행 전), PostToolUse(실행 후), UserPromptSubmit(메시지 전송 시) 등 25개 이상의 라이프사이클 이벤트에 사용자 정의 로직을 연결할 수 있습니다.

• UserPromptSubmit 훅: 메시지를 보낼 때마다 자동으로 테스트 결과나 최신 git diff를 컨텍스트에 첨부할 수 있어 매우 강력합니다.
• 5가지 훅 종류: command(쉘 명령), prompt(LLM 맥락 주입), agent(에이전트 검증), HTTP(웹훅), function(JS 실행)

6. 세션을 매번 새로 시작하지 마세요.

모든 대화는 JSONL 파일로 저장되며, 세션을 이어가면 session memory가 축적되어 AI가 더 똑똑하게 행동합니다.

• 세션 명령어:
  • --continue: 마지막 세션을 이어서 시작합니다.
  • --resume: 특정 세션을 골라서 다시 엽니다.
  • --fork-session: 과거 대화의 특정 지점에서 새로운 브랜치를 만듭니다.
• 비유: 매번 새 세션을 여는 것은 IDE를 1시간마다 껐다 켜는 것과 같습니다.

7. 읽기는 병렬, 쓰기는 순차입니다.

Claude Code는 속도와 안정성을 모두 고려하여 도구를 실행합니다.

• 병렬 실행 (읽기): 파일 10개를 읽어야 하면 동시에 읽어 속도를 높입니다.
• 순차 실행 (쓰기): 파일 3개를 수정해야 하면 충돌 방지를 위해 하나씩 순서대로 처리합니다.

8. 중간에 끊는 것을 두려워하지 마세요.

전체 파이프라인이 비동기 제너레이터 방식으로 동작하므로, Esc 키를 누르면 현재 스트리밍만 깔끔하게 중단되고 이전 맥락은 그대로 보존됩니다.

• 시사점: AI가 잘못된 방향으로 가고 있다면, 끝까지 기다리지 말고 즉시 중단하고 방향을 바로잡아주는 것이 효율적입니다.

9. 결론: 설정하고, 병렬로 돌리고, 세션을 이어가세요.

Claude Code를 잘 쓰는 것은 프롬프트 엔지니어링의 영역이 아닙니다. 소스코드 분석 결과, 이 도구는 단순한 터미널 채팅이 아니라 **'에이전트 오케스트레이션 플랫폼'**에 가깝습니다.

• 핵심: 설정을 통해 권한을 자동화하고, Hook으로 필요한 정보를 주입하며, 병렬 에이전트로 작업을 동시에 처리하고, 세션을 이어가며 컨텍스트를 축적하는 것이 핵심입니다.