초급
일상에서 활용하는 50가지 Claude Code 팁과 모범 사례
일상에서 활용하는 50가지 Claude Code 팁과 모범 사례
Claude Code를 충분히 사용해 보셨고, 이제 더 효과적으로 활용할 방법을 찾고 계신가요? Anthropic 공식 문서, Boris Cherny(Claude Code 제작자), 커뮤니티 경험, 그리고 제 1년간의 일일 사용 경험을 바탕으로 50가지 Claude Code 모범 사례와 팁을 정리했습니다. 초보자부터 숙련자까지 모두에게 도움이 될 것입니다.
1. cc 별칭 설정하기#
Claude Code 세션을 시작할 때마다 사용하는 방법입니다.
~/.zshrc(또는 ~/.bashrc)에 다음을 추가하세요:alias cc='claude --dangerously-skip-permissions'source ~/.zshrc를 실행하여 적용합니다. 이제 claude 대신 cc를 입력하면 모든 권한 프롬프트를 건너뜁니다. 플래그 이름이 의도적으로 무섭게 지어졌습니다. Claude Code가 코드베이스에 무엇을 할 수 있는지 완전히 이해한 후에만 사용하세요. 이 내용과 더 많은 별칭은 Claude Code 사용자 정의에서 다루었습니다.2. ! 접두사로 bash 명령어 인라인 실행하기#
!git status 또는 !npm test를 입력하면 명령어가 즉시 실행됩니다. 명령어와 그 출력이 컨텍스트에 포함되어 Claude가 결과를 확인하고 조치를 취할 수 있습니다. Claude에게 명령어를 실행하도록 요청하는 것보다 훨씬 빠릅니다.3. Esc 키로 Claude 중단, Esc+Esc로 되돌리기#
Esc 키는 컨텍스트를 잃지 않고 Claude의 작업을 중단합니다. 즉시 방향을 전환할 수 있습니다.
Esc+Esc(또는
/rewind)는 Claude가 생성한 모든 체크포인트의 스크롤 가능한 메뉴를 엽니다. 코드, 대화, 또는 둘 다를 복원할 수 있습니다. "실행 취소"도 작동합니다. 네 가지 복원 옵션: 코드와 대화, 대화만, 코드만, 또는 체크포인트 이후 요약.이를 통해 40%만 확신하는 접근 방식도 시도해 볼 수 있습니다. 성공하면 좋고, 실패하면 되돌리면 됩니다. 피해는 전혀 없습니다. 한 가지 주의사항: 체크포인트는 파일 편집만 추적합니다. bash 명령어(마이그레이션, 데이터베이스 작업)의 변경 사항은 캡처되지 않습니다.
중단한 지점에서 계속하려면
claude --continue로 가장 최근 대화를 재개하고, claude --resume으로 세션 선택기를 엽니다.4. Claude가 스스로 작업을 확인할 방법 제공하기#
Claude가 스스로 실수를 잡을 수 있도록 피드백 루프를 제공하세요. 프롬프트에 테스트 명령어, 린터 검사 또는 예상 출력을 포함하세요.
인증 미들웨어를 세션 토큰 대신 JWT를 사용하도록 리팩터링하세요.
변경 후 기존 테스트 스위트를 실행하세요.
완료하기 전에 모든 실패를 수정하세요.Claude는 테스트를 실행하고, 실패를 확인하며, 사용자가 개입하지 않고 수정합니다. Boris Cherny는 이 방법만으로 품질이 2-3배 향상된다고 말합니다. UI 변경의 경우 Playwright MCP 서버를 설정하여 Claude가 브라우저를 열고, 페이지와 상호 작용하며, UI가 예상대로 작동하는지 확인하도록 하세요. 이 피드백 루프는 단위 테스트가 놓치는 문제를 잡아냅니다.
5. 언어에 맞는 코드 인텔리전스 플러그인 설치하기#
LSP 플러그인은 파일 편집 후 자동 진단을 제공합니다. 타입 오류, 사용되지 않는 import, 누락된 반환 타입 등을 Claude가 사용자가 인지하기 전에 확인하고 수정합니다. 설치할 수 있는 가장 영향력 있는 플러그인입니다.
원하는 플러그인을 선택하고 설치 명령어를 실행하세요:
/plugin install typescript-lsp@claude-plugins-official
/plugin install pyright-lsp@claude-plugins-official
/plugin install rust-analyzer-lsp@claude-plugins-official
/plugin install gopls-lsp@claude-plugins-officialC#, Java, Kotlin, Swift, PHP, Lua, C/C++용 플러그인도 사용 가능합니다.
/plugin을 실행하고 Discover 탭으로 이동하여 전체 목록을 확인하세요. 시스템에 해당 언어 서버 바이너리가 설치되어 있어야 합니다(플러그인이 누락 시 알려줍니다).6. gh CLI 사용 및 Claude에게 모든 CLI 도구 가르치기#
gh CLI는 별도의 MCP 서버 없이 PR, 이슈, 댓글을 처리합니다. CLI 도구는 MCP 서버보다 컨텍스트 효율성이 높습니다. 도구 스키마를 컨텍스트 창에 로드하지 않기 때문입니다.
jq, curl 및 기타 표준 CLI 도구에도 동일하게 적용됩니다.Claude가 아직 모르는 도구의 경우: "'sentry-cli --help'를 사용하여 학습한 다음, 이를 사용하여 프로덕션에서 가장 최근 오류를 찾으세요." Claude는 도움말 출력을 읽고, 구문을 파악하며, 명령어를 실행합니다. 내부 전용 CLI도 작동합니다.
7. 복잡한 추론에는 "ultrathink" 사용하기#
이 키워드는 노력을 높게 설정하고 Opus 4.6에서 적응형 추론을 트리거합니다. Claude는 문제에 따라 동적으로 사고를 할당합니다. 아키텍처 결정, 까다로운 디버깅, 다단계 추론 또는 Claude가 행동하기 전에 생각하도록 하려는 모든 작업에 사용하세요.
/effort로 노력을 영구적으로 설정할 수도 있습니다. 덜 복잡한 작업의 경우 낮은 노력 수준으로 속도와 비용을 절약하세요. 문제에 맞게 노력을 조정하세요. 변수 이름 변경에 사고 토큰을 낭비할 필요가 없습니다.8. 온디맨드 지식을 위한 스킬 활용하기#
스킬은 Claude의 지식을 온디맨드로 확장하는 마크다운 파일입니다. 모든 세션에서 로드되는
CLAUDE.md와 달리, 스킬은 현재 작업과 관련된 경우에만 로드됩니다. 이렇게 하면 컨텍스트를 가볍게 유지할 수 있습니다..claude/skills/에 스킬을 생성하거나 사전 구축된 스킬을 번들로 제공하는 플러그인을 설치하세요(/plugin을 실행하여 사용 가능한 항목 확인). Claude가 항상 필요하지는 않지만 가끔 필요한 특수 도메인 지식(API 규칙, 배포 절차, 코딩 패턴)에 스킬을 사용하세요.9. 휴대폰에서 Claude Code 제어하기#
claude remote-control을 실행하여 세션을 시작한 다음, claude.ai/code 또는 iOS/Android용 Claude 앱에서 연결하세요. 세션은 로컬 머신에서 실행됩니다. 휴대폰이나 브라우저는 단순히 창 역할을 합니다. 어디서든 메시지를 보내고, 도구 호출을 승인하며, 진행 상황을 모니터링할 수 있습니다.팁 #1의
cc 별칭을 사용하는 경우 Claude는 이미 전체 권한을 가지고 있으므로 각 작업에 대한 승인이 필요하지 않습니다. 이렇게 하면 원격 제어가 더욱 원활해집니다. 작업을 시작하고, 자리에서 떠나고, Claude가 완료하거나 예상치 못한 상황에 직면했을 때만 휴대폰으로 확인하세요.10. 컨텍스트 창을 100만 토큰으로 확장하기#
Sonnet 4.6과 Opus 4.6 모두 100만 토큰 컨텍스트 창을 지원합니다. Max, Team 및 Enterprise 요금제에서 Opus는 자동으로 100만 컨텍스트로 업그레이드됩니다. 세션 중에
/model opus[1m] 또는 /model sonnet[1m]으로 모델을 전환할 수도 있습니다.더 큰 컨텍스트 크기에서 품질이 걱정된다면 50만에서 시작하여 점진적으로 늘리세요. 컨텍스트가 클수록 압축이 시작되기 전에 더 많은 여유가 생기지만, 응답 품질은 작업에 따라 달라질 수 있습니다.
CLAUDE_CODE_AUTO_COMPACT_WINDOW를 사용하여 압축 트리거 시점을 제어하고, CLAUDE_AUTOCOMPACT_PCT_OVERRIDE로 백분율 임계값을 설정하세요. 워크플로에 맞는 최적 지점을 찾으세요.11. 접근 방식이 확실하지 않을 때는 Plan Mode 사용하기#
Plan Mode는 다중 파일 변경, 익숙하지 않은 코드, 아키텍처 결정에 사용하세요. 오버헤드가 있을 수 있지만(몇 분 정도 소요), Claude가 20분 동안 완전히 잘못된 문제를 자신 있게 해결하는 것을 방지합니다.
범위가 명확한 작은 작업은 건너뛰세요. diff를 한 문장으로 설명할 수 있다면 바로 수행하세요. Shift+Tab을 눌러 Normal, Auto-Accept, Plan 권한 모드 간에 전환하여 대화를 떠나지 않고 Plan Mode로 전환할 수 있습니다.
12. 관련 없는 작업 사이에는 /clear를 실행하세요#
명확한 프롬프트로 깨끗한 세션을 시작하는 것이 지저분한 3시간 세션보다 훨씬 낫습니다. 다른 작업을 해야 한다면? 먼저 /clear를 실행하세요.
진행 상황을 버리는 것 같아 아깝게 느껴질 수 있지만, 새로 시작하는 것이 더 나은 결과를 가져옵니다. 세션은 이전 작업의 누적된 컨텍스트가 현재 지시사항을 압도하면서 성능이 저하됩니다. /clear를 실행하고 집중된 시작 프롬프트를 작성하는 데 5초를 투자하면, 30분 동안 점점 효율이 떨어지는 작업을 피할 수 있습니다.
13. Claude에게 버그를 해석하지 말고 원시 데이터를 붙여넣으세요.#
버그를 말로 설명하는 것은 느립니다. Claude가 추측하고, 수정하고, 반복하는 모습을 지켜보게 됩니다.
오류 로그, CI 출력 또는 Slack 스레드를 직접 붙여넣고 "수정해줘"라고 말하세요. Claude는 분산 시스템의 로그를 읽고 문제가 발생한 지점을 추적합니다. 당신의 해석은 Claude가 근본 원인을 정확히 찾아내는 데 필요한 세부 정보를 종종 잃게 만드는 추상화 계층을 추가합니다. Claude에게 원시 데이터를 제공하고 방해하지 마세요.
이 방법은 CI에서도 작동합니다. CI 출력을 붙여넣고 "실패하는 CI 테스트를 수정해줘"라고 말하는 것은 가장 신뢰할 수 있는 패턴 중 하나입니다. PR URL이나 번호를 붙여넣고 Claude에게 실패한 검사를 확인하고 수정하도록 요청할 수도 있습니다. 팁 #6의 gh CLI가 설치되어 있으면 Claude가 나머지를 처리합니다.
터미널에서 직접 출력을 파이프로 전달할 수도 있습니다:
cat error.log | claude "이 오류를 설명하고 수정 방법을 제안해줘"
npm test 2>&1 | claude "실패하는 테스트를 수정해줘"14. 빠른 부수 질문에는 /btw를 사용하세요#
/btw는 대화 기록에 남지 않는 오버레이를 띄워 빠른 질문을 할 수 있게 해줍니다. 현재 세션에 대한 설명을 요청할 때 사용합니다: "왜 이 접근 방식을 선택했나요?" 또는 "다른 옵션과의 트레이드오프는 무엇인가요?" 답변은 닫을 수 있는 오버레이에 표시되고, 메인 컨텍스트는 가볍게 유지되며 Claude는 계속 작업을 수행합니다.
15. 격리된 병렬 브랜치에는 --worktree를 사용하세요#
claude --worktree feature-auth는 새 브랜치로 격리된 작업 복사본을 생성합니다. Claude가 git worktree 설정과 정리를 처리합니다.Claude Code 팀은 이것을 가장 큰 생산성 향상 요소 중 하나라고 부릅니다. 3-5개의 worktree를 생성하고 각각에서 자체 Claude 세션을 병렬로 실행하세요. 저는 보통 2-3개를 실행합니다. 각 worktree는 고유한 세션, 브랜치 및 파일 시스템 상태를 가집니다.
로컬 worktree의 한계는 머신 성능입니다. 여러 개발 서버, 빌드 및 Claude 세션이 CPU를 놓고 경쟁합니다. Builder.io는 각 에이전트를 브라우저 미리보기가 있는 자체 클라우드 컨테이너로 이동시켜, 머신이 두뇌를 사용해야 하는 작업에 자유롭게 남도록 합니다.
16. Ctrl+S로 프롬프트를 임시 저장하세요#
긴 프롬프트를 작성하는 중간에 먼저 빠른 답변이 필요하다는 것을 깨달았습니다. Ctrl+S는 초안을 임시 저장합니다. 빠른 질문을 입력하고 제출하면 임시 저장된 프롬프트가 자동으로 복원됩니다.
17. Ctrl+B로 장기 실행 작업을 백그라운드로 보내세요#
Claude가 긴 bash 명령(테스트 스위트, 빌드, 마이그레이션)을 시작하면 Ctrl+B를 눌러 백그라운드로 보내세요. 프로세스가 실행되는 동안 Claude는 계속 작업하고 계속 대화할 수 있습니다. 프로세스가 완료되면 결과가 나타납니다.
18. 실시간 상태 표시줄을 추가하세요#
상태 표시줄은 Claude의 각 턴 후에 실행되는 셸 스크립트입니다. 터미널 하단에 현재 디렉토리, git 브랜치, 컨텍스트 사용량(창이 얼마나 찼는지에 따라 색상으로 구분)과 같은 실시간 정보를 표시합니다.
가장 빠른 설정 방법은 Claude Code 내에서
/statusline을 사용하는 것입니다. 무엇을 표시할지 묻고 스크립트를 생성해줍니다. 전체 설정 방법은 Claude Code 사용자 정의에서 복사-붙여넣기 스크립트와 함께 다루었습니다.19. 서브에이전트를 사용하여 메인 컨텍스트를 깔끔하게 유지하세요#
"서브에이전트를 사용하여 결제 흐름이 실패한 트랜잭션을 어떻게 처리하는지 파악해줘." 이렇게 하면 자체 컨텍스트 창을 가진 별도의 Claude 인스턴스가 생성됩니다. 모든 파일을 읽고, 코드베이스에 대해 추론하고, 간결한 요약을 보고합니다.
메인 세션은 코드를 작성할 충분한 공간을 확보하여 깔끔하게 유지됩니다. 심층 조사는 코드를 한 줄도 작성하기 전에 컨텍스트 창의 절반을 소비할 수 있습니다. 서브에이전트는 이 비용을 메인 세션 밖으로 유지합니다. 내장된 유형으로는 Explore(Haiku, 빠른 파일 검색)와 Plan(읽기 전용 분석)이 있습니다. 자세한 내용은 서브에이전트 및 에이전트 팀 가이드를 참조하세요.
20. 다중 세션 조정을 위한 에이전트 팀#
실험적이지만 강력합니다. 먼저 설정이나 환경에
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 추가하여 활성화하세요. 그런 다음 Claude에게 팀 생성을 지시하세요: "이 모듈들을 병렬로 리팩토링하기 위해 3명의 팀원으로 구성된 에이전트 팀을 만들어줘." 팀 리더가 각자 고유한 컨텍스트 창과 공유 작업 목록을 가진 팀원들에게 작업을 분배합니다. 팀원들은 조정을 위해 서로 직접 메시지를 주고받을 수 있습니다.팀원 3-5명, 팀원당 작업 5-6개로 시작하세요. 동일한 파일을 수정하는 작업을 할당하지 마세요. 두 팀원이 같은 파일을 편집하면 덮어쓰기가 발생합니다. 병렬 구현을 시도하기 전에 연구 및 검토 작업(PR 리뷰, 버그 조사)부터 시작하세요.
21. 지침으로 압축을 안내하세요#
컨텍스트가 압축될 때(자동으로 또는
/compact를 통해), Claude에게 무엇을 보존할지 알려주세요: /compact focus on the API changes and the list of modified files. 또한 CLAUDE.md에 상시 지침을 추가할 수 있습니다: "압축할 때 수정된 파일의 전체 목록과 현재 테스트 상태를 보존하세요."22. 반복 확인에는 /loop를 사용하세요#
/loop 5m check if the deploy succeeded and report back은 세션이 열려 있는 동안 백그라운드에서 실행되는 반복 프롬프트를 예약합니다. 간격은 선택 사항이며(기본값 10분), s, m, h, d 단위를 지원합니다. 다른 명령을 반복할 수도 있습니다: /loop 20m /review-pr 1234. 작업은 세션 범위로 지정되며 3일 후에 만료되므로 잊혀진 루프가 영원히 실행되지 않습니다. /loop를 배포 모니터링, CI 파이프라인 감시, 또는 다른 작업에 집중하는 동안 외부 서비스를 폴링하는 데 사용하세요.23. 더 풍부한 프롬프트를 위해 음성 받아쓰기를 사용하세요#
/voice를 실행하여 푸시-투-토크를 활성화한 다음, Space를 길게 눌러 받아쓰기를 하세요. 음성이 실시간으로 프롬프트로 변환되며, 같은 메시지에서 음성과 타이핑을 혼합할 수 있습니다. 음성 프롬프트는 타이핑된 프롬프트보다 자연스럽게 더 많은 컨텍스트를 포함합니다. 키 입력을 줄이기 위해 모서리를 자르지 않고 배경을 설명하고, 제약 조건을 언급하며, 원하는 것을 설명하기 때문입니다. Claude.ai 계정이 필요합니다(API 키 아님). 푸시-투-토크 키를 ~/.claude/keybindings.json에서 meta+k와 같은 수정자 조합으로 다시 바인딩하여 홀드 감지 워밍업을 건너뛸 수 있습니다.24. 같은 문제에 대해 2번 수정한 후에는 새로 시작하세요#
당신과 Claude가 수정의 토끼굴로 빠져들고 문제가 여전히 해결되지 않으면, 컨텍스트는 다음 시도에 적극적으로 해가 되는 실패한 접근 방식으로 가득 차 있습니다.
/clear를 실행하고 배운 내용을 통합한 더 나은 시작 프롬프트를 작성하세요. 깨끗한 세션과 더 날카로운 프롬프트는 축적된 막다른 길에 짓눌린 긴 세션보다 거의 항상 더 나은 성능을 보입니다.25. Claude에게 정확히 어떤 파일을 봐야 하는지 알려주세요#
@를 사용하여 파일을 직접 참조하세요: @src/auth/middleware.ts에 세션 처리가 있습니다. @ 접두사는 자동으로 파일 경로로 확인되므로 Claude는 정확히 어디를 봐야 하는지 알 수 있습니다.Claude는 스스로 코드베이스를 grep하고 검색할 수 있지만, 여전히 후보를 좁히고 올바른 파일을 식별해야 합니다. 모든 검색 단계는 토큰과 컨텍스트를 소비합니다. 처음부터 Claude를 올바른 파일로 안내하면 전체 프로세스를 건너뛸 수 있습니다.
26. 모호한 프롬프트로 익숙하지 않은 코드를 탐색하세요#
"이 파일에서 무엇을 개선하시겠습니까?"는 훌륭한 탐색 프롬프트입니다. 모든 프롬프트가 구체적일 필요는 없습니다. 기존 코드에 대한 새로운 시각이 필요할 때, 모호한 질문은 Claude가 당신이 생각지도 못한 질문을 할 수 있는 여지를 제공합니다.
저는 익숙하지 않은 저장소에 온보딩할 때 이 방법을 사용합니다. Claude는 첫 번째 읽기에서 놓칠 수 있는 패턴, 불일치 및 개선 기회를 지적합니다.
27. Ctrl+G로 계획 수정하기#
Claude가 계획을 제시할 때, Ctrl+G를 누르면 텍스트 편집기에서 계획이 열려 직접 수정할 수 있습니다. 제약 조건을 추가하고, 단계를 제거하거나, Claude가 코드 한 줄을 작성하기 전에 접근 방식을 변경할 수 있습니다. 계획이 대체로 맞지만 몇 단계만 수정하고 싶을 때 전체 내용을 다시 설명하지 않아도 되어 유용합니다.
28. /init 실행 후 결과물을 절반으로 줄이기#
CLAUDE.md는 프로젝트 루트에 있는 마크다운 파일로, Claude에게 빌드 명령어, 코딩 표준, 아키텍처 결정, 저장소 규칙 등 지속적인 지침을 제공합니다. Claude는 모든 세션 시작 시 이 파일을 읽습니다. /init 명령어는 프로젝트 구조를 기반으로 시작용 버전을 생성하며, 빌드 명령어, 테스트 스크립트, 디렉토리 구조를 자동으로 파악합니다.출력물은 대체로 비대해지는 경향이 있습니다. 특정 줄이 왜 있는지 설명할 수 없다면 삭제하세요. 불필요한 내용을 제거하고 누락된 부분을 추가하세요. 이러한 파일 구조화에 대한 자세한 내용은 훌륭한 CLAUDE.md 파일 작성 방법을 참조하세요.
29. 모든 CLAUDE.md 줄에 대한 리트머스 테스트#
CLAUDE.md의 모든 줄에 대해 "이 줄이 없으면 Claude가 실수할까?"라고 자문해보세요. Claude가 이미 스스로 올바르게 수행하는 작업에 대한 지침은 잡음일 뿐입니다. 불필요한 모든 줄은 중요한 지침의 효과를 희석시킵니다. 약 150-200개의 지침 예산이 있으며, 이를 초과하면 준수율이 떨어집니다. 시스템 프롬프트가 이미 그중 약 50개를 사용하고 있습니다.30. Claude가 실수하면 "다시는 이런 일이 없도록 CLAUDE.md를 업데이트하세요"라고 말하기#
Claude가 실수하면 "다시는 이런 일이 없도록
CLAUDE.md 파일을 업데이트하세요"라고 말하세요. Claude가 스스로 규칙을 작성합니다. 다음 세션에서는 자동으로 그 규칙을 따릅니다.시간이 지나면서
CLAUDE.md는 실제 실수를 통해 형성되는 살아있는 문서가 됩니다. 무한히 커지는 것을 방지하려면 @imports(팁 #32)를 사용하여 패턴과 수정 사항을 위한 @docs/solutions.md와 같은 별도 파일을 참조하세요. CLAUDE.md는 간결하게 유지되고, Claude는 필요할 때만 세부 정보를 읽습니다.31. 특정 상황에만 적용되는 규칙에는 .claude/rules/ 사용하기#
.claude/rules/ 디렉토리에 마크다운 파일을 배치하여 주제별로 지침을 구성하세요. 기본적으로 모든 규칙 파일은 각 세션 시작 시 로드됩니다. 특정 파일에서 작업할 때만 규칙이 로드되도록 하려면 paths 프론트매터를 추가하세요:---
paths:
- "**/*.ts"
---
# TypeScript 규칙
타입보다 인터페이스를 선호합니다.이렇게 하면 메인
CLAUDE.md를 간결하게 유지할 수 있습니다. TypeScript 규칙은 Claude가 .ts 파일을 읽을 때 로드되고, Go 규칙은 .go 파일을 읽을 때 로드됩니다. Claude는 현재 작업 중인 언어와 관련 없는 규칙을 읽느라 시간을 낭비하지 않습니다.32. @imports를 사용하여 CLAUDE.md 간결하게 유지하기#
@docs/git-instructions.md로 문서를 참조하세요. @README.md, @package.json, 또는 @~/.claude/my-project-instructions.md도 참조할 수 있습니다.Claude는 필요할 때 파일을 읽습니다.
@imports는 "필요하면 추가 컨텍스트가 여기 있습니다"라는 의미로, 매 세션마다 읽는 파일을 비대하게 만들지 않습니다.33. /permissions로 안전한 명령어 허용 목록 설정하기#
npm run lint에 대해 수백 번째 "승인"을 클릭하는 것을 중단하세요. /permissions를 사용하면 신뢰할 수 있는 명령어를 허용 목록에 추가하여 작업 흐름을 유지할 수 있습니다. 목록에 없는 명령어에 대해서는 여전히 프롬프트가 표시됩니다.34. Claude가 자유롭게 작업하도록 /sandbox 사용하기#
/sandbox를 실행하여 OS 수준 격리를 활성화하세요. 쓰기 작업은 프로젝트 디렉토리로 제한되고, 네트워크 요청은 승인한 도메인으로만 제한됩니다. macOS에서는 Seatbelt를, Linux에서는 bubblewrap을 사용하므로 Claude가 생성하는 모든 하위 프로세스에 제한이 적용됩니다. 자동 허용 모드에서는 샌드박스 명령어가 권한 프롬프트 없이 실행되어, 안전장치가 있는 상태에서 거의 완전한 자율성을 제공합니다.감독 없는 작업(야간 마이그레이션, 실험적 리팩토링)의 경우 Docker 컨테이너에서 Claude를 실행하세요. 컨테이너는 완전한 격리, 쉬운 롤백, 그리고 Claude를 몇 시간 동안 실행할 수 있는 확신을 제공합니다.
35. 반복 작업을 위한 맞춤형 하위 에이전트 생성하기#
즉석에서 하위 에이전트를 사용하는 것(팁 #19)과 달리, 맞춤형 하위 에이전트는
.claude/agents/에 저장된 사전 구성된 에이전트입니다. 예를 들어, Opus와 읽기 전용 도구를 사용하는 보안 검토 에이전트, 또는 속도를 위해 Haiku를 사용하는 빠른 검색 에이전트 등이 있습니다./agents를 사용하여 에이전트를 찾아보고 생성하세요. 자체 파일 시스템이 필요한 에이전트의 경우 isolation: worktree를 설정할 수 있습니다.36. 스택에 맞는 올바른 MCP 서버 선택하기#
시작하기 좋은 MCP 서버: 브라우저 테스트 및 UI 검증을 위한 Playwright, 직접 스키마 쿼리를 위한 PostgreSQL/MySQL, 버그 보고서 및 스레드 컨텍스트 읽기를 위한 Slack, 디자인-투-코드 워크플로우를 위한 Figma.
Claude Code는 동적 도구 로딩을 지원하므로, 서버는 Claude가 필요할 때만 정의를 로드합니다. 사용 가능한 전체 목록은 2026년 최고의 MCP 서버 가이드를 참조하세요.
37. 출력 스타일 설정하기#
/config를 실행하고 원하는 스타일을 선택하세요. 내장 옵션은 설명형(상세, 단계별), 간결형(간략, 작업 중심), 기술형(정확, 전문 용어 친화적)입니다.~/.claude/output-styles/에 파일로 맞춤형 출력 스타일을 만들 수도 있습니다.38. 제안에는 CLAUDE.md를, 요구사항에는 훅을 사용하기#
CLAUDE.md는 권고 사항입니다. Claude는 약 80%의 시간 동안 이를 따릅니다. 훅은 결정적이며 100% 적용됩니다. 포맷팅, 린팅, 보안 검사와 같이 예외 없이 항상 발생해야 하는 작업은 훅으로 만드세요. Claude가 고려해야 할 지침이라면 CLAUDE.md로 충분합니다.39. PostToolUse 훅으로 자동 포맷팅하기#
Claude가 파일을 편집할 때마다 포맷터가 자동으로 실행되어야 합니다.
.claude/settings.json에 PostToolUse 훅을 추가하여 Claude가 파일을 편집하거나 작성한 후 Prettier(또는 다른 포맷터)를 실행하세요:{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "npx prettier --write \\"$CLAUDE_FILE_PATH\\" 2>/dev/null || true"
}
]
}
]
}
}|| true는 훅 실패가 Claude를 차단하는 것을 방지합니다. 다른 도구도 연결할 수 있습니다. 두 번째 훅 항목으로 npx eslint --fix를 추가하세요.같은 파일을 편집기로 열어두고 있다면 Claude가 작업하는 동안 저장 시 포맷팅을 끄는 것을 고려하세요. 일부 개발자는 편집기 저장이 프롬프트 캐시를 무효화하여 Claude가 파일을 다시 읽도록 강제할 수 있다고 보고했습니다. 대신 훅이 포맷팅을 처리하도록 하세요.
40. PreToolUse 훅으로 파괴적인 명령어 차단하기#
rm -rf, drop table, truncate 패턴을 Bash에 대한 PreToolUse 훅으로 차단하세요. Claude는 시도조차 하지 않습니다. 훅은 Claude가 도구를 실행하기 전에 실행되므로, 파괴적인 명령어가 피해를 입히기 전에 차단됩니다.{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"type": "command",
"command": "if echo \\"$TOOL_INPUT\\" | grep -qE 'rm -rf|drop table|truncate'; then echo 'BLOCKED: destructive command' >&2; exit 2; fi"
}
]
}
}이것을 프로젝트의
.claude/settings.json에 추가하세요. /hooks로 대화식으로 설정하거나, Claude에게 "rm -rf, drop table, truncate 명령어를 차단하는 PreToolUse 훅을 추가해줘"라고 말하면 됩니다.41. 훅으로 압축 시 중요한 컨텍스트 유지하기#
긴 세션 중 컨텍스트가 압축되면 Claude가 현재 작업 중인 내용을 놓칠 수 있습니다. compact 매처가 있는 Notification 훅은 압축이 발생할 때마다 자동으로 주요 컨텍스트를 다시 주입합니다.
Claude에게 "압축 후 현재 작업, 수정된 파일, 모든 제약 조건을 상기시키는 Notification 훅을 설정해줘"라고 말하세요. Claude가 설정에 훅을 생성합니다. 재주입에 적합한 항목: 현재 작업 설명, 수정한 파일 목록, 하드 제약 조건("마이그레이션 파일 수정 금지").
이 기능은 기능 구현에 깊이 빠져 있어 Claude가 맥락을 놓치는 것을 감당할 수 없는 다중 시간 세션에서 가장 가치가 있습니다.
42. 인증, 결제, 데이터 변경은 항상 수동으로 검토하세요#
Claude는 코드 작성에 능숙하지만, 이러한 결정은 사람의 검토가 필요합니다. 인증 흐름, 결제 로직, 데이터 변경, 위험한 데이터베이스 작업 등은 코드가 아무리 좋아 보여도 반드시 검토하세요. 잘못된 인증 범위, 잘못 구성된 결제 웹훅, 또는 컬럼을 조용히 삭제하는 마이그레이션은 사용자, 비용, 신뢰를 잃게 만들 수 있습니다. 자동화된 테스트만으로는 이러한 모든 문제를 잡아낼 수 없습니다.
43. 현재 작업을 유지하면서 다른 접근 방식을 시도하려면 /branch를 사용하세요#
/branch (또는 /fork)는 현재 지점에서 대화의 복사본을 만듭니다. 위험한 리팩터링을 브랜치에서 시도해보세요. 성공하면 유지하고, 실패하면 원래 대화는 그대로 남습니다. 이는 되감기(#3)와 다른데, 두 경로가 모두 유지되기 때문입니다.
44. 기능 명세를 완전히 작성할 수 없을 때는 Claude가 인터뷰하게 하세요#
구축하려는 것은 알지만, Claude가 잘 구현하는 데 필요한 모든 세부 사항이 부족하다고 느껴질 때가 있습니다. 이럴 때는 Claude가 질문하게 하세요.
[간단한 설명]을 구축하고 싶습니다. AskUserQuestion 도구를 사용하여
자세히 인터뷰해 주세요. 기술적 구현, 엣지 케이스, 우려 사항,
트레이드오프에 대해 질문하세요. 당연한 질문은 하지 마세요.
모든 것을 다룰 때까지 인터뷰를 계속한 후,
완전한 명세를 SPEC.md에 작성하세요.명세가 완료되면, 깨끗한 컨텍스트와 완전한 명세로 새 세션을 시작하여 실행하세요.
45. 한 Claude가 작성하고 다른 Claude가 검토하게 하세요#
첫 번째 Claude가 기능을 구현하고, 두 번째 Claude가 시니어 엔지니어처럼 새로운 컨텍스트에서 검토합니다. 검토자는 구현 과정에서의 편법에 대한 지식이 없으므로 모든 편법에 이의를 제기할 것입니다.
TDD에도 동일한 아이디어를 적용할 수 있습니다. 세션 A가 테스트를 작성하고, 세션 B가 테스트를 통과하는 코드를 작성합니다.
46. PR을 대화형으로 검토하세요#
Claude에게 한 번에 PR 검토를 요청하지 마세요(물론 원한다면 가능합니다). 세션에서 PR을 열고 이에 대해 대화를 나누세요. "이 PR에서 가장 위험한 변경 사항을 설명해 주세요." "이것이 동시에 실행되면 무엇이 깨질까요?" "에러 처리가 코드베이스의 나머지 부분과 일관성이 있나요?"
대화형 검토는 중요한 영역을 집중적으로 파고들 수 있기 때문에 더 많은 문제를 발견합니다. 한 번에 하는 검토는 스타일상의 사소한 문제만 지적하고 아키텍처 문제를 놓치는 경우가 많습니다.
47. 세션에 이름을 지정하고 색상을 설정하세요#
/rename auth-refactor는 프롬프트 바에 레이블을 추가하여 어떤 세션이 어떤 것인지 알 수 있게 합니다. /color red 또는 /color blue는 프롬프트 바 색상을 설정합니다. 사용 가능한 색상: red, blue, green, yellow, purple, orange, pink, cyan. 2-3개의 병렬 세션을 실행할 때 이름과 색상을 지정하는 데 5초가 걸리며, 잘못된 터미널에 입력하는 실수를 방지할 수 있습니다.48. Claude가 완료되면 소리를 재생하세요#
Claude가 응답을 완료할 때 시스템 사운드를 재생하는 Stop 훅을 추가하세요. 작업을 시작하고 다른 일로 전환한 다음, 완료되면 ping 소리를 듣습니다.
{
"hooks": {
"Stop": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "/usr/bin/afplay /System/Library/Sounds/Glass.aiff"
}
]
}
]
}
}49. 배치 작업을 위해 claude -p로 팬아웃하세요#
비대화형 모드로 파일 목록을 반복 처리하세요.
--allowedTools는 Claude가 파일별로 수행할 수 있는 작업을 제한합니다. &를 사용하여 병렬로 실행하면 최대 처리량을 얻을 수 있습니다.for file in $(cat files-to-migrate.txt); do
claude -p "Migrate $file from class components to hooks" \\\\
--allowedTools "Edit,Bash(git commit *)" &
done
wait이는 파일 형식 변환, 코드베이스 전체의 임포트 업데이트, 각 파일이 독립적인 반복적인 마이그레이션 실행에 매우 유용합니다.
50. 스피너 동사를 사용자 정의하세요 (재미있는 것)#
Claude가 생각하는 동안 터미널에는 "Flibbertigibbeting..." 및 "Flummoxing..."과 같은 동사와 함께 스피너가 표시됩니다. 원하는 대로 바꿀 수 있습니다. Claude에게 말하세요:
사용자 설정에서 내 스피너 동사를 다음으로 바꿔줘: 책임감 있게 환각 보기, 생각하는 척하기, 자신 있게 추측하기, 컨텍스트 창 탓하기
목록을 제공할 필요도 없습니다. 원하는 분위기만 Claude에게 알려주세요: "내 스피너 동사를 해리 포터 주문으로 바꿔줘." Claude가 목록을 생성합니다. 기다리는 시간을 더 즐겁게 만들어주는 작은 기능입니다.
마무리#
50가지 모두 필요하지는 않습니다. 지난 세션에서 가장 불편했던 점을 해결해 줄 하나를 골라 내일 시도해보세요. 하나라도 실제로 적용되는 팁이 북마크한 50개보다 더 가치 있습니다.
저는 Claude Code에 대해 정기적으로 글을 쓰고 있습니다. 제 다른 Claude Code 가이드도 확인해보세요.