Claude Code 파워 유저 팁

이 글은 Anthropic의 Claude Code 팀에서 수집한 워크플로우 팁을 모아놓았습니다. 이러한 관행들은 병렬 실행, 계획, 자동화, 검증, 커스터마이징을 다루며, 팀이 매일 코드를 더 빠르게 배포하기 위해 사용하는 패턴들입니다. 모든 사람의 설정이 다르므로 자신에게 맞는 것이 무엇인지 실험해 보세요.

가장 큰 생산성 향상은 3~5개의 Claude 세션을 병렬로 실행하는 것이며, 각각 자신의 git 워크트리에 있습니다. Claude Code는 기본적으로 워크트리 지원이 내장되어 있습니다.

많은 세션에서 방향을 유지하려면 워크트리의 이름을 지정하고, 셸 별칭(za, zb, zc)을 설정하여 그 사이를 이동하고, 터미널 탭을 색상으로 구분하고, 터미널 알림을 활성화하여 Claude가 주의가 필요할 때 알 수 있도록 합니다. 많은 엔지니어들은 로그를 읽고 쿼리를 실행하기 위해 전용 "분석" 워크트리를 유지합니다.

서브에이전트도 격리된 워크트리에서 실행할 수 있으며, 이는 대규모 배치 변경에 특히 강력합니다. 에이전트의 프론트매터에 isolation: worktree를 추가합니다:

그런 다음 자연스럽게 프롬프트합니다: "모든 동기 IO를 비동기로 마이그레이션합니다. 변경 사항을 일괄 처리하고 워크트리 격리를 통해 10개의 병렬 에이전트를 시작합니다. 각 에이전트는 변경 사항을 엔드투엔드로 테스트한 다음 PR을 제출해야 합니다."

/batch 명령은 마이그레이션에 대해 질문한 다음 필요한 만큼 많은 워크트리 에이전트(수십 개, 수백 개 이상)에 작업을 분산합니다. 각 에이전트는 격리된 상태에서 작동하고, 자신의 변경 사항을 테스트하며, 독립적으로 PR을 생성합니다.

Shift+Tab을 눌러 계획 모드로 전환합니다. Claude가 한 번에 구현할 수 있도록 계획에 노력을 집중하세요. 일반적인 흐름은 다음과 같습니다: 계획 모드 진입 → 계획 개선 → 자동 수락 편집으로 전환 → Claude 실행.

팀의 몇 가지 패턴:

Claude Code 팀의 이유: "지금까지 사용한 최고의 코딩 모델이며, Sonnet보다 크고 느리지만, 덜 조종해야 하고 도구 사용이 더 뛰어나기 때문에 결국 더 작은 모델을 사용하는 것보다 거의 항상 더 빠릅니다."

계산: 조종 감소 + 더 나은 도구 사용 = 더 큰 모델에도 불구하고 더 빠른 전체 결과.

/effort를 실행하여 노력 수준을 선택합니다. 네 가지 수준은 낮음(토큰 적음, 빠름), 중간(기본값), 높음(토큰 많음, 더 높은 지능), 최대입니다. Claude Code 팀은 모든 것에 높음을 사용합니다. 어려운 디버깅이나 Claude가 필요한 만큼 추론하기를 원하는 아키텍처 결정을 위해 /effort max로 전환하세요. 최대는 사용량 제한을 더 빠르게 소모하므로 세션별로 활성화하세요.

첫 번째 솔루션을 수락하지 마세요. Claude를 더 잘하도록 밀어붙이세요. 잘 작동하는 몇 가지 프롬프트:

작업을 넘기기 전에 모호함을 줄이기 위해 상세한 사양을 작성하세요. 더 구체적일수록 출력이 더 좋습니다.

Claude가 적극적으로 작업 중일 때 /btw를 사용하여 중단하지 않고 빠른 질문을 합니다. 도구 호출이 없는 단일 턴이지만 대화의 전체 컨텍스트가 있습니다.

Claude Code는 단순히 코드 작성용이 아니라 설명하고 가르치도록 구성할 때 강력한 학습 도구입니다.

