[확인 필요].0.1 이 가이드를 읽는 법
공식 문서는 기능을 나열합니다. 다음에 배울 것은 주지 않습니다. 원문은 그 문서를 레벨 순으로 다시 깔아 두었습니다. 읽는 순서는 “맨 앞부터”가 아니라 “자기 레벨의 편부터”입니다.
L0부터 L4까지가 본선입니다. L6은 L2 이후 역할이 관리자면 갈라져 나가고, L5는 L3 이후 자동화가 필요할 때 갈라집니다.
확장을 먼저 배우면 기본 동작(읽고 고치고 돌리기)을 방치하게 됩니다. 원문 0.2는 이 순서가 취향이 아니라고 적습니다. 손놀림(L1)과 통제(L2)가 먼저입니다.
라벨 셋 — 공식 · 관행 · 실전
- 공식 — 그 문단 끝에 근거 문서 링크가 있습니다. 링크를 눌러 원문을 바로 확인합니다.
- 관행 — 각주가 있으면 외부 출처로 확인한 것이고, 각주가 없으면 이 가이드가 공식 사실에서 끌어낸 판단입니다. 후자는 따라야 할 사양이 아니라 참고할 기준입니다.
- 실전 — 같은 명령을 다시 돌려 재현할 수 있는 측정입니다.
셋 중 어디에도 넣을 수 없는 문장은 원문이 쓰지 않았습니다. 이 색인도 그렇게 읽습니다.
0.2 역할별 3트랙
| 역할 | 경로 | 원문이 적는 이유 |
|---|---|---|
| 실무자 | L0 → L1 → L2 → L3 | 손놀림이 붙기 전에 확장을 배우면 도구만 쌓입니다 |
| 팀 리드 | 위 경로 + L4 | 하나를 여러 개로 쪼개 돌리는 것이 팀 단위의 레버리지입니다 |
| 조직 관리자 | L0(맛보기) → L2 → L6, 이후 L1 | 관리자가 결정하는 것은 손놀림이 아니라 경계입니다. L0은 건너뛰지 않는 편이 좋습니다 |
L5는 파이프라인이나 코드로 클로드코드를 호출할 때입니다. 관리자 트랙이 실무자와 갈리는 실제 이유는, 가용 기능이 인증 방식과 플랜에 따라 달라진다는 점입니다. 대조표는 원문 부록 C입니다.
클로드코드는 무료 Claude.ai 플랜에 없습니다. 원문 L0.
0.3 5분 자기진단
6문항입니다. 각 문항은 “안다”가 아니라 “해 봤다”를 묻습니다. 솔직하게 세면 5분 안에 끝납니다. 원문: 0.3절.
| # | 질문 | 아니라면 |
|---|---|---|
| 1 | 클로드코드로 파일 하나를 고쳐 커밋까지 끝낸 적이 있습니까 | L0 시작 |
| 2 | 대화가 길어졌을 때 /context로 무엇이 자리를 먹고 있는지 본 적이 있습니까 | L1 일상 운전 |
| 3 | 이 프로젝트에 지침 파일(CLAUDE.md)이 있고, 최근에 거기서 줄을 지운 적이 있습니까 | L2 맥락과 통제 |
| 4 | 승인 프롬프트를 매번 누르는 대신 권한을 규칙으로 적어 둔 것이 있습니까 | L2 맥락과 통제 |
| 5 | 반복해 입력하던 지시 하나를 스킬이나 훅으로 옮긴 적이 있습니까 | L3 확장 |
| 6 | 한 작업을 여러 세션이나 서브에이전트로 쪼개 돌린 적이 있습니까 | L4 오케스트레이션 |
채점
- 1번이 아니오라면 L0부터입니다. 다른 문항은 볼 필요가 없습니다.
- 1번만 예라면 L1입니다. 여기가 가장 흔한 자리입니다.
- 2번까지 예라면 L2입니다.
- 3, 4번 중 하나라도 아니오라면 L3으로 넘어가기 전에 L2를 먼저 봅니다.
- 4번까지 예라면 L3입니다.
- 5번까지 예이고 6번이 아니오라면 L4입니다.
- 전부 예라면 L5나 L6에서 자기에게 필요한 쪽을 고릅니다. 이 경우 부록 A와 부록 F만 훑어도 얻는 것이 있습니다.
기억에 의존하지 말고 파일로 확인합니다. 원문이 주는 확인 명령:
# 3번: 지침 파일이 있는가
ls CLAUDE.md .claude/CLAUDE.md ~/.claude/CLAUDE.md 2>/dev/null
# 4번: 권한 규칙을 적어 뒀는가(빈 결과면 규칙이 없다)
grep -o '"\(allow\|deny\|ask\)"' .claude/settings*.json ~/.claude/settings.json 2>/dev/null
# 5번: 스킬·훅·서브에이전트가 있는가
ls .claude/skills/*/SKILL.md .claude/agents/* 2>/dev/null
# 6번: 워크트리로 병렬 세션을 돌린 적이 있는가
ls .claude/worktrees 2>/dev/null0.4 표면 선택 요약
공식: 클로드코드는 어디서 실행하든 같은 엔진을 씁니다. 표면이 다른 것은 작업 방식에 맞춘 껍데기입니다. 확신이 없으면 CLI로 시작합니다.
| 표면 | 이럴 때 |
|---|---|
| CLI | 터미널 중심 작업, 스크립팅, 원격 서버. 기능이 가장 완전합니다. Agent SDK와 스크립팅은 CLI 전용입니다 |
| 데스크톱 | 변경을 눈으로 검토하고 세션을 여러 개 병렬로 |
| VS Code | 편집기를 떠나지 않고 쓰기 |
| JetBrains | IntelliJ, PyCharm, WebStorm 등 |
| 웹 | 오래 걸리고 손이 덜 가는 작업, 오프라인에도 계속돼야 하는 일 |
| 모바일 | 컴퓨터를 떠나 시작하거나 지켜볼 때 |
Windows CLI 손 경로는 Claude Code CLI 설치하기, 창이 뜨는 앱은 Windows에서 Claude Code 설치하기.
L0–L6 한 줄 — 원문의 그 편으로
각 행의 링크는 원문 해당 부입니다. 완료 기준은 원문 각 편의 “마치면” 문장입니다.
| 레벨 | 한 줄 | 마치면 | 원문 |
|---|---|---|---|
| L0 시작 | 깔고 켜서 첫 한 건을 끝낸다 | 자기 표면에서 세션을 열고 파일 하나를 고쳐 커밋한다 | 1부 |
| L1 운전 | 매일 쓰는 손놀림 | 실무 한 건을 탐색부터 커밋·리뷰까지 혼자 끝낸다 | 2부 |
| L2 통제 | 무엇을 알려주고 무엇을 막을지 | 새 프로젝트의 CLAUDE.md·권한·샌드박스를 30분 안에 세팅한다 | 3부 |
| L3 확장 | 없는 기능을 내가 만든다 | 반복 작업을 스킬로, 검사를 훅으로, 외부 데이터를 MCP로 붙인다 | 4부 |
| L4 병렬 | 하나가 아니라 여러 개를 동시에 | 한 작업을 병렬로 쪼개 돌리고 격리·추적·수렴까지 설계한다 | 5부 |
| L5 자동화 | 사람 없이 돌린다 | 클로드코드를 파이프라인 부품으로 호출하고 SDK로 자기 에이전트를 만든다 | 6부 |
| L6 조직 | 나 한 명이 아니라 팀과 회사 | 조직 표준 설정·계측·컴플라이언스·도입 계획을 문서로 낸다 | 7부 |
부록이 하는 일
원문 부록 A~H는 본선을 대신하지 않습니다. 진단 결과가 L5·L6이거나, 기능이 자기 환경에 없을 때 먼저 엽니다.
- 부록 C — 인증·플랜별 가용성 대조
- 부록 A, F — 전부 예일 때 훑기
전량 목차와 각 장의 완료 체크리스트는 원문 상세 목차에 있습니다.
안 되면 셋
| 증상 | 먼저 볼 것 |
|---|---|
| 없는 기능 | claude --version 후 원문 0.5·부록 C |
| 인증 실패 | ANTHROPIC_API_KEY 또는 claude.ai 로그인. 원문 3.6·3.7 |
| 플랜 없음 | 부록 C 대조. 무료 계정으로는 열리지 않음 |
지금 할 일: 원문 0.3절을 열고 문항 6개를 셉니다. 그 편의 완료 기준만 수행합니다.