초급
몇 달 동안 Claude Code를 잘못 사용했습니다——이 40가지 팁이 제 워크플로를 완전히 바꿨습니다
다른 사람들이 겪은 시행착오를 바탕으로, Claude Code를 효율적으로 사용하는 40가지 팁을 체계적으로 정리했습니다. 설정, 컨텍스트 관리, 자동화, CLAUDE.md 규칙, 멀티 에이전트 동시 작업 등 핵심 시나리오를 다룹니다.
대부분의 사람들은 Claude Code를 자동 완성 도구로만 사용합니다.
상위 1%는 이를 운영체제처럼 사용하여 전체 개발 프로세스를 제어합니다.
"일반 사용자와 고수 사이의 차이는 기술 수준이 아니라 설정에 있습니다. 이 차이는 매주 4~6시간의 가치가 있습니다."
다음은 워크플로를 진정으로 바꾸는 40가지 Claude Code 모범 사례입니다.
1부: 기본 설정#
01 — cc 별칭 설정으로 매번 확인 생략#
~/.zshrc 또는 ~/.bashrc에 다음을 추가하세요:alias cc='claude --dangerously-skip-permissions'그런 다음
source ~/.zshrc를 실행하세요. 이후 cc를 입력하면 매번 권한 확인 프롬프트를 건너뜁니다. 자신이 무엇을 승인하는지 알고 있다는 전제 하에——속도가 빠른 이유는 당신을 신뢰하기 때문입니다.02 — 상태 표시줄 활성화로 실시간 HUD 얻기#
Claude Code에서 다음을 실행하세요:
/statusline그러면 각 AI 응답 후 터미널 하단에 현재 디렉토리, 브랜치 이름, 컨텍스트 사용량을 실시간으로 표시하는 셸 스크립트가 생성됩니다. 세션 수준의 HUD와 같습니다.
03 — 컨텍스트 창을 100만 토큰으로 확장#
Sonnet 4.6과 Opus 4.6은 100만 토큰 컨텍스트를 지원합니다. 세션 중간에 전환하려면:
/model opus[1m]50만부터 시작하여 점차 높여 압축 전 최적의 균형점을 찾는 것이 좋습니다.
04 — 출력 스타일을 한 번에 설정하여 영구 적용#
/config를 실행하여 Explanatory(상세), Concise(간결), Technical(기술적) 중에서 선택하세요.
~/.claude/output-styles/에 완전히 사용자 정의된 스타일 파일을 만들 수도 있습니다. 설정 후에는 매번 AI의 어조를 수동으로 수정할 필요가 없습니다.05 — 휴대폰으로 Claude Code 원격 제어#
claude remote-control그런 다음 claude.ai 또는 모바일 앱에서 연결하세요. PC에서 대규모 리팩토링을 시작하고 휴대폰에서 언제든지 진행 상황을 확인하세요——이 경험은 정말 공상과학 영화 같습니다.
2부: 워크플로 속도 향상 팁#
06 — ! 접두사: bash 출력을 컨텍스트에 직접 전달#
!git status 또는 !npm test를 입력하면 출력이 Claude의 컨텍스트에 직접 들어갑니다. 복사하여 붙여넣을 필요가 없어 디버깅 루프 효율성이 크게 향상됩니다.07 — Esc 일시 중지, Esc+Esc 되돌리기#
Esc: Claude의 현재 작업을 즉시 중단Esc+Esc(또는/rewind): 메뉴를 열어 코드, 대화 또는 둘 다 복원 가능
이것이 당신의 '실행 취소' 버튼입니다. 확신이 40%밖에 없는 아이디어라도 과감히 사용하세요.
08 — Ctrl+S: 현재 초안 임시 저장#
작성 중에 임시로 질문해야 하나요?
Ctrl+S로 초안을 저장하고, 질문이 끝나면 초안이 자동으로 복원됩니다. 복잡한 다단계 작업의 생명선입니다.09 — Ctrl+B: 시간이 오래 걸리는 작업을 백그라운드에서 실행#
Claude가 테스트나 빌드를 실행하는 동안
Ctrl+B를 누르면 백그라운드에서 계속 작업하고, 당신은 다음 단계를 계획하며 대화를 계속할 수 있습니다. 진정한 병렬 생산성입니다.10 — /btw: 사이드 질문으로 주 대화 오염 방지#
/btw는 떠 있는 레이어를 열어 '왜 이 방법을 사용하나요?' 같은 질문을 빠르게 할 수 있게 합니다. 주 대화 기록은 깨끗하게 유지되면서 호기심은 충족됩니다.11 — Ctrl+G: AI가 실행하기 전에 계획 편집#
Claude가 계획을 제시한 후
Ctrl+G를 누르면 편집기에서 계획 내용을 열어 단계를 조정하고 방향을 수정한 다음 실행하도록 할 수 있습니다. 20분 후에 방향이 잘못되었다는 것을 발견하는 것을 방지합니다.12 — 음성 입력이 타이핑보다 더 나은 프롬프트를 제공#
/voice버튼을 누르고 말하는 모드를 활성화합니다. 프롬프트를 말할 때 자연스럽게 더 많은 배경, 제약 조건 및 세부 정보를 추가하게 되어 키보드로 입력한 짧은 명령보다 훨씬 효과적입니다.
3부: 컨텍스트 및 프롬프트 관리#
13 — 다른 작업 사이에 /clear 실행#
깨끗한 세션은 항상 3시간 동안 지저분한 세션보다 낫습니다. 누적된 컨텍스트는 조용히 당신의 지시를 희석시킵니다.
/clear는 하루 종일 출력 품질이 서서히 저하되는 것을 방지하는 핵심입니다.14 — 두 번 수정해도 안 되면? 새 세션 시작#
이미 두 번 수정했는데도 Claude가 여전히 방향을 벗어난다면, 세 번째 수정을 하지 마세요——
/clear 후 프롬프트를 다시 작성하고 방금 배운 교훈을 통합하세요. 손상된 대화를 계속하면 혼란만 가중됩니다.15 — 버그를 설명하지 말고 원시 데이터를 직접 붙여넣기#
버그를 설명하지 말고 오류 로그, CI 출력 또는 Slack 스크린샷을 직접 붙여넣은 다음 '고쳐'라고 말하세요:
cat error.log | claude "이 오류를 설명하고 수정 방법을 알려줘"추상적인 설명은 세부 정보를 잃게 되며, 원시 데이터만이 정확한 결과를 얻을 수 있습니다.
16 — 아키텍처 수준 변경에는 Plan Mode 사용#
Shift+Tab을 눌러 Plan Mode로 전환하세요. 여러 파일 변경이나 구조적 조정 시 필수입니다. 사전 계획에 드는 비용은 Claude가 20분 동안 자신 있게 잘못된 문제를 해결하는 것을 방지합니다.17 — 파일을 직접 지정하여 토큰 절약#
@src/auth/middleware.ts를 사용하여 파일을 직접 참조하면 Claude가 자동으로 구문 분석하여 이미 알고 있는 컨텍스트를 찾기 위해 전체 코드베이스를 검색하는 것을 방지합니다.18 — 모호한 질문으로 낯선 코드 탐색#
'이 파일을 어떻게 개선하겠습니까?'라는 질문은 Claude가 당신이 묻지 않았을 불일치를 발견하게 합니다. 낯선 영역을 조사할 때 모호함은 기능입니다.
19 — 압축 시 유지 지침 제공#
/compact를 사용할 때 Claude에게 무엇을 유지할지 알려주세요: 'API 변경 사항을 중점적으로 유지'. 지침 없이 압축하면 컨텍스트의 주요 흐름을 잃게 됩니다. 지침이 있는 압축은 정확하게 요약합니다.20 — ultrathink로 적응형 추론 잠금 해제#
모든 프롬프트 끝에
ultrathink를 추가하세요(Opus 4.6만 해당):이 결제 모듈을 리팩토링해줘, ultrathinkClaude는 문제의 실제 복잡성에 따라 추론 예산을 동적으로 할당합니다. 진정으로 어려운 문제를 만나면 품질 향상이 눈에 띕니다.
4부: 자동화, 도구 및 MCP#
21 — Claude가 결과를 자체 검증하도록 하기#
프롬프트에 테스트 명령을 포함하세요:
auth 모듈을 리팩토링하고, 테스트 스위트를 실행하고, 실패한 테스트를 수정한 다음 완료했다고 알려줘이 한 가지 지시는 피드백 루프를 형성하여 2~3배의 품질 향상을 가져옵니다.
22 — LSP 플러그인 설치로 진단 정보 자동 획득#
/plugin install typescript-lsp@claude-plugins-officialLSP 플러그인은 Claude가 편집할 때마다 진단 결과를 자동으로 가져와 당신이 발견하기 전에 타입 오류를 수정합니다.
23 — MCP Server보다 CLI 도구 우선 사용#
CLI 도구는 MCP Server보다 컨텍스트를 덜 소비합니다. Claude에게
gh로 PR을 관리하고 sentry-cli --help로 프로덕션 문제를 디버깅하는 방법을 가르치세요. 절약된 컨텍스트는 긴 세션에서 계속 누적됩니다.24 — 이 네 가지 MCP Server를 우선 설치#
신호 대 잡음비가 가장 높은 네 가지:
- Playwright — UI 검증
- PostgreSQL/MySQL — 스키마 쿼리
- Slack — 버그 토론 스레드 직접 읽기
- Figma — 디자인을 코드로 변환
이 네 가지를 먼저 능숙하게 사용한 다음 확장을 고려하세요.
25 — /loop로 정기적인 백그라운드 확인#
/loop 5m check if deploy succeeded백그라운드 루프 확인을 설정하고 세션을 열어 둔 상태에서 계속 작업하면 Claude가 메시지가 있을 때 적극적으로 보고합니다.
26 — /permissions로 화이트리스트를 사용하여 확인 생략#
매번
npm run lint를 수동으로 승인하지 마세요. 신뢰하는 명령을 화이트리스트에 추가하여 빈번한 확인으로 인한 숨겨진 효율성 손실을 제거하세요.5부: CLAUDE.md 및 규칙 시스템 마스터하기#
27 — /init으로 생성한 후 절반을 잘라내기#
/init으로 초기 CLAUDE.md를 생성한 다음, 이유를 설명할 수 없는 내용은 무자비하게 삭제하세요. 불필요한 지시 한 줄 한 줄이 토큰 소비이며, 다른 곳의 주의 품질을 조용히 떨어뜨립니다.28 — CLAUDE.md의 황금 테스트#
각 줄에 대해 스스로에게 물어보세요: '이 줄이 없으면 Claude가 실수할까요?'
대답이 '아니오'이면 삭제하세요.
약 150~200개의 지시 예산이 있으며, 이를 초과하면 준수율이 떨어지기 시작합니다. 이 예산을 잘 사용하세요.
29 — 실수할 때마다 규칙 자동 업데이트#
Claude가 실수하면 다음과 같이 말하세요:
CLAUDE.md를 업데이트하여 이 문제가 다시 발생하지 않도록 해줘그러면 규칙 파일은 각 세션마다 지속적으로 진화하는 살아있는 시스템이 됩니다.
30 — .claude/rules/로 조건부 규칙 구현#
규칙 파일 상단에 경로 선언을 추가하세요:
---
paths:
- "src/api/**"
---TypeScript 규칙은
.ts 파일에만 적용되고, 데이터베이스 규칙은 /db 디렉토리에만 적용됩니다. 컨텍스트가 정확하고 낭비가 없습니다.31 — @imports로 CLAUDE.md를 가볍게 유지#
@docs/git-instructions.md를 참조하여 내용을 직접 붙여넣지 마세요. Claude는 필요할 때 읽고 기본 컨텍스트는 가볍게 유지됩니다.32 — Skills: 필요에 따라 로드되는 확장 지식#
.claude/skills/의 Skill 파일은 호출될 때 로드되고 호출되지 않으면 컨텍스트를 차지하지 않습니다. 라이브러리 파일처럼 이해하세요——사용할 때 마운트되고, 사용하지 않을 때는 보이지 않습니다.33 — CLAUDE.md는 제안, Hooks는 강제 요구 사항#
Claude가 CLAUDE.md를 따를 확률은 약 80%입니다. 형식, 보안, 코드 규칙과 같은 타협할 수 없는 요구 사항에는 Hooks를 사용하세요——매번 예외 없이 실행됩니다.
34 — PostToolUse Hook: 편집 후 자동 서식 지정#
.claude/settings.json에 다음을 추가하세요:"hooks": {
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{
"type": "command",
"command": "npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
}]
}]
}편집할 때마다 Prettier가 자동으로 실행되어 수동 서식 지정이 완전히 사라집니다.
35 — PreToolUse Hook: 위험한 명령 차단#
Bash 도구가 실행되기 전에 가로채서
rm -rf 또는 DROP TABLE과 같은 위험한 작업을 차단합니다. PreToolUse Hook은 Claude에게 더 많은 자율성을 부여할 수 있게 해주는 안전망입니다.6부: 고급: Worktree, Agent 및 격리 실행#
36 — --worktree로 병렬 브랜치 개발 구현#
claude --worktree feature-auth독립적인 작업 복사본을 생성하여 동시에 3개의 세션을 열어 서로 다른 기능을 처리하고 서로 간섭하지 않으며 처리량을 직접 두 배로 늘립니다.
37 — 하위 Agent로 기본 컨텍스트 창 깨끗하게 유지#
하위 Agent를 사용하여 결제 프로세스를 파악해줘그러면 독립적인 인스턴스가 생성되어 관련 파일을 읽고 요약을 반환합니다——기본 컨텍스트는 항상 간결하고 집중된 상태로 유지됩니다.
38 — 자주 사용하는 작업에 대한 사용자 정의 하위 Agent 생성#
/agents.claude/agents/에 미리 구성된 Agent를 저장하세요: Haiku 기반 빠른 검색 Agent, 엄격한 TypeScript 검토 Agent, 문서 작성 Agent. 당신의 AI 전용 팀이随时待命합니다.39 — Agent Teams: 대규모 병렬 작업#
실험적 기능을 활성화하세요:
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude하나의 주도 Agent가 작업을 3~5개의 병렬 하위 Agent에 분배합니다. 대규모 조사 또는 다중 모듈 리팩토링 시, 이것은 또 다른 차원의 속도입니다.
40 — /sandbox: 감독 없는 실험을 위한 안전한 샌드박스#
/sandboxSeatbelt 또는 bubblewrap을 통해 OS 수준 격리를 구현하여 Claude가 실험적인 리팩토링을 자유롭게 실행할 수 있도록 하고 실제 시스템에 대한 위험은 전혀 없습니다. 실행 후 diff를 검토하고 마음에 드는 부분을 병합하세요.
요약#
"대부분의 엔지니어는 코드를 최적화합니다. 가장 빠른 사람들은 AI 워크플로를 최적화합니다. 이것은 완전히 다른 두 가지 복리 이점입니다."
이 40가지 팁에는 새로운 구독이 필요하지 않으며, 10배 엔지니어가 될 필요도 없습니다. 이 모든 것은 이미 사용 중인 도구에 숨겨져 있으며 발견되기를 기다리고 있습니다.
이 목록에서 5가지를 선택하여 이번 주에 구현하세요. 30일 후에 돌아오면, 당신의 워크플로는 근본적으로 변해 있을 것입니다.