저장소 루트에 단일 CLAUDE.md 파일을 공유하고 git에 체크인하며 전체 팀이 기여합니다. 핵심 관행: Claude가 뭔가 잘못하면 CLAUDE.md에 추가하여 실수를 반복하지 않도록 합니다.

모든 수정 후 다음으로 끝내세요: "그 실수를 다시 하지 않도록 CLAUDE.md를 업데이트하세요." Claude는 자신을 위한 규칙을 작성하는 데 매우 능숙합니다.

/install-github-action으로 GitHub Action을 설치한 다음 PR 댓글에서 @claude를 태그하여 검토의 일부로 CLAUDE.md에 학습을 추가합니다:

이것은 "복합 엔지니어링"입니다. 각 수정은 향후 모든 세션을 더 좋게 만듭니다.

/memory를 실행하여 Claude Code의 내장 메모리 시스템을 구성합니다.

명명은 REM 수면이 단기 기억을 장기 저장소로 통합하는 방식에 매핑됩니다.

팀의 한 엔지니어는 모든 작업 및 프로젝트에 대해 메모 디렉토리를 유지하도록 Claude에 지시하고 모든 PR 후에 업데이트한 다음 CLAUDE.md를 가리킵니다.

Claude에게 작업을 검증할 수 있는 방법을 제공하면 최종 결과의 품질이 현저히 향상됩니다. Claude가 자체적으로 피드백 루프를 닫을 수 있다면 출력이 올바를 때까지 반복합니다.

검증은 도메인별로 다르게 보입니다(bash 명령, 테스트 스위트, 시뮬레이터, 브라우저 테스트). 하지만 원칙은 동일합니다. 도메인별 검증에 투자하세요.

프론트엔드 작업의 경우 Claude Code Chrome 확장 프로그램을 설치합니다. 다른 엔지니어처럼 생각하세요. 누군가에게 웹사이트를 구축하도록 요청했지만 브라우저를 사용하지 못하게 한다면 좋아 보일까요? 아마도 아닐 것입니다. 브라우저를 사용하면 좋아 보일 때까지 반복합니다.

팀은 웹 코드에서 작업할 때마다 Chrome 확장 프로그램을 사용합니다. code.claude.com/docs/en/chrome에서 Chrome 또는 Edge용으로 다운로드하세요.

Claude Desktop 앱은 내장 브라우저에서 웹 서버를 자동으로 시작하고 테스트하는 기능을 번들로 제공합니다. CLI 또는 VS Code에서 Chrome 확장 프로그램을 사용하여 유사한 설정을 할 수 있으며, Desktop 앱을 직접 사용할 수도 있습니다.

변경 후 프롬프트에 /simplify를 추가하세요. 변경된 코드를 재사용성, 품질, 효율성 및 CLAUDE.md 준수 여부에 대해 검토하는 병렬 에이전트를 실행합니다—모두 한 번에 처리됩니다.

하루에 한 번 이상 수행하는 작업이 있다면 스킬이나 명령어로 변환하세요. 스킬은 .claude/commands/에 체크인되며 팀과 공유됩니다. 몇 가지 아이디어:

슬래시 명령어는 인라인 Bash를 포함할 수 있어 추가 모델 호출 없이 정보를 미리 계산할 수 있습니다(예: git status).

서브에이전트를 가장 일반적인 PR 워크플로우의 자동화로 생각하세요. .md 파일을 .claude/agents/에 드롭하세요:

각 에이전트는 사용자 정의 이름, 색상, 도구 세트, 허용/비허용 도구, 권한 모드 및 모델을 가질 수 있습니다. settings.json에 "agent"를 추가하거나 claude --agent <name>를 사용하여 주 대화의 기본 에이전트를 설정하세요. /agents를 실행하여 시작하세요.

사용자 정의 에이전트는 종종 간과되는 강력한 기본 요소입니다. .claude/agents에서 새 에이전트를 정의한 후 claude --agent=<name>를 실행하세요. 읽기 전용 에이전트의 예:

