Claude Code 베스트 프랙티스

TMT

최근 저희는 에이전트 기반 코딩을 위한 커맨드라인 도구인 Claude Code를 출시했습니다. 연구 프로젝트로 개발된 Claude Code는 Anthropic의 엔지니어와 연구자들이 Claude를 코딩 워크플로우에 더 자연스럽게 통합할 수 있도록 해줍니다.

Claude Code는 의도적으로 저수준이며 특정 워크플로우를 강요하지 않습니다. 거의 원시 모델에 가까운 접근을 제공하면서도, 유연하고, 맞춤화 가능하며, 스크립트화할 수 있고, 안전한 강력한 도구입니다. 하지만 이 유연성은 에이전트 기반 코딩 도구에 익숙하지 않은 엔지니어들에게는 학습 곡선을 제공합니다—최적의 사용법을 스스로 개발할 때까지는 말이죠.

이 글에서는 Anthropic 내부 팀과 외부 엔지니어들이 다양한 코드베이스, 언어, 환경에서 Claude Code를 사용할 때 효과적이었던 일반적인 패턴을 정리했습니다. 이 목록의 내용은 절대적이거나 보편적으로 적용되는 것이 아니니, 시작점으로 참고하시고 자신에게 맞는 방법을 실험해보시길 권장합니다!

더 자세한 정보가 필요하다면 claude.ai/code의 문서를 참고하세요. 이 글에서 언급한 모든 기능과 추가 예시, 구현 세부사항, 고급 기법이 포함되어 있습니다.

1. 환경을 맞춤 설정하세요

Claude Code는 에이전트 기반 코딩 어시스턴트로, 프롬프트에 자동으로 컨텍스트를 불러옵니다. 이 컨텍스트 수집은 시간과 토큰을 소모하지만, 환경 튜닝을 통해 최적화할 수 있습니다.

a. ‎⁠`CLAUDE.md`⁠ 파일을 만드세요

‎⁠CLAUDE.md⁠는 Claude가 대화를 시작할 때 자동으로 컨텍스트에 불러오는 특별한 파일입니다. 다음과 같은 내용을 문서화하기에 이상적입니다:

자주 쓰는 bash 명령어
핵심 파일 및 유틸리티 함수
코드 스타일 가이드라인
테스트 지침
저장소 에티켓(예: 브랜치 네이밍, 머지 vs 리베이스 등)
개발 환경 설정(예: pyenv 사용, 지원되는 컴파일러 등)
프로젝트 특유의 예외적 동작이나 경고
Claude가 기억하길 바라는 기타 정보

‎⁠CLAUDE.md⁠ 파일에는 정해진 형식이 없습니다. 간결하고 사람이 읽기 쉽게 유지하는 것이 좋습니다. 예시:

# Bash commands
- npm run build: 프로젝트 빌드
- npm run typecheck: 타입체커 실행

# Code style
- ES 모듈(import/export) 문법 사용, CommonJS(require)는 사용하지 않음
- 가능하면 import 시 구조 분해 할당 사용(예: import { foo } from 'bar')

# Workflow
- 여러 코드 변경 후에는 반드시 타입체크
- 성능을 위해 전체 테스트 스위트가 아닌 단일 테스트 실행을 선호

‎⁠CLAUDE.md⁠ 파일은 여러 위치에 둘 수 있습니다:

저장소 루트 또는 ‎⁠claude⁠를 실행하는 위치(가장 일반적). ‎⁠CLAUDE.md⁠로 이름을 짓고 git에 커밋해 팀과 공유하세요(권장). 또는 ‎⁠CLAUDE.local.md⁠로 하고 ‎⁠.gitignore⁠에 추가할 수도 있습니다.
실행 디렉토리의 상위 폴더. 모노레포에서 유용하며, 여러 위치의 ‎⁠CLAUDE.md⁠가 자동으로 컨텍스트에 포함됩니다.
실행 디렉토리의 하위 폴더. 이 경우 Claude는 필요할 때 하위 디렉토리의 ‎⁠CLAUDE.md⁠를 불러옵니다.
홈 폴더(‎⁠~/.claude/CLAUDE.md⁠). 모든 Claude 세션에 적용됩니다.

‎⁠/init⁠ 명령을 실행하면 Claude가 자동으로 ‎⁠CLAUDE.md⁠를 생성합니다.

b. ‎⁠`CLAUDE.md`⁠ 파일을 다듬으세요

