Claude Code 실전 활용

설치와 기본 명령어를 넘어, 실제로 어떻게 쓰는가

Part 7에서 Claude Code의 개념·설치·기본 명령어를 다뤘다. 이 장은 매일 쓰는 실전 워크플로우에 집중한다. 명령어를 손에 익히고, 안전하게 권한을 다루고, 길을 잃었을 때 되돌리고, 반복 작업을 자동화하는 방법을 익힌다.

#1. 명령어 한눈에 보기

Claude Code의 명령은 크게 슬래시 명령어(/), 입력 단축 기호(@ # !), 키보드 단축키로 나뉜다.

#기본 명령어 — 가장 많이 쓰는 것들

#알아두면 편리한 명령어

#입력 단축 기호 & 키보드 단축키

#2. 6가지 권한 모드 (Permission Modes)

Claude Code는 파일을 고치거나 명령을 실행하기 전에 사용자에게 허락을 묻는다. 이 "묻는 정도"를 조절하는 것이 권한 모드이며, 현재 6가지가 있다.

Shift + Tab을 반복해 누르면 모드가 순환하고, 화면 하단에 현재 모드가 표시된다. 시작할 때 claude --permission-mode plan처럼 지정할 수도 있다.

#모드 비교표

#⭐ auto 모드 — 2026년의 핵심 변화

auto 모드란

"별도의 분류기(classifier) 모델이 Claude의 행동을 실행 직전에 검사해서, 위험한 것만 막고 나머지는 묻지 않고 통과시키는 모드"

매번 "허용하시겠습니까?"를 누르는 피로(prompt fatigue)를 없애면서도, bypassPermissions처럼 무방비가 되지는 않는다. 모든 요금제에서 사용 가능하다.

#🛡 보호 경로 (Protected Paths)

bypassPermissions를 제외한 모든 모드에서, 아래 경로에 쓰는 일은 절대 자동 승인되지 않는다. 저장소 상태와 Claude 자신의 설정이 사고로 망가지는 것을 막는 장치다.

• .git, .claude, .vscode, .idea, .devcontainer 등 디렉터리

• .gitconfig, .bashrc, .zshrc, .npmrc, .mcp.json 등 파일

#권한 규칙 — 미리 허용·질문·거부하기

모드가 기본선이라면, 그 위에 규칙(rule)을 얹어 개별 도구를 조절한다. /permissions로 관리하거나 .claude/settings.json에 직접 적는다.

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(npm run test:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Bash(rm -rf:*)"
    ]
  }
}

• allow — 묻지 않고 허용 (안전한 읽기·조회 명령)

• ask — 어떤 모드에서든 반드시 묻게 만든다 (auto 모드에서도 강제)

• deny — 어떤 모드에서든 무조건 거부 (bypassPermissions에서도 유효)

#3. 플랜 모드 깊이 보기

플랜 모드란

"코드를 바로 고치지 않고, 먼저 '무엇을 할지 계획'만 세우게 하는 모드"

복잡한 작업을 시킬 때 AI가 곧장 파일을 수정하기 시작하면 통제가 어렵다. 플랜 모드는 읽기·조사만 허용하고, 실제 변경 전에 계획을 검토·승인하게 한다.

#진입하는 두 가지 방법

#계획을 받은 뒤 — 승인의 4갈래

계획이 준비되면 Claude가 어떻게 진행할지 묻는다. 여기서 바로 실행 모드를 고르는 것이 핵심이다.

#4. 되돌리기 — 체크포인트와 Rewind

작업이 잘못된 방향으로 갔을 때 이전 상태로 되돌리는 것이 바이브 코딩의 핵심 안전장치다. Claude Code는 3층 안전망을 제공한다.

되돌리기의 철학

"멀리 가서 크게 망가뜨리지 말고, 짧게 가서 자주 점검하라." 한 번에 완벽을 노리지 말고 작은 단위 → 검증 → (필요시) 되돌리기의 루프를 빠르게 돈다.

#5. 세션 이어가기

터미널을 닫았다가 다시 켜도 이전 작업을 그대로 이어갈 수 있다.

#6. 컨텍스트 윈도우 관리

컨텍스트 윈도우란

"AI가 한 번에 기억하고 참고할 수 있는 대화·코드의 총량" (개념은 Part 4 참고)

대화가 길어질수록 컨텍스트가 쌓이고, 한도에 가까워지면 응답 품질이 떨어진다. 그래서 무엇이 컨텍스트를 차지하는지 보고, 적절히 비우거나 압축하는 관리가 중요하다.

#7. 생각을 더 깊게 — 확장 사고와 /effort

어려운 문제는 AI에게 더 오래 생각하게 만들 수 있다. AI가 답을 내기 전에 속으로 추론하는 것을 확장 사고(extended thinking)라 하고, 여기에 얼마나 많은 자원을 쓸지를 노력 수준(effort)으로 조절한다.

#조절하는 두 가지 방법

#/effort 단계

#8. 자주 쓰는 실전 워크플로우

#① 탐색 → 계획 → 구현 → 검증