PR이 열리면 Claude는 각각 다른 관심사(논리 오류, 보안 문제, 성능 저하)에 초점을 맞춘 에이전트 팀을 파견할 수 있으며, 인라인 댓글을 게시합니다. Anthropic 팀은 먼저 자신들을 위해 이를 구축했습니다. 엔지니어당 코드 출력이 크게 증가했고 검토가 병목이었습니다.

훅을 사용하면 에이전트 생명주기의 특정 지점에서 결정론적으로 로직을 실행할 수 있습니다. Claude에 훅을 추가하도록 요청하여 시작하세요.

자동 포맷팅을 위한 PostToolUse 훅 예제:

/permissions를 실행하여 일반적인 안전 명령어를 사전 허용하고 팀의 .claude/settings.json에 체크인하세요. 이는 권한을 완전히 건너뛰는 것의 권장 대안입니다—프롬프트는 줄어들면서 감사 가능한 허용 목록을 유지합니다. 전체 와일드카드 구문이 지원됩니다—"Bash(bun run *)" 또는 "Edit(/docs/**)"를 시도해보세요.

Claude Code의 권한 시스템은 프롬프트 주입 탐지, 정적 분석, 샌드박싱 및 인간 감시를 계층화합니다. 작은 안전 명령어 세트가 기본으로 사전 승인되며, /permissions를 통해 추가하는 모든 것은 해당 기준선에 추가됩니다.

자동 모드를 사용하면 Claude가 사용자를 대신하여 권한 결정을 내릴 수 있습니다. 분류기는 각 작업이 실행되기 전에 평가합니다—안전한 작업은 자동 승인되고, 위험한 작업은 여전히 플래그됩니다. claude --enable-auto-mode로 활성화하거나, 세션 중에 Shift+Tab으로 순환합니다(계획 모드 → 자동 모드 → 일반 모드).

/sandbox를 실행하여 Claude Code의 오픈소스 샌드박스 런타임을 선택하세요. 머신에서 실행되며 파일 및 네트워크 격리를 모두 지원하여 보안을 개선하면서 권한 프롬프트를 줄입니다. 세 가지 모드를 사용할 수 있습니다:

매우 오래 실행되는 작업의 경우 Claude가 중단 없이 작동할 수 있도록 하세요. 권장 방법:

샌드박스 환경의 경우 --permission-mode=dontAsk 또는 --dangerously-skip-permissions을 사용하여 차단을 피하세요.

/loop는 최대 3일 동안 로컬에서 반복 작업을 예약합니다. Claude Code 팀이 실행하는 몇 가지 예시:

/loop와 달리 예약된 작업은 클라우드에서 실행되므로 노트북을 닫아도 계속 작동합니다.

Claude Code에는 모바일 앱이 있습니다. iOS/Android용 Claude 앱을 다운로드하고 Code 탭을 누르세요. iMessage 플러그인도 사용 가능합니다(/plugin install imessage@claude-plugins-official). 모든 Apple 기기에서 작업을 보낼 수 있습니다.

모바일, 웹, 데스크톱 및 터미널 간에 세션을 앞뒤로 이동하세요:

/config에서 "모든 세션에 대해 원격 제어 활성화"를 활성화할 수도 있습니다.

Dispatch는 Claude Desktop 앱을 위한 안전한 원격 제어입니다. 권한이 있으면 MCP, 브라우저 및 컴퓨터를 사용할 수 있습니다. Slack과 이메일을 따라잡고, 파일을 관리하고, 외출 중일 때 노트북에서 작업을 수행하는 데 유용합니다.

Claude를 기존 도구에 연결하여 Slack을 검색하고, BigQuery를 실행하고, Sentry 로그를 가져올 수 있습니다.

Claude에 bq CLI를 사용하여 메트릭을 즉시 가져오고 분석하도록 요청하세요. 코드베이스에 BigQuery 스킬을 체크인하세요. Claude Code 팀의 의견: "개인적으로 지난 6개월 이상 SQL 한 줄도 작성하지 않았습니다." 이는 CLI, MCP 또는 API가 있는 모든 데이터베이스에서 작동합니다.

