Claude Code,
명령어와 구조
4강에서 "당신은 감독"이라고 했죠.
이제 감독할 도구를 제대로 다뤄봅니다.
이건 개발을 배우는 시간이 아닙니다 — 4강에서 익힌
'분해·명시·검수하는 감독'을 실제 도구로 해보는 시간입니다. 오늘은
말 거는 법을 넘어, 핵심 명령어(/init·/model …)와
Claude Code가 어떻게 짜여 있는지까지 한 단계 더 들어갑니다.
Claude Code가 뭔가요?
한 문장으로 — 챗봇이 아니라, 내 컴퓨터에서 실제로 '일하는' AI입니다. 같은 Claude지만 하는 일이 다릅니다.
답을 말해 줍니다
물으면 설명·초안을 돌려줍니다. 실제로 내 파일을 건드리진 않습니다. 3강 대화형
실제로 해냅니다
내 폴더의 파일을 읽고·고치고, 명령을 실행해 결과물을 만듭니다(허가받고). 3강 위임형
그러니 당신이 할 일은 코딩이 아니라 —
시키고, 지켜보고, 검수하는 것입니다.
실행: 터미널에 claude
딱 네 걸음입니다. 설치돼 있다면, 여는 것부터:
- 터미널을 엽니다 — 명령을 입력하는 검은 창(터미널 앱).
- 작업할 폴더에서
claude입력 — 그 프로젝트 폴더 안에서 실행합니다. - 첫 실행이면 브라우저 로그인 — 한 번만 하면 다음부턴 자동입니다.
- 대화창이 열립니다 — 여기가 작업 공간. 이제 말로 시키면 됩니다.
프로젝트 = 폴더. Claude Code는 지금 이 폴더 안만 봅니다.
※ 끝낼 땐 /exit 또는 Esc 두 번 · 하던 걸 이어서 하려면 claude --continue
명령어가 아니라, 말하듯 시킵니다
기본은 자연어입니다. 동료에게 부탁하듯 한국어로 적으면 되고, 슬래시 명령(/…)은 그걸 거드는 도구일 뿐입니다.
@파일이름으로 특정 파일 콕 집기.좋은 지시는 결국 4강의 네 질문 — 입력·완료·절차·암묵지를 채우는 일입니다. 자세할수록 원하는 결과에 가까워집니다. 4강 맡길 단위로 쪼개는 네 질문
허가: 고치기 전에 묻고, 모드로 조절
Claude Code는 실제로 행동하니, 바꾸기 전에 확인합니다. 얼마나 자주 물을지는 Shift+Tab으로 모드를 바꿔 조절합니다:
- 기본 — 읽기는 자유, 고치기·실행은 매번 승인. (처음엔 이걸로)
- 편집 자동승인 — 파일 편집은 알아서, 위험한 건 그래도 물음.
- 계획(plan) — 읽고 계획만 세움, 수정은 안 함. (큰일 전에 훑기)
- 자동 — 대부분 알아서, 위험한 행동은 자동 차단.
승인 전에는 아무것도 바뀌지 않고, 무엇을 하든 Esc로 즉시 멈출 수 있습니다. 사내 보안 환경에선 '기본'으로 시작을 권합니다.
슬래시 명령, 네 갈래로 기억하기
/만 치면 전부 뜹니다. 외우지 말고, 어느 갈래인지만 잡아두세요:
/clear 새 대화 · /compact 요약해 정리 · /resume 이어가기
/model 모델 · /config 설정 · /permissions 허가 규칙 · /status 상태
/init 지침 생성 · /memory 기억 편집 · /agents 도우미 · /mcp 외부 도구
/help 목록 · /cost 사용량 · /doctor 진단
기억할 건 명령 25개가 아니라 —
"이건 어느 갈래?" 네 칸뿐입니다.
가장 자주 쓰는 둘: /init · /model
/init — 프로젝트 첫날 한 번
Claude가 폴더를 훑어 지침 파일(CLAUDE.md) 초안을 자동으로 만들어 줍니다. 여기에 팀 규칙을 몇 줄 얹으면, 매 대화에서 그걸 지킵니다.
/model — 일의 무게에 맞춰
가볍고 빠른 일은 기본 모델, 어렵고 중요한 일은 더 강한 모델(Opus)로 바꿉니다. 사고 강도는 /effort로 더 조절.
둘의 공통점 — 일을 바꾸는 게 아니라, 일하는 '환경'을 맞추는 명령입니다.
/init은 기억할 규칙을, /model은 머리의 힘을 세팅하죠.
※ 대화가 길어져 느려지면 /compact(요약) · 주제가 바뀌면 /clear(새로 시작).
구조 ①: 기억은 CLAUDE.md에
Claude Code는 새 대화마다 기억이 백지에서 시작합니다(2강). 매번 같은 설명을 반복하지 않도록, 지킬 규칙을 적어두는 파일이 CLAUDE.md입니다 — 매 세션 자동으로 읽힙니다.
~/.claude/CLAUDE.md
내 모든 프로젝트에 적용되는 개인 규칙. "답은 한국어로" 같은 것.
./CLAUDE.md
이 폴더에서만 적용되는 팀 공용 규칙. git으로 함께 공유합니다.
담을 것 = 팀 표기·용어·자주 하는 교정. 뺄 것 = 코드 보면 아는 것, 긴 문서.
/init로 초안을 만들고 사람이 다듬습니다. 2강 무엇을 기억하고 무엇을 잊나
구조 ②: 모든 설정은 .claude 폴더에
"이건 어디서 바꾸지?"의 답은 늘 같습니다 — 프로젝트의 .claude 폴더(와 내 홈의 ~/.claude)에 설정·기억·확장이 다 모입니다.
- 지침·기억 —
CLAUDE.md, 자동 메모 (앞 장). - 설정 — 허가 규칙·기본 모드 등(
/config로 관리). - 나만의 명령·도우미 — 반복 작업을 나만의 슬래시 명령이나 서브 에이전트로 저장(
/agents). - 외부 도구 연결(MCP) — 사내 위키·이슈 트래커 같은 외부 도구·데이터를 Claude Code에 연결하는 통로(
/mcp).
구조를 알면 —
"어디서 바꾸지?"의 답이 늘 .claude입니다.
첫날, 이렇게 시작하세요
거창하게 말고 작은 일 하나로 감을 잡는 게 전부입니다:
- 작업할 폴더에서
claude실행하고,/init을 한 번 돌린다. - 작은 일 하나를 말로 시킨다 — "이 파일들 정리해 요약표 만들어줘" 같은.
- 허가 요청을 보며 승인한다. 급하면
Esc로 멈추고 다시 말한다. - 결과를 검수한다 — 맞으면 통과, 틀리면 "여긴 이렇게"라고 고쳐 다시.
완벽한 첫 지시는 없습니다. 4강에서 봤듯 안 적은 빈칸은 AI가 지어냅니다 — 결과를 보고 명시를 더해 다시 시키는 '명시 → 검수 → 반복'이 곧 감독입니다. 4강 왜 내 뜻대로 안 되지 = 명시성
막히면, 그리고 한 문장으로
Claude Code =
당신이 감독하는, 실제로 일하는 도구.
- 말하듯 시키고(명령어 아님) — 슬래시 명령은 거드는 도구.
- 허가·모드로 통제 — 승인 전엔 안 바뀐다,
Esc로 언제든 멈춤. - 구조를 안다 — 기억은
CLAUDE.md, 설정·확장은.claude폴더. - 검수하고 반복 — 틀리면 명시를 더해 다시. 그게 감독이다.
막힐 땐 — 세션 안에서 /help, 공식 문서, 사내 채널에 물어보세요.