flowchart LR
    E[탐색<br/>코드베이스 파악] --> P[계획<br/>플랜 모드]
    P --> I[구현<br/>작은 단위로]
    I --> V[검증<br/>테스트·실행]
    V -->|반복| I
    style E fill:#e3f2fd
    style P fill:#f3e5f5
    style I fill:#fff3e0
    style V fill:#e8f5e9

새 코드베이스에서 일할 때의 기본기. 먼저 읽게 하고(탐색), 계획을 세우게 하고(플랜 모드), 작게 구현하고, 바로 검증한다.

#② 테스트 주도 (TDD)

테스트가 명확한 목표가 되어 AI가 헤매지 않는다.

#③ 스크린샷·이미지로 지시

디자인 시안이나 에러 화면을 이미지로 붙여넣어 지시할 수 있다.

#④ Git 커밋·PR 자동화

"변경사항을 적절한 메시지로 커밋하고 PR 올려줘"

Claude Code가 git diff로 변경을 분석하고, 컨벤션에 맞는 메시지를 작성하고, 커밋·푸시·PR 생성까지 한 번에 처리한다. (Part 7의 /commit 커스텀 명령어와 함께 쓰면 더 좋다.)

#9. 백그라운드 작업

오래 걸리는 명령(개발 서버, 빌드, 테스트 워치)은 백그라운드로 실행해두고 다른 작업을 이어갈 수 있다.

#곁다리 질문 — /btw

긴 작업이 도는 중에 "아 그 설정 파일 이름이 뭐였지?" 같은 질문이 떠오를 때가 있다. 그냥 물어보면 대화 기록이 지저분해지고 Claude가 하던 일에서 새어나간다.

/btw는 대화 기록에 남지 않는 곁다리 질문이다.

/btw 아까 그 설정 파일 이름이 뭐였지?

• 현재 대화 내용을 다 보고 답한다 (지금까지 읽은 코드·내린 결정 포함)

• 답변은 떠 있는 창에만 뜨고 대화 기록에 들어가지 않는다

• Claude가 일하는 중에도 물어볼 수 있다 (하던 작업을 방해하지 않는다)

• 단, 도구를 못 쓴다 — 이미 컨텍스트에 있는 것만으로 답한다

#포그라운드 작업을 넘기는 흐름

시간이 오래 걸리는 작업이 포그라운드로 실행 중일 때도, 끝날 때까지 기다릴 필요 없이 백그라운드로 넘기고 일을 이어갈 수 있다.

flowchart LR
    A[긴 작업<br/>포그라운드 실행 중] -->|Ctrl + B| B[백그라운드로 전환]
    B --> C[다른 작업<br/>병행 진행]
    B -.->|작업 완료 시| D[🔔 완료 알림]
    D --> E[결과 확인·이어서 처리]
    style A fill:#fff3e0
    style B fill:#e3f2fd
    style C fill:#f3e5f5
    style D fill:#e8f5e9
    style E fill:#e8f5e9

1. Ctrl + B로 전환 — 실행 중인 작업을 백그라운드로 넘긴다

2. 다른 작업 병행 — 프롬프트가 바로 풀려 새 지시를 계속할 수 있다

3. 완료 시 알림 — 작업이 끝나면 알림이 와서 Claude가 결과(출력·종료 코드)를 확인하고 이어서 처리한다

#10. 안전하게 쓰는 5가지 원칙

#정리

• 명령어는 슬래시(/), 입력 기호(@ # !), 단축키로 나뉜다 — /만 쳐도 목록이 뜬다

• 6가지 권한 모드 — default(Manual) · acceptEdits · plan · auto · dontAsk · bypassPermissions. Shift+Tab으로 순환(기본 3개)

• auto 모드가 핵심 — 분류기가 위험한 것만 막고 나머지는 묻지 않는다. 확인 피로를 줄이면서 안전은 지킨다

• 보호 경로(.git·.claude 등)는 bypassPermissions를 빼면 어떤 모드에서도 자동 승인되지 않는다

• 규칙은 allow(묻지 않음) · ask(반드시 물음) · deny(무조건 거부) 3종

• 플랜 모드는 Shift+Tab 또는 /plan으로 진입하고, 승인할 때 실행 모드를 함께 고른다

• 되돌리기는 3층 — Esc(중단) → Esc Esc·/rewind(체크포인트) → Git(진짜 안전망)

• --continue·--resume으로 세션을 이어간다

• 컨텍스트는 /context로 확인하고 /compact·/clear로 관리한다 (한도 근처에선 자동 압축)

• 사고 깊이는 /effort와 Alt+T로 조절한다 (매직 키워드가 아니다)

• 오래 걸리는 작업은 Ctrl+B로 백그라운드, /tasks로 확인 (Ctrl+T는 할 일 체크리스트)

• 핵심 무기는 탐색→계획→구현→검증 루프와 TDD·이미지 지시·Git 자동화 워크플로우

다음 장에서는 이 모든 걸 종합해 실전 프로젝트를 직접 만든다.