Slack MCP를 활성화하고, 버그 스레드를 Claude에 붙여넣고 "수정"이라고 말하세요. 컨텍스트 전환이 없습니다. 또는 "CI 테스트 실패를 수정하러 가"라고 말하세요. 방법을 세세하게 관리할 필요가 없습니다. Claude를 docker logs로 지정하여 분산 시스템을 문제 해결하세요. 이 작업에서 놀랍도록 능숙합니다.

플러그인은 LSP(모든 주요 언어에 사용 가능), MCP, 스킬, 에이전트 및 사용자 정의 훅을 번들로 제공합니다. 공식 Anthropic 플러그인 마켓플레이스에서 설치하거나 조직을 위한 내부 마켓플레이스를 구축하세요. 그런 다음 마켓플레이스 참조를 settings.json에 체크인하여 모든 개발자에게 자동으로 추가되도록 하세요. /plugin을 실행하여 시작하세요.

/config를 실행하여 밝은/어두운 모드를 설정하고 /terminal-setup을 실행하여 IDE 터미널, Apple Terminal, Warp 또는 Alacritty에서 Shift+Enter를 새 줄로 활성화하세요. Vim 모드의 경우 /vim을 실행하세요. 팀은 동기화된 렌더링과 24비트 색상을 위해 Ghostty를 권장합니다.

음성 모드는 Claude Code Desktop 및 Cowork를 포함한 모든 사용자가 사용할 수 있습니다. Claude Code 팀의 대부분의 코딩은 음성으로 수행됩니다. 음성은 입력보다 약 3배 빠르며, 결과적으로 프롬프트가 더 자세해집니다.

터미널 외에도 claude.ai/code에서 추가 세션을 실행하세요. & 명령을 사용하여 세션을 백그라운드로 실행하거나 --teleport 플래그를 사용하여 로컬과 웹 간에 컨텍스트를 전환하세요.

/config를 실행하고 출력 스타일을 설정하세요. 설명은 Claude가 작업할 때 프레임워크와 패턴을 설명합니다(새 코드베이스에 좋음). 학습은 Claude가 변경 사항을 통해 코칭합니다. Claude의 음성을 조정하기 위해 사용자 정의 스타일을 만들 수도 있습니다.

Claude Code를 개인적으로 만드는 것은 작은 것들입니다. Claude에 스피너 동사를 사용자 정의하여 기본 목록에 추가하거나 바꾸도록 요청하세요. settings.json을 소스 제어에 체크인하여 팀과 동사를 공유하세요.

Claude Code는 기본 설정으로 훌륭하게 작동하도록 구축되었지만, 사용자 정의할 때는 settings.json을 git에 체크인하여 팀도 이점을 누릴 수 있도록 하세요. 구성은 코드베이스별, 하위 폴더별, 사용자별 또는 엔터프라이즈 전체 정책을 통해 지원됩니다.

숫자로 보면: 수십 개의 설정 및 환경 변수—설정 참조를 참조하세요. settings.json의 "env" 필드를 사용하여 래퍼 스크립트를 피하세요.

기본적으로 claude -p(및 TypeScript/Python SDK)는 로컬 CLAUDE.md 파일, 설정 및 MCP를 검색합니다. 비대화형 사용의 경우 일반적으로 --system-prompt, --mcp-config, --settings 등을 통해 명시적으로 지정하려고 합니다. 약 10배 더 빠른 시작을 위해 --bare를 추가하세요:

저장소 간에 작업할 때 --add-dir(또는 /add-dir)을 사용하여 Claude에 추가 폴더에 대한 액세스 및 권한을 부여하세요. 또는 팀의 settings.json에 "additionalDirectories"를 추가하여 항상 포함하세요.

기존 세션을 분기하려면 세션 내에서 /branch를 실행하거나 CLI에서 claude --resume <session-id> --fork-session을 실행하세요.

Claude Code 웹 및 데스크톱에서 각 새 클라우드 세션 전에 실행되는 설정 스크립트를 추가하세요—종속성을 설치하고, 설정을 구성하고, 환경 변수를 설정하세요. 스크립트는 재개 시 건너뜁니다.

Claude Code는 자주 업데이트됩니다. 내부적으로 배포하기 전에 code.claude.com/docs에서 버전별 세부 정보를 확인하세요.