‎⁠CLAUDE.md⁠는 Claude의 프롬프트 일부가 되므로, 자주 쓰는 프롬프트처럼 다듬어야 합니다. 흔한 실수는 내용을 너무 많이 추가하고 효과를 검증하지 않는 것입니다. 실험을 통해 어떤 내용이 모델의 지시 이행에 가장 효과적인지 확인하세요.

수동으로 내용을 추가하거나, # 키를 눌러 Claude에게 명령을 내리면 해당 내용이 자동으로 ‎⁠CLAUDE.md⁠에 반영됩니다. 많은 엔지니어들이 코딩 중 자주 # 사용해 명령, 파일, 스타일 가이드라인을 문서화하고, 커밋에 ‎⁠CLAUDE.md⁠ 변경사항을 포함해 팀원들과 공유합니다.

Anthropic에서는 가끔 CLAUDE.md를 프롬프트 개선기에 돌리고, “IMPORTANT”나 “YOU MUST” 등 강조를 추가해 지시 이행률을 높이기도 합니다.

c. Claude의 허용 도구 목록을 관리하세요

기본적으로 Claude Code는 시스템을 변경할 수 있는 모든 작업(파일 쓰기, bash 명령, MCP 도구 등)에 대해 권한을 요청합니다. 이는 안전을 우선시한 보수적 설계입니다. 안전하다고 판단되는 도구나 쉽게 되돌릴 수 있는 도구(예: 파일 편집, ‎⁠git commit⁠)는 허용 목록에 추가할 수 있습니다.

허용 도구를 관리하는 네 가지 방법:

세션 중 프롬프트가 뜨면 “항상 허용” 선택
Claude Code 실행 후 ‎⁠/permissions⁠ 명령으로 도구 추가/제거(예: Edit, Bash(git commit:*), mcp__puppeteer__puppeteer_navigate 등)
‎⁠.claude/settings.json⁠ 또는 ‎⁠~/.claude.json을 수동 편집(전자는 소스 컨트롤에 커밋해 팀과 공유 권장)
세션별로 ‎⁠--allowedTools⁠ CLI 플래그 사용

d. GitHub을 쓴다면 gh CLI를 설치하세요

Claude는 ‎⁠gh⁠ CLI를 사용해 GitHub 이슈 생성, PR 열기, 댓글 읽기 등 다양한 작업을 할 수 있습니다. ‎⁠gh⁠가 없으면 GitHub API나 MCP 서버를 사용할 수 있습니다.

2. Claude에게 더 많은 도구를 제공하세요

Claude는 셸 환경에 접근할 수 있어, 자신이 쓰는 편의 스크립트나 함수처럼 Claude도 활용할 수 있습니다. MCP 및 REST API를 통한 복잡한 도구도 사용할 수 있습니다.

a. bash 도구와 함께 Claude 사용

Claude Code는 bash 환경을 상속받아 모든 도구에 접근할 수 있습니다. Claude는 일반적인 유닉스 도구와 ‎⁠gh는 알지만, 커스텀 도구는 직접 알려줘야 합니다:

도구 이름과 사용 예시를 Claude에게 알려주세요
‎⁠--help⁠ 실행으로 도구 문서를 확인하라고 지시하세요
자주 쓰는 도구는 ‎⁠CLAUDE.md⁠에 문서화하세요

b. MCP와 함께 Claude 사용

Claude Code는 MCP 서버이자 클라이언트로 동작합니다. 클라이언트로서 여러 MCP 서버에 연결해 세 가지 방식으로 도구를 사용할 수 있습니다:

프로젝트 설정(해당 디렉토리에서 Claude Code 실행 시 사용 가능)
글로벌 설정(모든 프로젝트에서 사용 가능)
체크인된 ‎⁠.mcp.json⁠ 파일(저장소를 사용하는 모든 사람이 사용 가능). 예를 들어 Puppeteer, Sentry 서버를 ‎⁠.mcp.json⁠에 추가하면 모든 엔지니어가 바로 사용할 수 있습니다.

MCP 사용 시 ‎⁠--mcp-debug⁠ 플래그로 설정 문제를 진단할 수 있습니다.

c. 커스텀 슬래시 명령어 사용

반복되는 워크플로우(디버깅 루프, 로그 분석 등)는 ‎⁠.claude/commands⁠ 폴더에 마크다운 파일로 프롬프트 템플릿을 저장하세요. /를 입력하면 슬래시 명령어 메뉴에서 사용할 수 있습니다. git에 커밋해 팀과 공유할 수 있습니다.

