클로드 코드 공식 문서 팁 정리

비대화형으로 프롬프트 하나 실행 후 출력하는 방법

• claude -p "query"
• CI/CD 파이프라인이나 스크립트에서 활용하기 좋음

Skill vs Subagent

Claude Code 모범 사례

• Claude에게 작업을 검증할 방법을 제공해라.

• Plan Mode 적극적으로 사용하기
• 프롬프트에 구체적인 context 제공하기

• 풍부한 콘텐츠 제공하기
  • @로 파일 참조
  • 이미지를 직접 붙여넣기
  • 문서 및 API 참조에 URL 제공
  • 데이터 파이프
• Claude Code에 gh, aws, gcloud, sentry-cli와 같은 CLI 도구를 사용하여 외부 서비스와 상호 작용하도록 하세요.
• claude mcp add를 실행하여 Notion, Figma 또는 데이터베이스와 같은 외부 도구를 연결하세요.
• 예외 없이 매번 발생해야 하는 작업에 hooks를 사용하세요.
• .claude/skills/에 SKILL.md 파일을 생성하여 Claude에 프로젝트, 팀 또는 도메인에 특정한 도메인 지식을 제공하세요.
• /plugin을 실행하여 마켓플레이스를 탐색하세요. Plugins는 구성 없이 skills, tools, integrations를 추가합니다.
• 선임 엔지니어에게 물어볼 질문을 Claude에게 하세요.
• 더 큰 기능의 경우 Claude가 먼저 당신을 인터뷰하도록 하세요. 최소한의 프롬프트로 시작하고 Claude에게 AskUserQuestion 도구를 사용하여 당신을 인터뷰하도록 요청하세요.

[간단한 설명]을 빌드하고 싶습니다. AskUserQuestion 도구를 사용하여 자세히 인터뷰해 주세요.

기술 구현, UI/UX, 엣지 케이스, 우려 사항, 트레이드오프에 대해 물어보세요. 명백한 질문을 하지 마세요. 고려하지 않았을 수 있는 어려운 부분을 파고드세요.

모든 것을 다룰 때까지 계속 인터뷰한 다음 SPEC.md에 완전한 사양을 작성하세요.

• Claude가 잘못된 방향으로 가는 것을 알아차리면 즉시 수정하세요.
• 관련 없는 작업 간에 /clear를 자주 실행하여 context window를 재설정하세요.
• "use subagents to investigate X"로 연구를 위임하세요. 그들은 별도의 context에서 탐색하여 주 대화를 구현에 깨끗하게 유지합니다.
• Claude가 만드는 모든 작업은 checkpoint를 생성합니다. 이전 checkpoint로 대화, 코드 또는 둘 다를 복원할 수 있습니다.
• claude --continue를 실행하여 중단한 곳에서 계속하거나 --resume을 사용하여 최근 세션에서 선택하세요.
• 개발 속도를 높이고, 격리된 실험을 실행하거나, 복잡한 워크플로우를 시작하기 위해 여러 Claude 세션을 병렬로 실행하세요.
• 각각에 대해 claude -p를 호출하는 루프를 통해 작업을 반복하세요. 배치 작업을 위해 --allowedTools를 사용하여 권한을 범위 지정하세요.
  • 예시

for file in $(cat files.txt); do
  claude -p "$file을 React에서 Vue로 마이그레이션하세요. OK 또는 FAIL을 반환하세요." \
    --allowedTools "Edit,Bash(git commit *)"
done

에이전트 팀

2.1.62 버전 기준 아직 실험적 기능이며 기본적으로 비활성화 되어있음. CLAUDE_CODE_EXPERIMENT_AGENT_TEAMS 환경변수를 1로 설정하여 활성화할 수 있음

• 여러 Claude Code 에이전트가 함께 작동하도록 조율하며, 공유 작업, 에이 전트 간 메시징, 중앙 집주식 관리를 지원한다.
• 한 세션이 팀 리더 역할을 하여 작업을 조율하고, 작업을 할당하며, 결과를 종합한다.
• vs subagents
  • 
• 에이전트 팀 시작 방법 2가지
  • 팀 요청: 병렬 작업의 이점이 있는 작업을 제공하고 명시적으로 에이전트 팀을 요청한다. Claude는 지시에 따라 팀을 만든다.
  • Claude가 팀 제안: Claude가 작업이 병렬 작업의 이점이 있다고 판단하면, 팀 생성을 제안할 수 있다.
• 아키텍처 구성요소
  • 팀 리더: 팀을 만들고, 팀원들을 생성하며, 작업을 조율하는 메인 Claude Code 세션
  • 팀원들: 할당된 작업에서 각각 작동하는 별도의 Claude Code 인스턴스
  • 작업 목록: 팀원들이 요청하고 완료하는 공유 작업의 항목 목록
  • 메읿박스: 에이전트 간 통신을 위한 메시징 시스템
• 사용 사례 예시
  • 병렬 코드 리뷰
    • 단일 코드 리뷰는 한 가지 유형의 문제에 집중하는 경향이 있다. 검토 기준을 독립적인 도메인으로 분할하면 보안, 성능, 테스트 커버리지가 모두 동시에 철저히 검토된다.
    • 
  • 경쟁하는 가설로 조사하기
    • 근본 원인이 불명확할 때, 단일 에이전트는 그럴듯한 설명 하나를 찾고 멈추는 경향이 있다. 적대적으로 동작하는 팀원을 하나 만들어 이를 방지한다.
    • 

플러그인

• 플러그인을 사용하면 프로젝트와 팀 전체에서 공유할 수 있는 사용자 정의 기능으로 Claude Code를 확안할 수 잇다.
• 플러그인은 skills, agents, hooks mcp 등을 포함할 수 있다.