화려한 Claude Code 기능은 누구나 기억합니다. 서브에이전트, MCP 서버, 에이전트 팀 같은 것들입니다. 하지만 실제로 시간을 가장 많이 아껴주는 명령은 사람들이 그냥 지나치는 것들입니다. 다만 /btw, /compact, /rewind를 쓰기 전에 먼저 제대로 설치하고 시작 설정을 정리해 두어야 합니다.
시작하기 전에
Claude Code를 사용하려면 유료 Pro, Max, Teams, Enterprise 플랜이나 Console API 키가 필요합니다. 무료 플랜에서는 전혀 사용할 수 없습니다 . OS에 맞게 네이티브로 설치하세요.
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iexHomebrew에는 claude-code(stable)와 claude-code@latest가 있고, WinGet에서는 winget install Anthropic.ClaudeCode를 사용합니다. 하지만 둘 다 자동 업데이트는 되지 않으므로 직접 업그레이드하지 않으면 오래된 빌드에 고정됩니다 .
새 프로젝트에서는 /init을 실행해 실제 빌드 시스템, 테스트, 코드 패턴을 바탕으로 CLAUDE.md를 자동 생성하세요. 안내형 설정을 원한다면 CLAUDE_CODE_NEW_INIT=1을 설정해 대화형 다단계 흐름을 켤 수 있습니다. 이 흐름에서는 skills와 lifecycle hooks도 함께 다룹니다 .
첫날부터 지킬 만한 규칙이 하나 있습니다. CLAUDE.md는 대략 200줄 아래로 유지하세요. Anthropic 문서에서도 이 기준을 넘기면 준수율이 떨어진다고 확인하고 있으며, 모든 줄은 메시지를 보낼 때마다 토큰을 소모합니다 . 길고 포괄적인 것보다 짧고 구체적인 것이 낫습니다.
/btw, /compact, /rewind는 각각 이렇게 다릅니다
이 네 가지 명령은 긴 Claude Code 세션에서 가장 중요한 변수 하나를 좌우합니다. 바로 무엇을 컨텍스트에 남길지입니다. /btw는 기록을 더럽히지 않고 곁가지 질문에 답하고, /compact는 지시문에 맞춰 압축하며, /clear는 작업 사이에서 판을 완전히 비우고, /rewind는 저장소에서 브랜치를 나누듯 대화를 갈라 다시 시작할 수 있게 합니다. 각각은 토큰 수가 늘어나면서 생기는 서로 다른 실패 양상을 겨냥합니다 [1].
| 명령 | 하는 일 | 컨텍스트 영향 |
|---|---|---|
/btw | 짧은 곁가지 질문에 닫을 수 있는 오버레이로 답함 | 기록에 들어가지 않음 — 토큰 증가 없음 |
/compact <focus> | 지시문을 기준으로 기록을 압축함 | 루트 CLAUDE.md + 자동 메모리 유지 |
/clear | 모든 대화 기록을 지움 | 다음 턴에 CLAUDE.md를 다시 읽음 |
/rewind (Esc 두 번) | 저장된 체크포인트를 복원함 | 대화만, 코드만, 또는 둘 다 복원 |
2026년 3월에 도입된 /btw는 대부분이 놓치는 명령입니다. "이 함수는 무엇을 반환해?"라고 물으면 답이 오버레이에 표시되고 대화에는 들어가지 않습니다. 그래서 토큰 수가 그대로 유지됩니다 [1]. 만든 사람인 Boris Cherny도 세션을 가볍게 유지하는 마찰 낮은 방법으로 이 기능을 강조합니다 [3].
/compact Focus on the API changes는 무작정 요약하는 대신 의도를 담아 압축합니다. 루트 CLAUDE.md, 범위가 지정되지 않은 규칙, 자동 메모리, skill 본문당 최대 약 5,000토큰은 압축 후에도 남습니다. 하지만 경로 범위 규칙과 중첩된 CLAUDE.md 파일은 일치하는 파일을 다시 읽은 뒤에야 다시 로드됩니다 [1]. 다음 작업이 관련 없다면 대신 /clear를 사용하세요. Anthropic 문서는 오래된 기록이 현재 작업에 실제로 필요한 파일을 밀어내고, 메시지를 보낼 때마다 토큰 비용을 늘린다고 경고합니다 [1].
/rewind 또는 Esc 두 번 입력은 체크포인트 메뉴를 열어 대화만, 코드만, 또는 둘 다 복원할 수 있게 합니다. 모든 프롬프트는 자동으로 체크포인트를 만들고, 체크포인트는 세션을 넘어 유지됩니다. 다만 Claude가 편집한 내용만 추적하며 git이나 외부 프로세스는 추적하지 않습니다 [1]. Esc를 한 번 누르면 컨텍스트는 유지한 채 Claude의 진행 중 동작을 멈춥니다. 에이전트가 잘못된 방향으로 가는 것이 보이는 순간 바로 누르세요 [1].
Stop 훅으로 섣부른 '완료' 선언을 막는 법
Claude에게 스스로 판단하게 두면, 변경이 끝났다고 생각하는 순간 작업이 완료됐다고 선언합니다. 이는 측정이 아니라 판단입니다. Stop 훅은 그 판단을 통과/실패 신호로 바꿉니다. .claude/settings.json에 훅을 추가하고(기존 훅은 /hooks로 확인), 린터, 테스트 러너, 스크린샷 diff 같은 검사 도구를 가리키게 하면 검사가 통과하기 전에는 턴이 끝날 수 없습니다. 이렇게 하면 검증이 나중에 붙는 확인 절차가 아니라 작업의 기본 루프가 됩니다 .
동작 방식은 결정적입니다. Stop 훅이 종료 코드 2로 끝나면 턴 종료가 차단되고, 종료 코드 1은 차단하지 않는 오류입니다 . 안전 상한으로 Claude는 8회 연속 실패 후 차단을 해제합니다 . 따라서 스크립트는 끝없이 막아서는 문이 아니라 도달 가능한 종료 경로를 갖도록 설계해야 합니다. v2.1.139부터 macOS와 Linux의 명령 훅은 제어 터미널 없이 자체 세션에서 실행되므로, 검사가 하위 프로세스를 띄우는 경우 이 점이 중요합니다 .
Stop 훅은 여러 수명주기 지점 중 하나입니다. PreToolUse 훅은 실행 전에 작동하며 Bash, Edit, Write, Read, Glob, Grep, Agent, WebFetch, MCP 도구와 매칭됩니다. 이 훅은 도구 입력을 허용, 거부, 질문, 지연, 수정할 수 있고 우선순위는 deny > defer > ask > allow입니다. 명령 훅은 stdin으로 JSON을 받고, HTTP 훅은 같은 페이로드를 POST 본문으로 받으므로 중앙화된 인증 검증기를 붙일 때 유용합니다 .
이 강제 장치는 Anthropic이 권장하는 작업 리듬과 함께 쓰는 것이 좋습니다. 낯설거나 여러 파일을 건드리는 작업에서는 Shift+Tab으로 plan mode에 들어가고, 편집을 시작하기 전에 Ctrl+G로 에디터에서 계획을 열며, 검증된 작은 단위마다 커밋합니다 . Anthropic의 모범 사례 가이드가 설명하듯 목표는 Claude가 자기 보고가 아니라 구체적인 결과를 기준으로 반복하도록 "give Claude a way to check its own work"하는 것입니다 .
핵심은 역할 분담입니다. .claude/settings.json의 결정적 스크립트가 강제하고, CLAUDE.md의 문장은 조언합니다. 차단 로직은 콜백에 두고, 스타일 가이드는 지시 파일에 둡니다. 메모리와 지시는 컨텍스트이지 강제 장치가 아닙니다.
조용히 발목 잡는 두 가지 함정
도구가 실제보다 더 많은 일을 해준다고 생각하는 사람들을 조용히 무너뜨리는 기본값이 두 가지 있습니다. auto mode의 안전 상한과 auto memory의 로드 제한입니다. 둘 다 버그가 아니라 문서화된 동작이지만, 둘 다 조용히 실패하기 때문에 문제가 됩니다.
첫째, auto mode는 가드레일이 있는 편의 기능이지 보안 모델이 아닙니다. Anthropic은 별도 분류기와 백그라운드 검사를 실행하지만, 독립적인 2026년 AmPermBench 논문은 의도적으로 모호한 권한 승인 시나리오에서 엔드투엔드 false-negative 비율이 81.0%였다고 보고했습니다. Anthropic이 프로덕션 트래픽 기준으로 제시한 17%와는 차이가 큽니다 . 이 차이는 일부 벤치마크 설계에서 비롯되지만 결론은 같습니다. auto는 위험을 인식하는 편의 기능으로 다루고, bypassPermissions는 격리된 VM이나 컨테이너에서만 사용해야 합니다 .
둘째, auto memory는 MEMORY.md의 처음 200줄 또는 25KB 중 먼저 도달하는 범위만 로드합니다. 그래서 긴 메모리 파일에서는 컷오프 뒤에 적어둔 규칙을 Claude가 전혀 보지 못할 수 있습니다 . 컨텍스트가 들어갔다고 가정하기 전에 /memory를 실행해 실제로 무엇이 로드됐는지 확인하세요.
지시 파일에도 같은 절제가 필요합니다. @path/to/file로 가져오는 import는 최대 네 단계의 재귀 hop까지만 해석됩니다 . 400줄짜리 파일 하나에 몰아넣기보다, 큰 규칙 묶음은 .claude/rules/로 나누고 paths frontmatter glob(예: src/**/*.{ts,tsx})을 붙여서 매칭되는 파일이 범위에 들어올 때만 해당 규칙이 로드되게 하세요.
병렬 브랜치, 예약 실행, Chrome
같은 절제는 바깥으로도 확장됩니다. 과부하된 세션 하나보다 여러 세션을 실행하세요. git worktree를 Claude Code의 데스크톱 다중 세션 보기와 함께 쓰면 각 브랜치는 공유 상태가 없는 독립 세션을 갖습니다. 한 worktree에서 긴 리팩터링이나 리서치를 돌려두고, 다른 worktree에서는 계속 편집할 수 있습니다 . 무인 작업에는 Routines를 사용할 수 있습니다. Anthropic 관리 인프라에서 실행되므로 내 컴퓨터가 꺼져 있어도 예약 자동화가 계속됩니다. 비대화형 모드는 CI와 pre-commit 검사를 구동합니다. claude -p 'prompt' --output-format stream-json는 cat error.log | claude 같은 파이프 입력을 받을 수 있습니다 .
두 가지 이동성 기능이 이 흐름을 마무리합니다. claude --teleport는 웹 또는 iOS 세션을 터미널로 가져오고(claude.ai 구독 필요), /remote-control은 휴대폰이나 브라우저에서 로컬 세션을 조작합니다 . Claude-in-Chrome 확장은 스크린샷 비교가 내장된 유일한 통합입니다. 전후 스크린샷을 캡처해 Claude에 전달하면 시각적 UI diff 검증에 사용할 수 있습니다 . 결론은 이렇습니다. 검증과 병렬성은 같은 규율입니다. 각 작업에 격리된 세션과 구체적인 통과/실패 신호를 부여한 뒤, 예약 실행과 원격 제어로 사용자가 붙어 있지 않아도 계속 굴러가게 하세요.
자주 묻는 질문
/compact는 /clear와 비교해 무엇을 보존하나요?
/compact는 선택적으로 초점 지시를 붙여 대화를 압축합니다. 예를 들어 /compact Focus on the API changes처럼 사용할 수 있으며, 루트 CLAUDE.md, 범위가 지정되지 않은 전역 규칙, 자동 메모리, 그리고 스킬 본문당 대략 최대 5,000토큰은 그대로 유지합니다. 경로 범위 규칙과 중첩된 CLAUDE.md 파일은 다시 일치하는 파일을 읽은 뒤에야 지연 로드됩니다 . 반면 /clear는 모든 대화 기록을 지우지만, Claude는 다음 턴에 CLAUDE.md를 다시 읽고 여전히 파일을 볼 수 있습니다. 두 명령 모두 디스크의 파일을 삭제하지 않습니다.
Claude는 Stop hook 차단을 몇 번 연속으로 존중한 뒤 재정의하나요?
Claude는 Stop hook이 8번 연속 차단하면 이를 재정의합니다 . 이 한도가 있으므로 Stop hook은 도달 가능한 종료 경로가 있는 명확한 통과/실패 결과를 반환하도록 설계해야 합니다. 즉 작업이 올바르게 끝나면 실제로 성공할 수 있는 검사여야 합니다. 절대 통과할 수 없는 게이트는 8회 차단 재정의 예산만 소모한 뒤 결국 턴이 끝나게 하므로, 가드레일의 목적을 잃게 됩니다.
auto mode는 무인 프로덕션 자동화에 안전한가요?
완전히 보안이 확보된 방식이 아니라, 위험을 고려해 다뤄야 합니다. Anthropic의 auto mode는 별도 분류기와 백그라운드 안전 검사를 실행하지만, 독립적인 2026년 AmPermBench 논문은 의도적으로 모호하게 만든 권한 부여 시나리오에서 종단 간 false-negative 비율이 81.0%였다고 보고했습니다. 이는 Anthropic이 인용한 프로덕션 트래픽 기준 17% 수치와 대비됩니다 . bypassPermissions는 격리된 VM이나 컨테이너 안에서만 사용하고, 베어 프로덕션 머신에서는 절대 사용하지 마세요 .
세션에 실제로 로드된 CLAUDE.md 규칙은 어떻게 확인하나요?
/memory를 실행하세요. 로드된 모든 CLAUDE.md, CLAUDE.local.md, 규칙 파일을 나열하고 자동 메모리 폴더를 열어 현재 컨텍스트에 무엇이 들어 있는지 정확히 볼 수 있게 해줍니다 . Claude가 지시를 무시한다고 판단하기 전에 먼저 이것을 확인하세요. 경로 범위 규칙은 일치하는 파일을 아직 읽지 않아 단순히 로드되지 않았을 수 있으며, 메모리와 지시 파일은 컨텍스트일 뿐 강제 장치가 아닙니다. 반드시 강제해야 하는 내용은 hook으로 옮기세요.
/btw는 대화 컨텍스트를 늘리거나 토큰 수에 영향을 주나요?
아니요. 2026년 3월에 도입된 /btw는 닫을 수 있는 오버레이에서 빠른 부가 질문에 답하며, 그 질의응답은 대화 기록에 들어가지 않습니다 . 컨텍스트 창이나 이후 추론에는 아무 영향이 없습니다. 명시적으로 일회성 질의 영역으로 설계되었기 때문에, 작업 중간에 관련 없는 질문을 해도 일반 대화 턴처럼 이후 모든 메시지에서 그 비용을 치르지 않아도 됩니다.