커스텀 명령어는 $ARGUMENTS 키워드로 파라미터를 전달할 수 있습니다.

예시: GitHub 이슈를 자동으로 가져와 수정하는 명령어

Please analyze and fix the GitHub issue: $ARGUMENTS.

Follow these steps:

1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR

Remember to use the GitHub CLI (`gh`) for all GitHub-related tasks.

위 내용을 .claude/commands/fix-github-issue.md에 넣으면 /project:fix-github-issue 명령어로 사용할 수 있습니다. 예를 들어 /project:fix-github-issue 1234⁠로 Claude가 1234번 이슈를 고치게 할 수 있습니다. 개인 명령어는 ~/.claude/commands 폴더에 두면 모든 세션에서 사용 가능합니다.

3. 일반적인 워크플로우를 시도해보세요

Claude Code는 특정 워크플로우를 강요하지 않으므로, 원하는 방식으로 사용할 수 있습니다. 커뮤니티에서 효과적이었던 패턴은 다음과 같습니다:

a. 탐색, 계획, 코딩, 커밋

다양한 문제에 적합한 워크플로우입니다:

Claude에게 관련 파일, 이미지, URL을 읽으라고 요청(예: “로깅을 담당하는 파일을 읽어라” 또는 “logging.py를 읽어라”). 아직 코드는 작성하지 말라고 명확히 지시하세요.

복잡한 문제라면 서브에이전트 사용을 권장합니다. 초기에 세부사항을 확인하거나 질문을 조사하도록 Claude에게 지시하면, 컨텍스트를 효율적으로 사용할 수 있습니다.

문제 접근 계획을 세우라고 요청. “think”, “think hard”, “think harder”, “ultrathink” 등으로 사고 예산을 늘릴 수 있습니다.

결과가 괜찮으면, Claude에게 계획을 문서나 GitHub 이슈로 만들게 하세요. 구현이 마음에 들지 않을 때 이 지점으로 되돌아올 수 있습니다.

Claude에게 솔루션을 코드로 구현하게 하세요. 구현 중에 솔루션의 타당성을 검증하라고 요청하는 것도 좋습니다.
결과를 커밋하고 PR을 만들게 하세요. 필요하다면 README나 changelog도 업데이트하게 하세요.

1~2단계가 매우 중요합니다. 이를 생략하면 Claude가 바로 코딩에 들어가는데, 복잡한 문제일수록 사전 조사와 계획이 성능을 크게 높입니다.

b. 테스트 작성, 커밋; 코드 작성, 반복, 커밋

단위/통합/E2E 테스트로 쉽게 검증 가능한 변경에 적합한 Anthropic의 즐겨 쓰는 워크플로우입니다. TDD가 에이전트 기반 코딩에서 더욱 강력해집니다:

예상 입출력 쌍을 기반으로 테스트를 작성하게 하세요. TDD임을 명확히 하여, 아직 없는 기능에 대한 모의 구현을 피하게 하세요.
테스트를 실행해 실패하는지 확인하게 하세요. 이 단계에서는 구현 코드를 작성하지 않도록 명확히 지시하세요.
테스트에 만족하면 커밋하게 하세요.
테스트를 통과하는 코드를 작성하게 하세요. 테스트는 수정하지 말라고 지시하세요. 여러 번 반복하며 코드를 개선하게 하세요.

이 단계에서 독립적인 서브에이전트로 구현이 테스트에 과적합되지 않았는지 검증하게 할 수 있습니다.

변경에 만족하면 코드를 커밋하게 하세요.

Claude는 명확한 목표(테스트, 시각적 목업 등)가 있을 때 가장 잘 작동합니다.

c. 코드 작성, 결과 스크린샷, 반복

테스트 워크플로우와 유사하게, 시각적 목표를 Claude에게 제공할 수 있습니다:

Claude가 브라우저 스크린샷을 찍을 수 있게 하세요(예: Puppeteer MCP 서버, iOS 시뮬레이터 MCP 서버, 또는 수동으로 스크린샷 복사/붙여넣기).
시각적 목업을 제공하세요(이미지 복사/붙여넣기, 드래그 앤 드롭, 파일 경로 제공 등).
디자인을 코드로 구현하게 하고, 결과 스크린샷을 찍어 반복하게 하세요.
만족하면 커밋하게 하세요.

Claude도 사람처럼 반복할수록 결과가 좋아집니다.

d. Safe YOLO 모드

