
드디어 Claude Code의 실제 사용법이 문서화되었습니다.
요약
Claude Code의 효율적인 활용을 위한 실전 가이드와 베스트 프랙티스를 소개합니다. 계획 모드 활용, Git Worktrees 사용, MCP 연동 등 구체적인 워크플로우와 커뮤니티에서 검증된 다양한 개발 패턴을 다룹니다.
핵심 포인트
- Plan mode와 검증 방법을 사용하여 Claude에게 명확한 지침 제공
- Git Worktrees와 /loop 명령어를 활용한 병렬 및 예약 작업 수행
- 컨텍스트 부패 방지를 위해 세션 길이를 조절하고 /rewind 기능 활용
- MCP를 통해 Chrome 콘솔 로그 등 외부 데이터 접근 권한 부여
- 커뮤니티에서 검증된 다양한 워크플로우(Spec Kit, gstack 등) 적용
드디어 Claude Code를 실제로 사용하는 방법을 문서화한 자료가 나왔습니다.
58K+ stars. claude-code-best-practice.
Boris Cherny와 팀이 직접 전하는 팁:
➡️ 항상 plan mode (계획 모드)를 사용하고, Claude에게 검증할 수 있는 방법을 제공하세요
➡️ AskUserQuestion 도구를 사용하여 Claude가 당신에게 질문(interview)하도록 요청하세요
➡️ 병렬 개발을 위해 Git Worktrees를 사용하세요
➡️ /loop - 최대 7일까지 반복되는 작업을 예약하세요
➡️ Code Review (코드 리뷰) - 새로운 context windows (컨텍스트 창)는 기존 에이전트가 놓친 버그를 잡아냅니다
➡️ 각 단계별로 테스트를 포함한 단계별 gated plans (게이트형 계획)를 만드세요
→ 계획을 검토할 때 cross-model (교차 모델, Claude Code + Codex)을 사용하세요
➡️ CLAUDE[.]md 파일은 파일당 200줄 미만을 목표로 해야 합니다
➡️ 서브 에이전트 대신 워크플로우를 위한 명령어를 사용하세요
➡️ 일반적인 QA나 백엔드 엔지니어 대신, 특정 기술을 가진 기능별 sub-agents (서브 에이전트)를 활용하세요
➡️ 작은 작업에는 복잡한 워크플로우보다 순수(Vanilla) Claude Code가 더 낫습니다
→ 막혔을 때는 스크린샷을 찍어 Claude와 공유하세요
➡️ MCP를 사용하여 Claude가 Chrome 콘솔 로그를 볼 수 있게 하세요
➡️ 더 나은 디버깅을 위해 Claude에게 터미널을 백그라운드 작업으로 실행하도록 요청하세요
➡️ QA를 위해 cross-model (교차 모델)을 사용하세요 - 예: 계획 및 구현 검토를 위해 Codex 사용
➡️ 컨텍스트 부패(Context rot)는 약 300-400k 토큰 부근에서 발생하므로, 세션이 그 이상 길어지지 않게 하세요
➡️ Rewind(되감기) > 수정: 컨텍스트를 오염시키는 대신 /rewind를 사용하여 실패한 시도 이전으로 되돌리세요
➡️ /schedule - 컴퓨터가 꺼져 있어도 실행되는 클라우드 기반의 반복 작업
➡️ dangerously-skip-permissions 대신 Auto mode를 사용하세요. 모델 기반 분류기가 각 명령어가 안전한지 결정합니다
➡️ 모든 기술(skill)에 Gotchas (주의 사항) 섹션을 구축하고, 시간이 지남에 따라 Claude의 실패 지점들을 추가하세요
커뮤니티 워크플로우(workflows)에는 다음이 포함되었습니다:
➡️ Superpowers (234K stars), 브레인스토밍 (brainstorming) → git worktrees → 서브에이전트 주도 개발 (subagent-driven development) → TDD
➡️ Everything Claude Code (219K stars), /ecc:plan → /tdd → /code-review → /security-scan → merge
➡️ Matt Pocock Skills (138K stars), /grill-with-docs → /to-prd → /triage → /tdd → /handoff
➡️ Spec Kit (114K stars), 명시 (specify) → 명확화 (clarify) → 계획 (plan) → 작업 (tasks) → 구현 (implement) → 분석 (analyze)
➡️ gstack (112K stars), office-hours → CEO/eng/design reviews → spec → qa → ship → canary
➡️ 교차 모델 (Cross-Model) (Claude Code + Codex) 워크플로우
➡️ RPI (Research Plan Implement)
➡️ 자율 작업을 위한 Ralph Wiggum Loop
이것이 해결하는 수십억 달러 가치의 질문들:
➡️ CLAUDE[.]md 안에 정확히 무엇을 넣어야 하며, 무엇을 제외해야 하는가?
➡️ 언제 커맨드 (command)를 사용하고, 언제 에이전트 (agent)를 사용하며, 언제 스킬 (skill)을 사용해야 하는가?
➡️ 왜 Claude는 CLAUDE[.]md 지침에 대문자로 MUST라고 명시되어 있음에도 불구하고 여전히 이를 무시하는가?
➡️ 코드베이스를 스펙 (specs)으로 변환하고, AI가 해당 스펙만으로 정확히 동일한 코드를 다시 생성하게 할 수 있는가?
➡️ Claude Code의 내장된 계획 모드 (plan mode)에 의존해야 하는가, 아니면 자신만의 계획 커맨드 (planning command)를 구축해야 하는가?
데일리 습관:
➡️ Claude Code를 매일 업데이트하세요
➡️ 변경 로그 (changelog)를 읽으며 하루를 시작하세요
➡️ Reddit의 r/ClaudeAI, r/ClaudeCode를 팔로우하세요
재게시(Repost)하세요. 북마크하세요. 👇
GitHub 리포지토리(Repo) 주소: https://t.co/3yAfJnFchp
[IMG:1]
AI 자동 생성 콘텐츠
본 콘텐츠는 X AI 사용법/팁의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기