Claude를 감독하지 않고 ‎⁠claude --dangerously-skip-permissions⁠로 모든 권한 확인을 건너뛰고 작업을 완료할 수 있습니다. 린트 오류 수정, 보일러플레이트 코드 생성 등에는 효과적입니다.

하지만 임의 명령 실행은 위험하며, 데이터 손실, 시스템 손상, 데이터 유출(프롬프트 인젝션 등)로 이어질 수 있습니다. 컨테이너(인터넷 미접속)에서만 사용하세요. Docker Dev Containers를 사용은 레퍼런스 구현에서 확인하세요.

e. 코드베이스 Q&A

새 코드베이스에 온보딩할 때 Claude Code로 학습과 탐색을 할 수 있습니다. 페어 프로그래밍에서 동료에게 묻듯 Claude에게 질문하세요. Claude는 코드베이스를 탐색해 답을 찾습니다.

예시 질문:

로깅은 어떻게 동작하나요?
새 API 엔드포인트는 어떻게 만드나요?
‎⁠foo.rs⁠ 134번째 줄의 async move { ... }는 무슨 역할인가요?
‎⁠CustomerOnboardingFlowImpl은 어떤 엣지 케이스를 처리하나요?
333번째 줄에서 왜 ‎⁠foo()⁠ 대신 ‎⁠bar()⁠를 호출하나요?
‎⁠baz.py⁠ 334번째 줄과 동일한 Java 코드는 무엇인가요?

Anthropic에서는 이 방식이 온보딩의 핵심 워크플로우가 되었고, 적응 시간을 크게 줄이고 동료 엔지니어의 부담도 줄였습니다.

f. git과 상호작용

Claude는 git 작업도 효과적으로 처리합니다. 많은 Anthropic 엔지니어가 git 작업의 90% 이상을 Claude로 처리합니다:

git 히스토리 검색(예: “v1.2.3에 포함된 변경사항은?”, “이 기능의 소유자는?”, “이 API는 왜 이렇게 설계됐나?”)
커밋 메시지 작성(변경사항과 최근 히스토리를 참고해 자동 작성)
복잡한 git 작업(파일 되돌리기, 리베이스 충돌 해결, 패치 비교/이식 등)

g. GitHub과 상호작용

Claude Code는 GitHub 작업도 관리할 수 있습니다:

PR 생성: “pr”만 입력해도 diff와 컨텍스트를 참고해 적절한 커밋 메시지를 생성합니다.
코드 리뷰 코멘트 일괄 처리: PR의 코멘트를 고치라고 지시하면 자동으로 수정 후 PR 브랜치에 푸시합니다.
빌드 실패/린트 경고 수정
이슈 분류 및 트리아지: 오픈 이슈를 반복적으로 처리하게 할 수 있습니다.

이로써 gh 명령어를 외울 필요 없이 반복 작업을 자동화할 수 있습니다.

h. Jupyter 노트북 작업

Anthropic의 연구자와 데이터 과학자들은 Claude Code로 Jupyter 노트북을 읽고 씁니다. Claude는 이미지 등 출력도 해석할 수 있어 데이터 탐색과 상호작용이 빠릅니다. Claude Code와 ‎⁠.ipynb⁠ 파일을 VS Code에서 나란히 열어두는 워크플로우를 추천합니다.

동료에게 보여주기 전 노트북이나 시각화를 “미적으로 보기 좋게” 만들어달라고 Claude에 요청하면, 사람이 보기 좋은 결과를 얻을 수 있습니다.

4. 워크플로우 최적화

아래 제안은 모든 워크플로우에 적용됩니다:

a. 지시를 구체적으로 하세요

Claude Code는 구체적인 지시를 받을수록 성공률이 높아집니다. 처음부터 명확히 지시하면 나중에 수정할 일이 줄어듭니다.

나쁜 예	좋은 예
foo.py에 테스트 추가	foo.py에서 사용자가 로그아웃된 엣지 케이스를 다루는 새 테스트 케이스 작성. mock은 사용하지 말 것
ExecutionFactory API가 왜 이상한가?	ExecutionFactory의 git 히스토리를 살펴보고 API가 어떻게 만들어졌는지 요약
캘린더 위젯 추가	홈 페이지의 기존 위젯 구현 방식을 참고해 코드와 인터페이스 분리 패턴을 파악(HotDogWidget.php 참고). 동일 패턴으로 월 선택 및 연도 페이지네이션이 가능한 새 캘린더 위젯을 라이브러리 추가 없이 구현

Claude는 의도를 추론할 수 있지만, 마음을 읽을 수는 없습니다. 구체성이 기대치와의 일치를 높입니다.

b. Claude에게 이미지를 제공하세요

Claude는 이미지와 다이어그램을 잘 다룹니다:

스크린샷 붙여넣기(macOS: cmd+ctrl+shift+4로 클립보드에 저장, ctrl+v로 붙여넣기)
이미지 드래그 앤 드롭
파일 경로 제공

UI 개발의 디자인 목업, 시각적 차트 분석 등에 특히 유용합니다.

c. Claude가 볼 파일을 명시하세요

탭 완성으로 저장소 내 파일/폴더를 빠르게 참조해 Claude가 올바른 리소스를 찾고 수정할 수 있게 하세요.

d. Claude에게 URL을 제공하세요

프롬프트에 URL을 붙여넣으면 Claude가 해당 내용을 읽을 수 있습니다. 동일 도메인(예: docs.foo.com)에 대한 권한 프롬프트를 피하려면 ‎⁠/permissions⁠로 도메인을 허용 목록에 추가하세요.

e. 초기에 자주 방향을 수정하세요

자동 승인 모드(shift+tab으로 토글)로 Claude가 자율적으로 작업하게 할 수 있지만, 적극적으로 협업하며 방향을 잡아주는 것이 더 좋은 결과를 냅니다.

방향 수정에 유용한 네 가지 도구:

코딩 전 계획을 세우게 하세요. 계획이 괜찮은지 확인 전까지 코딩하지 말라고 명확히 지시하세요.
Escape로 Claude의 작업을 중단(생각, 도구 호출, 파일 편집 등 모든 단계에서 가능)
Escape 두 번으로 히스토리로 돌아가 프롬프트 수정 및 반복
Claude에게 변경사항을 되돌리게 요청(#2번과 함께 사용해 다른 접근 시도)

Claude Code가 처음부터 완벽하게 문제를 해결하는 경우도 있지만, 위 도구를 활용하면 더 빠르고 좋은 결과를 얻을 수 있습니다.

f. `‎⁠/clear⁠`로 컨텍스트를 정리하세요

긴 세션에서는 컨텍스트 창이 불필요한 대화, 파일 내용, 명령어로 가득 차 성능이 저하될 수 있습니다. 작업 사이사이 ‎⁠/clear⁠ 명령으로 컨텍스트를 자주 초기화하세요.

g. 복잡한 워크플로우에는 체크리스트와 스크래치패드를 사용하세요

여러 단계가 필요한 대규모 작업(코드 마이그레이션, 다수의 린트 오류 수정, 복잡한 빌드 스크립트 실행 등)에는 Claude가 마크다운 파일(또는 GitHub 이슈)을 체크리스트 및 작업 메모장으로 사용하게 하세요.

예: 많은 린트 이슈를 고칠 때

Claude에게 린트 명령을 실행하고, 모든 오류(파일명, 줄번호 포함)를 마크다운 체크리스트로 기록하게 하세요
각 이슈를 하나씩 해결하고, 확인 후 체크하고 다음으로 넘어가게 하세요

h. Claude에 데이터를 전달하세요

Claude에 데이터를 제공하는 방법은 여러 가지가 있습니다:

프롬프트에 직접 복사/붙여넣기(가장 일반적)
Claude Code에 파이프 입력(예: ‎⁠cat foo.txt | claude⁠), 로그, CSV, 대용량 데이터에 유용
bash 명령, MCP 도구, 커스텀 슬래시 명령어로 데이터 불러오기
파일 읽기, URL 가져오기 요청(이미지도 가능)

대부분의 세션은 이 방법들을 조합해 사용합니다.

5. 헤드리스 모드로 인프라 자동화

Claude Code는 CI, pre-commit 훅, 빌드 스크립트, 자동화 등 비대화형 환경을 위한 헤드리스 모드를 지원합니다. -p 플래그로 프롬프트를 전달해 헤드리스 모드를 활성화하고, ‎⁠--output-format stream-json⁠으로 스트리밍 JSON 출력을 받을 수 있습니다.

헤드리스 모드는 세션 간에 지속되지 않으니, 매번 직접 실행해야 합니다.

a. 이슈 분류 자동화

헤드리스 모드는 GitHub 이벤트(예: 새 이슈 생성) 트리거 자동화에 활용할 수 있습니다. 예를 들어, 공개 Claude Code 저장소는 새 이슈가 들어올 때 Claude로 자동 분류 및 라벨링합니다.

b. 린터로 Claude 사용

Claude Code는 기존 린트 도구가 감지하지 못하는 오타, 오래된 주석, 오해를 부를 함수/변수명 등 주관적 코드 리뷰도 제공합니다.

6. 멀티-Claude 워크플로우로 레벨업

단독 사용을 넘어, 여러 Claude 인스턴스를 병렬로 실행하면 더욱 강력한 활용이 가능합니다:

a. 한 Claude가 코드를 작성하고, 다른 Claude가 검증

한 Claude가 코드를 작성하고, 다른 Claude가 리뷰/테스트하는 방식입니다. 여러 엔지니어가 협업하는 것과 비슷하게, 별도의 컨텍스트가 도움이 될 때가 많습니다:

Claude로 코드 작성 2./clear 실행 또는 다른 터미널에서 두 번째 Claude 실행
두 번째 Claude로 첫 Claude의 작업 리뷰
세 번째 Claude(또는 ‎⁠/clear⁠ 반복)로 코드와 리뷰 피드백을 읽고, 피드백 반영해 코드 수정

테스트도 마찬가지로, 한 Claude가 테스트를 작성하고, 다른 Claude가 테스트를 통과하는 코드를 작성하게 할 수 있습니다. 각 Claude에 별도의 작업 메모장을 주고, 서로 어떤 파일을 읽고 쓸지 명확히 지시하면 인스턴스 간 협업도 가능합니다.

이렇게 분리하면 한 Claude가 모든 작업을 처리할 때보다 더 좋은 결과를 얻을 수 있습니다.

b. 저장소를 여러 번 체크아웃

Claude가 각 단계를 완료할 때까지 기다리지 않고, 많은 Anthropic 엔지니어들은 다음과 같이 작업합니다:

서로 다른 폴더에 3~4개 git 체크아웃 생성
각 폴더를 별도 터미널 탭에서 열기
각 폴더에서 Claude를 다른 작업으로 실행
진행 상황을 확인하며 권한 요청을 승인/거부

c. git worktree 사용

여러 독립 작업에 적합하며, 여러 체크아웃보다 가볍습니다. git worktree로 하나의 저장소에서 여러 브랜치를 별도 디렉토리에 체크아웃할 수 있습니다. 각 worktree는 독립된 작업 디렉토리를 가지며, git 히스토리와 reflog는 공유합니다.

예: 인증 시스템 리팩터링은 한 Claude, 데이터 시각화 컴포넌트는 다른 Claude가 담당하게 할 수 있습니다. 작업이 겹치지 않으므로 각 Claude가 충돌 없이 빠르게 작업할 수 있습니다.

worktree 생성: ‎⁠git worktree add ../project-feature-a feature-a⁠
각 worktree에서 Claude 실행: ‎⁠cd ../project-feature-a && claude⁠
필요시 추가 worktree 생성(1~2 반복)

팁:

일관된 네이밍 사용
worktree별로 터미널 탭 유지
Mac의 iTerm2 사용 시 Claude가 주목 필요할 때 알림 설정 • IDE 창도 분리 • 작업 종료 후 정리: ‎⁠git worktree remove ../project-feature-a⁠

d. 커스텀 하네스와 함께 헤드리스 모드 사용

‎⁠claude -p⁠(헤드리스 모드)로 Claude Code를 대규모 워크플로우에 프로그래밍적으로 통합할 수 있습니다.

Fan-out: 대규모 마이그레이션/분석(예: 수백 개 로그 감정 분석, 수천 개 CSV 분석 등)

Claude로 작업 목록 생성 스크립트 작성(예: 2,000개 파일을 프레임워크 A→B로 마이그레이션)
각 작업마다 Claude를 프로그래밍적으로 호출(‎⁠claude -p “foo.py를 React에서 Vue로 마이그레이션. 완료 시 OK, 실패 시 FAIL 반환.” `--allowedTools Edit Bash(git commit:*)⁠)
여러 번 실행하며 프롬프트를 다듬어 원하는 결과 얻기

파이프라인: 기존 데이터/처리 파이프라인에 Claude 통합

‎⁠claude -p “<프롬프트>” --json | your_command⁠로 다음 단계에 결과 전달
JSON 출력(선택)은 자동 처리에 유용

이 두 가지 사용 사례 모두에서, Claude를 호출할 때 디버깅을 위해 --verbose 플래그를 사용하는 것이 도움이 될 수 있습니다. 프로덕션 환경에서는 더 깔끔한 출력을 위해 verbose 모드를 끄는 것을 일반적으로 권장합니다.