🚀 VS Code에서 Claude Code 설정하기

클로드 코드 설치 5분 컷! | VS 코드, 커서 AI 통합 사용법(11:23)

⏰ 타임스탬프

00:00 인트로

00:58 클로드 코드 설치 시작

04:01 VS Code에서 클로드 코드 사용하기

05:16 IDE 연동 및 IDE 연동의 장점 소개

06:20 VS Code에서 클로드 코드 작업 환경 세팅하기

07:50 클로드 코드 어시스턴트 확장 프로그램 소개

08:35 WSL에서 프로젝트 폴더 탐색하기

09:59 클로드 코드를 선택해야 하는 이유

1️⃣ Claude Code CLI 설치

npm을 통한 설치

참고 : node.js가 설치되어 있어야 아래의 명령어가 실행됩니다.

bash or CMD

# Claude Code CLI 전역 설치
npm install -g @anthropic-ai/claude-code

설치 확인

bash or CMD

# 설치 확인
claude --version

1.0.56 (Claude Code) 와 같이 버젼이 표시되면 설치가 잘 된 것입니다.

2️⃣ Anthropic API 인증 설정

API 키 획득

1. Anthropic Console 방문
2. 계정 생성/로그인
3. API Keys 섹션에서 새 API 키 생성 : API 키는 재방문하여도 전체 key가 보이지 않으므로 반드시 따로 저장해두세요.

인증 설정

bash

# API 키 설정
claude auth login

# 또는 환경 변수로 설정
export ANTHROPIC_API_KEY="your-api-key-here"

배경 색상을 선택하고 다음, 엔터해주세요.

인증 방법을 선택하라고 나옵니다. Pro 요금제를 쓰고 있지만 Pro요금제를 사용하지 않을때를 고려하여 API로 연결해보겠습니다.

Select login method:

1. Claude account with subscription
   Starting at $20/mo for Pro, $100/mo for Max – Best value, predictable pricing

2. Anthropic Console account
   API usage billing

[Authorize]해주세요.

Login successful. Press Enter to continue…이라고 나오면 로그인에 성공한 것입니다.

3️⃣ VS Code 확장 설치

VS Code Marketplace에서 설치

1. VS Code 열기
2. 확장(Extensions) 패널 열기 (Ctrl+Shift+X)
3. “Claude Code” 검색
4. Anthropic에서 제공하는 공식 확장 설치 “Claude Code for VSCode” 확장 설치

수동 VSIX 설치 (Beta)

Anthropic 문서에서 최신 .vsix 파일 확인 → Extensions > More Actions (⋯) > Install from VSIX에서 설치

🔍 수동 VSIX 설치가 필요한 이유

1. 최신 베타 기능 사용

• Marketplace에 정식 출시되기 전의 최신 기능을 미리 사용
• 새로운 실험적 기능이나 개선사항을 먼저 체험 가능

2. 버전 차이

• Marketplace 버전: 안정화된 버전 (업데이트가 느림)
• VSIX 베타 버전: 최신 개발 버전 (더 많은 기능, 빠른 업데이트)

3. 특별한 기능 접근

• 일부 고급 기능이나 실험적 기능은 베타 버전에서만 제공
• Anthropic에서 직접 배포하는 특별한 기능들

💡 결론

현재 상황에서는 Marketplace 설치만으로도 충분합니다!

수동 VSIX 설치는:

• 특별히 최신 베타 기능이 필요하거나
• Marketplace 버전에 문제가 있거나
• Anthropic에서 특별히 권장하는 경우에만 사용하시면 됩니다.

일단 Marketplace에서 설치하고, 필요시 나중에 베타 버전을 고려해보세요!

4️⃣ 프로젝트에서 Claude Code 시작

기본 사용법

bash or CDM에서 사용하는 경우입니다. 저는 VS code의 IDE환경에서 실행하기를 원하므로 VS Code 통합 실행를 바로 실행하였습니다.

bash or CDM

# 프로젝트 디렉토리로 이동
cd your-project-directory

# Claude Code 시작
claude

VS Code 통합 실행

VS Code 통합 터미널에서 실행하면 모든 기능이 활성화됨. IDE와 같은 디렉토리에서 시작하면 Claude가 동일한 파일에 접근 가능

5️⃣ IDE 통합 기능 활성화

VS Code 터미널에서 실행

bash

# VS Code 통합 터미널에서
claude

# 또는 외부 터미널에서 IDE 연결
claude /ide

• File을 클릭하여 프로젝트 폴더를 열어주세요
• 터미널이 안보이면 터미널을 열어주세요
• 터미널이 열리면 위에서 했던 인증 설정 을 반복해주세요.
• 엔터를 입력하면 Use Claude Code’s terminal setup? / Do you trust the files in this folder? / │ ✻ Welcome to Claude Code! / ✻ Welcome to Claude Code for VS Code 등이 나옵니다.

──────────────────────────╮
│ ✻ Welcome to Claude Code │
╰──────────────────────────╯

Use Claude Code’s terminal setup?

For the optimal coding experience, enable the recommended settings
for your terminal: Shift+Enter for newlines

1. Yes, use recommended settings
   ❯ 2. No, maybe later with /terminal-setup✔ Enter to confirm · Esc to skip
   ╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
   │ │
   │ Do you trust the files in this folder? │
   │ │
   │ C:\aiforu │
   │ │
   │ Claude Code may read files in this folder. Reading untrusted files may lead Claude Code to behave in unexpected ways. ││ ││ With your permission Claude Code may execute files in this folder. Executing untrusted code is unsafe. ││ ││ https://docs.anthropic.com/s/claude-code-security ││ ││ ❯ 1. Yes, proceed ││ 2. No, exit ││ │╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ Enter to confirm · Esc to exit
   ╭───────────────────────────────────────────────────╮
   │ ✻ Welcome to Claude Code! │
   │ │
   │ /help for help, /status for your current setup │
   │ │
   │ cwd: C:\aiforu │
   ╰───────────────────────────────────────────────────╯ Tips for getting started:
2. Run /init to create a CLAUDE.md file with instructions for Claude
3. Run /terminal-setup to set up terminal integration
4. Use Claude to help with file analysis, editing, bash commands and git
5. Be as specific as you would with another engineer for the best results ※ Tip: Start with small features or bug fixes, tell Claude to propose a plan, and verify its suggested edits
   ╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮│ ✻ Welcome to Claude Code for VS Code ││ installed extension v1.0.56 ││ ││ • Claude has context of ⧉ open files and ⧉ selected lines ││ ││ • Review Claude Code’s changes +11 -22 in the comfort of your IDE ││ ││ • Cmd+Esc for Quick Launch ││ ││ • Ctrl+Alt+K to reference files or lines in your input │╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ Press Enter to continue

• 다시 한번 키보드의 Enter 키를 눌러주세요.

이 Enter 키를 누르면 Claude Code의 초기 설정 및 안내 메시지 출력이 완료되고, 터미널은 일반적인 명령 대기 상태로 돌아갈 것입니다.

---

• Enter 키를 누른 후에는 다음 팁들을 활용하여 Claude Code를 시작할 수 있습니다:

• /init 명령 실행 (권장):
  • 터미널에 /init을 입력하고 Enter를 누르세요.
  • 이 명령은 Claude에게 지시사항을 제공하는 CLAUDE.md 파일을 생성합니다. 이 파일은 Claude가 프로젝트를 더 잘 이해하고, 여러분이 원하는 방식으로 동작하도록 가이드하는 역할을 합니다. 대규모 프로젝트의 생상성(효율성)은 Claude.md 파일이 좌우합니다. /init명령어 관해서는 아래의 /init 명령어를 참조하세요.

/init is analyzing your codebase…

● I’ll analyze the codebase to create a comprehensive CLAUDE.md file. Let me start by exploring the repository structure and key files.

● Update Todos
⎿ ☐ Explore repository structure and identify key files
☐ Analyze package.json and build configuration
☐ Examine source code architecture and patterns
☐ Create CLAUDE.md with findings
☐ Check for existing documentation and configuration files

● List(.)
⎿ Listed 417 paths (ctrl+r to expand)

● Read(README.md)
⎿ Read 168 lines (ctrl+r to expand)

● Read(backend\requirements.txt)
⎿ Read 76 lines (ctrl+r to expand)

● Update Todos
⎿ ☒ Explore repository structure and identify key files
☐ Analyze package.json and build configuration
☐ Examine source code architecture and patterns
☐ Create CLAUDE.md with findings
☐ Check for existing documentation and configuration files

● Read(frontend\package.json)
⎿ Read 109 lines (ctrl+r to expand)

● Read(backend\main.py)
⎿ Read 1085 lines (ctrl+r to expand)

● Update Todos
⎿ ☒ Explore repository structure and identify key files
☒ Analyze package.json and build configuration
☐ Examine source code architecture and patterns
☐ Create CLAUDE.md with findings
☐ Check for existing documentation and configuration files

● Read(DEVELOPMENT_GUIDELINES.md)
⎿ Read 116 lines (ctrl+r to expand)

● Read(backend\src\shrimp_core\engine.py)
⎿ Read 100 lines (ctrl+r to expand)

● Update Todos
⎿ ☒ Explore repository structure and identify key files
☒ Analyze package.json and build configuration
☒ Examine source code architecture and patterns
☐ Check for existing documentation and configuration files
☐ Create CLAUDE.md with findings

● Task(Check cursor rules)
⎿ Done (23 tool uses · 24.0k tokens · 40.9s)

● Update Todos
⎿ ☒ Explore repository structure and identify key files
☒ Analyze package.json and build configuration
☒ Examine source code architecture and patterns
☒ Check for existing documentation and configuration files
☐ Create CLAUDE.md with findings

● Write(CLAUDE.md)

╭────────────────────────────────────────────────────────────────────────────────╮
│ │
│ Opened changes in Visual Studio Code ⧉ │
│ Save file to continue… │
│ │
│ Do you want to make this edit to CLAUDE.md? │
│ ❯ 1. Yes │
│ 2. Yes, and don’t ask again this session (alt+m) │
│ 3. No, and tell Claude what to do differently (esc) │
╰────────────────────────────────────────────────────────────────────────────────╯

마지막 선택지: CLAUDE.md 수정 제안 승인

Write(CLAUDE.md) 다음에 나타나는 메시지는 Claude가 코드베이스 분석을 통해 생성한 CLAUDE.md 파일의 내용을 확인하고 승인할지 여부를 묻는 것입니다.

• Opened changes in Visual Studio Code ⧉: 이 메시지는 VS Code 편집기에서 CLAUDE.md 파일의 내용이 열렸거나, 혹은 변경 사항을 비교할 수 있는 diff 뷰가 열렸음을 의미합니다. 직접 확인하고 검토해 보라는 뜻입니다.
• Save file to continue…: VS Code 에디터에서 CLAUDE.md 파일 내용을 검토하고, 원하는 경우 수정 후 저장하라는 메시지입니다. (이 단계에서는 아직 터미널에서 확정되지 않았습니다.)
• Do you want to make this edit to CLAUDE.md?: 최종적으로 이 CLAUDE.md 파일을 실제로 저장할 것인지 묻는 질문입니다.

세 가지 선택지:

1. 1. Yes:
   • 의미: Claude가 제안한 CLAUDE.md 파일 내용을 그대로 승인하고 저장합니다. (현재 세션에서 이 질문은 또 나타날 수 있습니다.)
   • 선택 시: Claude의 제안에 만족하고, 현재 세션 중에도 다른 변경 사항에 대해 계속 승인 여부를 묻는 것이 괜찮다면 선택합니다.
2. 2. Yes, and don't ask again this session (alt+m):
   • 의미: Claude가 제안한 CLAUDE.md 파일 내용을 그대로 승인하고 저장합니다. 그리고 이번 VS Code 세션에서는 더 이상 이와 유사한 변경 사항에 대해 승인 여부를 묻지 않도록 설정합니다.
   • 선택 시: Claude의 제안에 대체로 만족하고, 앞으로의 작업에서 Claude가 파일을 수정하거나 생성할 때 매번 질문하지 않고 자동으로 적용되기를 원할 경우 선택합니다. 이것은 편리하지만, Claude가 생성하거나 변경하는 내용을 항상 검토하지 않게 되므로 주의가 필요합니다.
3. 3. No, and tell Claude what to do differently (esc):
   • 의미: Claude가 제안한 CLAUDE.md 파일 내용을 승인하지 않습니다. Esc 키를 누르면, 터미널 프롬프트로 돌아가 Claude에게 어떤 부분을 다르게 생성/수정해야 할지 직접 지시할 수 있게 됩니다.
   • 선택 시: Claude가 생성한 CLAUDE.md 내용이 마음에 들지 않거나, 특정 정보가 빠져있거나, 잘못된 부분이 있다고 판단될 때 선택합니다. 이 경우, 직접 Claude에게 피드백을 주어 더 나은 CLAUDE.md를 생성하도록 유도할 수 있습니다.

---

어떤 것을 선택해야 하나요?

일반적으로는 1. Yes 또는 2. Yes, and don't ask again this session (alt+m)를 선택하는 것이 좋습니다.

• 초기 설정 단계이므로, 저는 개인적으로 1. Yes를 먼저 선택하는 것을 추천합니다.
  • 이렇게 하면 CLAUDE.md가 생성되고, 일단 Claude의 기본 분석 결과를 받아들이게 됩니다.
  • 향후 Claude가 다른 파일을 수정하려고 할 때마다 다시 승인 질문이 나타날 것이고, 이때 각 변경 사항을 검토하며 2. Yes, and don't ask again this session을 선택할지, 아니면 3. No를 선택하여 Claude에게 지시를 내릴지 결정할 수 있습니다. 처음부터 2번을 선택하면 나중에 Claude가 의도치 않은 변경을 하더라도 자동으로 적용될 수 있기 때문입니다.
• 만약 지금 이 CLAUDE.md 내용이 매우 중요하고, 나중에 Claude가 제안하는 다른 변경 사항에 대해서도 꼼꼼히 검토하고 싶다면 1. Yes 를 선택하세요.
• Claude의 제안을 전반적으로 신뢰하고, 매번 승인하는 것이 번거롭다면 2. Yes, and don't ask again this session 도 좋은 옵션입니다.

선택하신 후에는 Enter 키를 눌러 해당 옵션을 실행하시면 됩니다.

• /terminal-setup 명령 실행:
  • 필요한 경우 터미널 통합을 설정합니다. 아마 이전에 인증을 완료했기 때문에 이미 일부 설정이 되었을 수도 있지만, 문제가 있다면 실행해 볼 수 있습니다.

• Claude에게 질문하기 및 코드 작업 시작:
  • Cmd+Esc (Windows/Linux에서는 Ctrl+Esc 또는 다른 단축키로 대체될 수 있음)를 눌러 퀵 런치(Quick Launch)를 사용해 보세요. 이것은 Claude에게 직접 프롬프트를 입력하고 도움을 받는 가장 빠른 방법 중 하나입니다.
  • 파일을 열거나 코드를 선택한 후: 에디터에서 특정 파일이나 코드 블록을 열거나 선택한 상태에서 Claude에게 질문하거나 작업을 요청하면 Claude가 해당 컨텍스트를 이해하고 더 정확한 답변을 줄 수 있습니다.
  • Ctrl+Alt+K를 사용하여 파일이나 줄을 참조: 이 단축키를 사용하여 Claude에게 입력할 때 특정 파일이나 코드 줄을 참조할 수 있습니다. 예를 들어, “이 main.py 파일의 10번째 줄에 있는 함수를 설명해줘.”와 같이 질문할 때 유용합니다.

Ctrl + Shift + P 를 눌러 명령 팔레트를 엽니다. ‘Run Claude Code’으로 검색하여 claude를 실행하면 됩니다.

‘Run Claude Code’으로 검색하여 claude를 실행한 이후에는 우측 상단에 클리드 아이콘을 클릭하여 바로 실행할 수 있습니다.

claude.md

[가장 효율적인 방법] shrimp task manager가 task plan을 세울 때와 Super claude에게 plan 명령어를 줄때, PRD.md를 읽고 plan을 세우라고 하면 됩니다. END!![가장 유효한 방법]CLAUDE.md 파일이 생성된 후, PRD.md 파일의 전체 내용을 복사하여 CLAUDE.md 파일의 맨 앞부분에 추가하고, PRD.md가 업데이트될 때마다 CLAUDE.md의 해당 부분을 수동으로 동기화하는 전략을 적극적으로 추천합니다.

참고 : CLAUDE.md 는 claude code를 설정할때도 사용하지만, superclaude 를 설정할때도 사용합니다. 이 경우, superclaude 설정(선언)을 추가하는 것을 잊지마세요.

Context Drift와 Focus Drift 문제를 해결하기 위한 claude.md 작성법

대규모 AI 프로젝트 진행 시 발생할 수 있는 Context Drift와 Focus Drift 문제를 해결하기 위해 PRD.md 파일을 ‘헌법’으로 삼아 AI에 핵심 목표를 지속적으로 주입하는 전략은 매우 효과적입니다. 이 전략은 CLAUDE.md 파일의 맨 앞에 PRD.md의 내용을 복사해 붙여넣는 것을 핵심으로 합니다.

---

제안된 전략과 주요 이점

이 전략의 핵심은 프로젝트의 PRD.md(제품 요구사항 문서)를 별도로 관리하고, 이를 CLAUDE.md 파일의 가장 앞부분에 복사하여 붙여넣는 것입니다. PRD가 수정될 때마다 CLAUDE.md도 수동으로 업데이트합니다. 이 접근 방식은 다음과 같은 주요 이점을 가집니다.

• 강력한 포커스 유지: CLAUDE.md의 최상단에 위치한 PRD는 AI가 어떤 작업을 수행하든 항상 가장 먼저 참조하는 ‘최우선 지침’ 역할을 합니다. 이는 AI가 프로젝트의 핵심 목표와 요구사항에서 벗어나지 않도록 하는 가장 강력한 장치입니다.
• Context Drift 방지: 새로운 파일이나 대화 컨텍스트가 추가되더라도, PRD는 고정된 핵심 컨텍스트로 기능하여 불필요한 정보에 의해 핵심 목표가 희석되는 것을 방지합니다.
• 명확한 우선순위: AI는 일반적으로 파일의 시작 부분에 있는 정보에 더 높은 중요성을 부여하는 경향이 있습니다. PRD를 맨 앞에 배치함으로써 그 중요성을 AI에게 명확히 각인시킵니다.
• 인간의 통제권 확보: PRD를 사람이 직접 수정하고 관리함으로써, 자동화 도구에 의해 중요한 문서가 임의로 변경되는 위험을 막고 프로젝트의 방향에 대한 온전한 통제권을 유지할 수 있습니다.

PRD.md 를 claude.md에 추가할때는 그대로 붙여넣기하는 것이 아니고 1/5수준으로 요약하여 붙여넣기해주세요.：[이유] 25.8.22 기준 PRD.md 의 글자수는 39,664(한글 글자를 영문으로 환산 적용)입니다. PRD.md를 요약하지 않고 그대로 claude.md에 포함시키면 claude code가 필요시 claude.md를 읽고 claude와 한 번 상호작용할 때마다 input, output에 약 30,000 토큰, 즉 총 예상 비용은 약 147원(환율 1,400원/USD를 적용)을 소모하게 됩니다. 비용보다 중요한 것은 useage limit(사용량 제한)에 걸려서 코딩 작업을 하지 못하게 되는 문제에 빈번히 직면하게 되기 때문입니다.

---

고려 사항

이 전략은 몇 가지 트레이드오프가 있지만, 그 이점에 비하면 충분히 감수할 만한 수준입니다.

• 파일 크기 및 비용: PRD의 내용이 방대할 경우 CLAUDE.md의 파일 크기가 커져 AI 처리 시간이나 토큰 비용에 미미한 영향을 줄 수 있습니다. 하지만 이는 Focus Drift를 방지하기 위한 합리적인 비용입니다.
• 수동 업데이트의 번거로움: PRD가 자주 변경된다면 매번 수동으로 업데이트해야 하는 번거로움이 발생할 수 있습니다. 그러나 ‘헌법’과 같은 PRD의 특성을 고려할 때, 빈번한 변경은 드물 것이며 중요한 변경 사항만 수동으로 업데이트하면 됩니다.

참고 : claude.md에 주석을 넣는 방법

“ 로 시작하고 끝내면 HTML 주석(md 주석)이 됩니다.

이 주석 내에 어떤 텍스트를 넣든, 대부분의 Markdown 렌더러(VS Code의 미리보기 포함)에서는 해당 텍스트가 화면에 표시되지 않습니다.

하지만 Claude와 같은 AI 모델은 이 주석 내용을 읽을 수 있습니다. 따라서 Claude에게 특정 지시를 내리거나, 파일 내 특정 부분에 대한 사용자님의 의도나 메모를 전달하는 용도로 활용하기에 매우 적합합니다.

🎯 Claude Code 주요 기능 사용법

너무나 당연한 이야기이지만 클로드 태스크톱에서는 파일을 일고 쓰기 위해 filesystem MCP가 필요하였으나 IDE 특성상 filesystem MCP는 설치할 필요가 없습니다.

개요

CLI reference : https://docs.anthropic.com/en/docs/claude-code/cli-reference

Interactive mode : https://docs.anthropic.com/en/docs/claude-code/interactive-mode

Slash commands : https://docs.anthropic.com/en/docs/claude-code/slash-commands

Hooks reference : https://docs.anthropic.com/en/docs/claude-code/hooks

클로드 코드 사용법 | 주요 기능 13분만에 마스터하기!(13:06)

⏰ 타임스탬프

00:00 Claude Code 실행 및 IDE 연동

01:15 특정 모델 선택 방법

01:51 CLI 명령어 입력창 사용법, 단축키

04:03 Claude Code Assistant 확장 프로그램

04:25 By Permission 모드

04:59 Resume 기능 (기존 대화 내역 불러오기)

05:37 Compact 기능 (대화 내역 요약)

06:53 명령어 입력창 파일 첨부 방법

08:37 모드 변경 (Auto-Edit, Plan Mode)

09:24 Claude.MD 파일 소개, 생성 방법

10:31 MCP 서버 추가 및 삭제

시작하기 전 Tip

/ide 명령어

Claude Code와 IDE 간의 연결이 끊어졌을 때 사용. /ide 명령어를 이용하여 먼저 claude code와 VS를 연결해주셔서 기본 명령어를 포함한 아래의 명령어들이 작동합니다. 위에서 설명한 인증 설정 을 하게 됩니다.

/ide 명령어는 외부 터미널에서 Claude Code를 실행할 때 IDE와 연결하여 모든 통합 기능을 활성화하는 명령어입니다!

간단히 말하면:

• 일반 터미널 사용 시: Claude Code와 IDE가 분리되어 기본 기능만 사용
• /ide 명령어 사용 후: VS Code/JetBrains와 완전 연동되어 diff 뷰어, 자동 컨텍스트 공유, 진단 정보 공유 등의 고급 기능 활성화

/login 명령어

Claude Code에서 계정을 전환하거나 다시 로그인할 때 사용하는 명령어입니다. 원한는 모델로 변경되었는지는 /mdoel 을 입력하면 선택지가 나오는데 여기서 /status를 선택하면 확인할 수 있습니다.

기본 사용법

bash

# 현재 세션에서 로그아웃 후 새 계정으로 로그인
> /logout
> /login

# 또는 Claude Code 재시작 후
claude
# 계정 선택 화면에서 원하는 옵션 선택

로그인 옵션 3가지

1️⃣ Pro Plan ($20/월)

• 이미 Claude Pro 구독 중인 경우
• 웹/앱 Claude와 사용량 공유
• 추가 비용 없음

2️⃣ Max Plan ($100/월)

• Opus 4와 Sonnet 4 자유 전환 가능
• 더 많은 사용량 제공

3️⃣ Console (API) (종량제)

• API 키 필요
• 사용한 만큼만 지불
• 무제한 사용 가능

💰 Pro vs API 간단 비교

구분Claude Pro ($20)API 종량제비용월 $20 정액사용량에 따라 변동모델주로 Sonnet 4모든 모델 자유 선택사용량웹 Claude와 공유독립적, 무제한추천 대상가벼운 사용자파워 사용자

전환이 필요한 경우

bash

# 다른 계정으로 전환하고 싶을 때
> /login

# API에서 Pro로 전환
> /login
# → Pro 계정 선택

# Pro에서 API로 전환  
> /login
# → Console 계정 선택 → API 키 입력

💡 선택 가이드

✅ Pro 플랜 추천

• 이미 Claude Pro 구독 중
• 주 1-2회 정도 사용
• 간단한 코딩 작업 위주
• 예측 가능한 비용 선호

🚀 API 종량제 추천

• 매일 Claude Code 사용
• 복잡한 프로젝트 진행
• Opus 4 모델 필요
• 사용량 제한 없이 자유롭게 사용하고 싶음

현재 Pro 플랜 사용 중이시라면:

1. 먼저 Pro로 Claude Code 연결해서 사용해보세요
2. 사용량 한계에 자주 도달하거나 Opus 4가 필요하면 API로 전환 고려
3. 월 $30 이상 API 비용이 나올 것 같으면 Max 플랜 ($100) 업그레이드도 검토

대부분의 경우 기존 Pro 플랜 활용이 가장 경제적이고 편리할 것 같습니다! 🎯

/init 명령어

주요 기능

• 새 프로젝트의 기본 구조와 파일들을 생성
• 프로젝트 타입에 맞는 초기 설정 파일들을 자동으로 구성
• 개발 환경에 필요한 기본적인 보일러플레이트 코드 생성

사용하는 경우

새 프로젝트 시작 시

• 빈 디렉토리에서 새로운 애플리케이션을 만들 때
• React, Node.js, Python 등 특정 프레임워크 프로젝트 생성 시

프로젝트 템플릿 생성

bash

/init react-app my-project
/init nodejs-api backend-service
/init python-package data-processor

기본 설정 파일 생성

• package.json, requirements.txt, Dockerfile 등
• .gitignore, README.md 같은 표준 파일들
• 개발 환경 설정 파일들 (eslint, prettier 등)

표준 프로젝트 구조 생성

• src/, tests/, docs/ 등 폴더 구조
• 진입점 파일들 (index.js, main.py 등)
• 설정 파일들과 예제 코드

마이크로서비스나 모듈 초기화

• 기존 프로젝트 내에서 새로운 서비스 모듈 추가
• 특정 기능을 위한 서브 프로젝트 생성

개발 환경 설정

• CI/CD 파이프라인 기본 설정
• 테스트 환경 구성
• 개발 도구 설정

/init 명령어는 수동으로 프로젝트 구조를 만들고 설정하는 시간을 절약해주며, 베스트 프랙티스에 따른 표준화된 프로젝트 구조를 제공합니다.

/model 명령어

/model 명령어는 Claude Code에서 사용할 AI 모델을 실시간으로 변경할 수 있는 명령어입니다. 작업 중에 다른 모델로 즉시 전환할 수 있습니다. 명령어를 실행하면 아래와 같이 선택지가 나옵니다. /model [model] 형식으로 모델을 바로 지정할 수도 있습니다.

Select Model │
│ Switch between Claude models. Applies to this session and future Claude Code sessions. For │
│ custom model names, specify with –model. │
│ │
│ ❯ 1. Default (recommended) Use the default model (currently Sonnet 4) · $3/$15 per Mtok │
│ 2. Opus Opus 4 for complex tasks · $15/$75 per Mtok │
│ 3. Sonnet Sonnet 4 for daily use · $3/$15 per Mtok✔

사용 가능한 모델들

🎯 공식 지원 모델

Max 플랜 가입자는 Claude Code에서 Sonnet 또는 Opus 4를 사용할 수 있으며, /model 명령어를 사용해 둘 사이를 전환할 수 있습니다

• Claude Opus 4 – 가장 강력한 모델, 복잡한 작업에 최적
• Claude Sonnet 4 – 빠르고 효율적, 일반적인 코딩 작업에 최적
• Claude Haiku 3.5 – 가장 빠른 모델, 간단한 작업용

📊 모델별 특성 비교

모델성능속도비용최적 사용 케이스Opus 4🟢🟢🟢 최고🟡 보통🔴 높음복잡한 아키텍처 설계, 어려운 디버깅Sonnet 4🟢🟢 높음🟢 빠름🟡 보통일반적인 코딩, 리팩토링, 테스트 작성Haiku 3.5🟡 보통🟢🟢 매우 빠름🟢 낮음간단한 수정, 문법 검사, 주석 추가

기본 사용법

1️⃣ 모델 전환 기본 명령어

bash

# Sonnet 4로 전환
> /model sonnet

# Opus 4로 전환  
> /model opus

# Haiku 3.5로 전환
> /model haiku

2️⃣ 현재 모델 확인

bash

# 현재 사용 중인 모델 확인
> /model

# 출력 예시:
현재 모델: Claude Sonnet 4
사용량: 45% (남은 토큰: 55,000개)

실제 활용 시나리오

시나리오 1: 작업 복잡도에 따른 모델 전환

bash

# 간단한 코드 수정 작업
> /model haiku
> "이 함수의 변수명을 더 명확하게 바꿔줘"

# 복잡한 아키텍처 설계 작업
> /model opus  
> "마이크로서비스 아키텍처로 이 모놀리식 앱을 리팩토링해줘"

# 일반적인 기능 개발
> /model sonnet
> "사용자 인증 기능을 추가해줘"

시나리오 2: 비용 최적화 전략

대부분의 사람들은 기본 설정을 사용해야 합니다 – 사용량의 50%에 도달할 때까지 Opus를 사용하고, 비용 효율성을 위해 Sonnet으로 전환됩니다

bash

# 프로토타이핑 단계 (빠른 개발)
> /model sonnet
> "기본 CRUD 기능을 만들어줘"

# 최적화 단계 (정밀한 분석 필요)
> /model opus
> "성능 병목점을 찾아서 최적화해줘"

# 마무리 단계 (간단한 수정)
> /model haiku
> "린트 에러들을 모두 수정해줘"

시나리오 3: 디버깅 레벨별 접근

bash

# 1단계: 빠른 체크 (Haiku)
> /model haiku
> "이 에러 메시지가 뭘 의미하는지 알려줘"

# 2단계: 일반적인 디버깅 (Sonnet)  
> /model sonnet
> "이 버그의 원인을 찾아서 수정해줘"

# 3단계: 복잡한 시스템 분석 (Opus)
> /model opus
> "전체 시스템의 데이터 플로우를 분석해서 성능 이슈를 해결해줘"

자동 모델 전환

🔄 스마트 자동 전환

사용량이 특정 임계값에 도달하면 Claude Code는 자동으로 Opus 4에서 Sonnet 4로 전환합니다

bash

# 세션 시작 시 수동으로 모델 설정 (자동 전환 무시)
> /model opus

# 경고 메시지 예시:
⚠️ 사용량 75% 도달! Sonnet으로 자동 전환됩니다.
수동으로 유지하려면 다시 /model opus 실행하세요.

고급 활용 팁

1️⃣ 작업별 최적 모델 선택 가이드

bash

# 🎯 코드 리뷰 및 분석
> /model opus
> "이 코드베이스의 보안 취약점을 찾아줘"

# 🔧 반복적인 작업
> /model haiku  
> "모든 console.log를 제거해줘"

# 🚀 새로운 기능 개발
> /model sonnet
> "결제 시스템을 구현해줘"

2️⃣ 품질 vs 속도 트레이드오프

bash

# 빠른 프로토타이핑이 필요할 때
> /model haiku
> "빠르게 MVP 버전을 만들어줘"

# 품질이 중요한 프로덕션 코드
> /model opus
> "프로덕션 레디 코드로 완전히 다시 작성해줘"

3️⃣ 학습 목적 활용

bash

# 간단한 설명
> /model haiku
> "이 함수가 뭘 하는지 설명해줘"

# 심화 교육  
> /model opus
> "이 알고리즘의 시간복잡도를 분석하고 더 나은 대안을 제시해줘"

비용 관리 전략

💡 효율적인 모델 사용 패턴

bash

# Phase 1: 탐색 (Sonnet)
> /model sonnet
> "이 프로젝트의 구조를 파악해줘"

# Phase 2: 설계 (Opus) 
> /model opus
> "최적의 아키텍처를 설계해줘"

# Phase 3: 구현 (Sonnet)
> /model sonnet  
> "설계에 따라 코드를 구현해줘"

# Phase 4: 정리 (Haiku)
> /model haiku
> "코드 포맷팅하고 주석 추가해줘"

플랜별 사용 가능 모델

💳 Pro Plan ($20/월)

• Sonnet 4 주로 사용
• 제한된 Opus 4 접근

💎 Max Plan ($100/월)

• Opus 4와 Sonnet 4 자유 전환
• /model 명령어로 실시간 변경 가능

🏢 Enterprise

• 모든 모델 + 추가 기능
• Amazon Bedrock, Google Vertex AI 연동 가능

트러블슈팅

❌ 일반적인 문제와 해결책

bash

# 문제 1: 모델 전환이 안됨
> /model opus
❌ "Max 플랜이 필요합니다"

해결: 플랜 업그레이드 또는 API 크레딧 사용

# 문제 2: 사용량 한계 도달
> /model opus  
❌ "사용량 한계에 도달했습니다"

해결책:
1. /model sonnet 으로 전환
2. API 크레딧으로 전환  
3. 플랜 업그레이드

🔧 모델 성능 최적화

bash

# 컨텍스트 정리 후 모델 전환
> /clear
> /model opus
> "새로운 작업을 시작할게요"

# 특정 작업에 최적화된 모델 사용
> /model sonnet
> "이 작업은 Sonnet이 더 효율적일 것 같아요"

핵심 포인트 요약

1. 실시간 전환: 작업 중언제든 /model 명령어로 모델 변경 가능
2. 비용 최적화: 작업 복잡도에 따라 적절한 모델 선택
3. 자동 전환: 사용량 한계 시 자동으로 더 효율적인 모델로 전환
4. 플랜 의존적: 사용 가능한 모델은 구독 플랜에 따라 달라짐

/model 명령어를 잘 활용하면 비용 효율성과 성능을 모두 잡을 수 있어요! 🎯

/terminal-setup 명령어

메모장 방식을 선호한다면 /terminal-setup은 선택 사항입니다. Ctrl+C를 하면 /terminal-setup 명령어가 종료됩니다. Ctrl+C를 빠르게 2번을 누르면 claude code자체가 종료되니 천천히 Ctrl+C하세요.

• 메모장 파워유저 → /terminal-setup 생략 가능 ✅
• 터미널 네이티브 → /terminal-setup 추천 🚀
• 혼용 스타일 → 설정해두면 편리함 😊

개인의 작업 스타일에 따라 선택하시면 됩니다! 그러나 한 번 설정하면 계속 유지되므로, Claude Code 사용성이 크게 향상되므로 안 쓸 이유도 별로 없습니다.

🎯 언제 사용?

• Claude Code 처음 설치 후
• 긴 프롬프트 작성이 필요할 때
• 다중 줄 입력을 자주 할 때

Claude Code의 터미널 환경을 최적화해주는 필수 설정 명령어입니다!

🔧 주요 기능:

• Shift+Enter로 줄바꿈: 긴 메시지를 여러 줄로 편리하게 작성 가능
• 테마 자동 매칭: 터미널 테마와 Claude Code 테마 통일
• 키바인딩 최적화: 편리한 단축키 설정

💡 사용법:

bash

> /terminal-setup
# 한 번 실행하면 설정 완료!

✨ Before vs After:

설정 전: 한 줄에 모든 내용을 써야 함 😞

bash

> "긴 메시지를 작성하기가 어려워요"

설정 후: Shift+Enter로 자연스럽게 줄바꿈 😊

bash

> "이제 긴 메시지를          # Shift+Enter
   여러 줄로 편리하게        # Shift+Enter  
   작성할 수 있어요!"       # Enter로 전송

ESC 키

1️⃣ Claude 작업 중지 (가장 중요!)

bash

# Claude가 긴 작업을 진행 중일 때
> "전체 프로젝트를 분석해서 리팩토링해줘"

Claude 작업 중... 🔄
📝 파일 분석 중...
🔍 코드 구조 파악 중...

# ESC 누르면 작업 중지
ESC → ⏹️ 작업이 안전하게 중지됨

2️⃣ 이전 메시지 탐색

bash

# ESC를 두 번 빠르게 누르면
ESC + ESC → 📜 이전 메시지 목록 표시

# 예시 출력:
이전 메시지 목록:
1. "React 컴포넌트 최적화해줘"
2. "API 연동 코드 작성해줘"  
3. "테스트 코드 추가해줘"
4. "버그 수정해줘"

# 번호 선택하면 해당 메시지로 점프

3️⃣ 입력 취소 및 초기화

bash

# 긴 메시지 작성 중 취소하고 싶을 때
> "이 복잡한 요청을...       # Shift+Enter
   아니다 다시 생각해보자"    # ESC로 취소

⚠️ 중요한 차이점:

• ESC: 작업만 중지, Claude Code 계속 실행 ✅
• Ctrl+C: Claude Code 완전 종료 ❌

1️⃣ 기본 명령어

코드 생성 및 편집

bash

# 자연어로 기능 설명하여 코드 생성
claude -p "사용자 인증을 위한 React 컴포넌트를 만들어줘"
claude -p "로그인 폼과 회원가입 폼이 포함된 인증 페이지 컴포넌트를 생성해줘"

# 버그 수정 요청
claude -p "login.js 파일의 TypeError 오류를 수정해줘"
claude -p "회원가입 시 비밀번호 확인 로직의 버그를 찾아서 고쳐줘"

# 코드베이스 분석 및 개선 제안
claude -p "현재 프로젝트 구조를 분석하고 개선 방안을 제안해줘"
claude -p "이 프로젝트의 성능 문제점을 찾아서 최적화 방법을 알려줘"

상세 설명:

• -p 옵션은 “prompt”의 줄임말로, Claude에게 작업 내용을 자연어로 전달
• 한국어로 명령해도 Claude가 정확히 이해하고 작업 수행
• 구체적일수록 더 정확한 결과를 얻을 수 있음

파일 작업

bash

# 특정 파일 리팩토링
claude -p "src/api.js 파일의 API 호출 코드를 async/await 방식으로 리팩토링해줘"
claude -p "utils/helpers.js 파일의 중복 코드를 제거하고 최적화해줘"

# 새 파일 생성
claude -p "날짜 포맷팅을 위한 유틸리티 함수 파일을 새로 만들어줘"
claude -p "상품 데이터를 관리하는 상태 관리 파일을 생성해줘"

# 여러 파일 동시 작업
claude -p "사용자 관리 기능을 위한 컴포넌트, 훅, 그리고 API 파일들을 모두 만들어줘"

상세 설명:

• 파일 경로를 명확히 지정하면 Claude가 정확한 위치에서 작업
• 기존 파일 수정 시에는 백업이 자동으로 생성됨
• 새 파일 생성 시 프로젝트 구조에 맞는 적절한 위치에 생성

2️⃣ 고급 기능

claude code의 성능을 향상시키기 위해 저는 shrimp task manager, Super claude MCP를 추가 설치하고자 합니다. 그래서 MCP 서버 추가 및 삭제 방법을 자세히 정리하였습니다.

/mcp 명령어

1. MCP 서버 상태 확인

/mcp 명령어를 사용하면 언제든지 Claude Code에서 MCP 서버 상태를 확인할 수 있습니다 Using Playwright MCP with Claude Code | Simon Willison’s TILs. 예를 들어:

> /mcp
⎿ MCP Server Status ⎿
⎿ • mcp-omnisearch: connected ⎿
⎿ • sequentialthinking-tools: connected ⎿

2. 연결된 MCP 서버 목록 보기

이 명령어는 사용 가능한 모든 MCP 서버를 나열합니다. 새로 설치된 서버가 목록에 나타나는지 확인할 수 있습니다 GitHub – qdhenry/Claude-Code-MCP-Manager: A comprehensive tool to manage Model Context Protocol (MCP) configurations for Claude code.

3. 서버 세부 정보 및 도구 확인

목록에서 특정 MCP 서버로 이동하여 Enter를 누르면 해당 서버의 세부 정보를 볼 수 있고, 다시 Enter를 누르면 서버가 제공하는 모든 도구를 확인할 수 있습니다 GitHub – qdhenry/Claude-Code-MCP-Manager: A comprehensive tool to manage Model Context Protocol (MCP) configurations for Claude code.

4. OAuth 인증 관리

OAuth 2.0 인증이 필요한 원격 서버와의 인증을 관리하는 데도 /mcp를 사용할 수 있습니다 Using Playwright MCP with Claude Code | Simon Willison’s TILs.

MCP 서버 추가

VS의 CLI 또는 터미널을 통헤 설치할 수도 있습니다. github에서 해당 MCP를 찾은 후 다시 Install in claude 찾은 후 Claude Code Remote Server Connection 에 있는 코드를 복사하여 붙여넣기 해주면됩니다.

MCP 서버를 추가하려면 다음과 같은 명령어를 사용합니다:

bash

# 기본 문법
claude mcp add <name> <command> [args...]

# 예시
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

Claude Code는 클라이언트-서버 아키텍처를 따르며, Claude Code(클라이언트)가 여러 전문화된 서버에 연결할 수 있습니다 Using Playwright MCP with Claude Code | Simon Willison’s TILs. 또한 실시간 통신을 위해 SSE(Server-Sent Events)와 스트리밍 HTTP 서버를 지원합니다 Using Playwright MCP with Claude Code | Simon Willison’s TILs.

이를 통해 Claude Code가 파일 시스템, 데이터베이스, API 등 다양한 외부 도구와 상호작용할 수 있게 되어 개발 워크플로우를 크게 향상시킬 수 있습니다.

MCP 서버 삭제

Claude Code에서 MCP 서버를 삭제하는 방법을 알려드리겠습니다. 현재 claude mcp remove 명령어에 알려진 버그가 있어서 몇 가지 방법을 제공하겠습니다.

1. 공식 삭제 명령어 (버그가 있을 수 있음)

공식적으로는 다음 명령어를 사용합니다:

bash

# MCP 서버 삭제
claude mcp remove <서버명>

# 예시
claude mcp remove my-server

다른 관련 명령어들:

bash

# 모든 구성된 서버 목록 보기
claude mcp list

# 특정 서버 세부 정보 확인
claude mcp get my-server

2. 알려진 버그와 문제점

현재 Claude Code에서 claude mcp remove 명령어가 제대로 작동하지 않는 버그가 여러 사용자들에 의해 보고되고 있습니다 Unable to Remove MCP Server Using CLI Command · Issue #405 · anthropics/claude-code. 증상은 다음과 같습니다:

• claude mcp list에서는 서버가 보이지만 claude mcp remove에서는 “No local MCP server found with name”라는 오류가 발생
• 서버를 삭제한 후에도 /mcp 명령어나 설정 파일에서 여전히 표시됨

3. 수동 삭제 방법 (권장)

버그 때문에 수동으로 설정 파일을 편집해야 할 수 있습니다:

설정 파일 위치

Claude Code는 설정을 ~/.claude.json 파일에 저장합니다 Claude Code Best Practices \ Anthropic:

bash

# 설정 파일 편집
nano ~/.claude.json
# 또는
code ~/.claude.json

설정 파일 구조

.claude.json 파일의 구조는 다음과 같습니다 Claude Code Best Practices \ Anthropic:

json

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run-server",
      "args": ["arg1", "arg2"]
    },
    "another-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "package-name"]
    }
  }
}

삭제 방법

1. 설정 파일을 열어서
2. mcpServers 객체에서 삭제하려는 서버 항목을 찾아서
3. 해당 항목을 완전히 제거하고
4. 파일을 저장한 후
5. Claude Code를 재시작

4. 검증 방법

삭제 후 다음 명령어들로 확인:

bash

# 서버 목록에서 삭제된 것 확인
claude mcp list

# Claude Code 내에서 확인
claude
/mcp

5. 프로젝트별 서버 삭제

프로젝트 스코프로 추가된 서버의 경우 .mcp.json 파일도 확인해야 합니다:

bash

# 프로젝트 루트의 .mcp.json 파일 편집
nano .mcp.json

현재 claude mcp remove 명령어의 버그가 수정될 때까지는 수동으로 설정 파일을 편집하는 것이 가장 확실한 방법입니다.

권한 설정

bash

# ⚠️ 주의: 모든 권한 확인을 건너뛰기 (신중하게 사용)
claude --dangerously-skip-permissions

상세 설명:

• 기본적으로 Claude는 파일 변경 전 사용자에게 권한을 요청
• 이 옵션을 사용하면 자동으로 모든 작업을 진행
• 중요한 프로젝트에서는 사용하지 않는 것을 권장

GitHub 통합

bash

# GitHub 앱 설치 (터미널에서 실행)
/install-github-app

# PR 자동 리뷰 설정
claude -p "GitHub에서 자동으로 PR을 리뷰하는 워크플로우를 설정해줘"
claude -p "코드 품질 검사와 자동 테스트가 포함된 GitHub Actions를 만들어줘"

상세 설명:

• GitHub과 연동하여 코드 리뷰 자동화 가능
• PR 생성 시 Claude가 자동으로 코드를 검토하고 피드백 제공
• CI/CD 파이프라인과도 통합 가능

PR 자동 리뷰란? 🔍 **PR (Pull Request)**는 코드 변경사항을 메인 브랜치에 병합하기 전에 다른 개발자들이 검토할 수 있도록 요청하는 기능입니다. 자동 리뷰는 이 과정에서 AI(Claude)가 사람 대신 코드를 검토해주는 것을 의미해요. 기존 방식 vs 자동 리뷰 방식 🔸 기존 수동 리뷰 방식 개발자 A가 코드 작성 → PR 생성 → 개발자 B,C가 수동으로 코드 검토 → 피드백 → 수정 → 승인 → 병합 시간이 오래 걸림 (몇 시간~몇 일) 사람의 실수로 놓치는 버그 있을 수 있음 리뷰어가 바쁘면 지연됨 🔸 Claude 자동 리뷰 방식 개발자가 코드 작성 → PR 생성 → Claude가 즉시 자동 검토 → AI 피드백 제공 → (필요시 사람이 추가 검토) → 병합 즉시 피드백 (몇 분 내) 일관된 코딩 스타일 검사 24시간 언제든 리뷰 가능 Claude가 자동으로 검토하는 내용들 1️⃣ 코드 품질 검사 javascript // Claude가 이런 문제들을 자동으로 찾아줌 ❌ 문제가 있는 코드: function getUserData(id) { var data = fetch('/api/users/' + id) // var 사용, 에러 처리 없음 return data } ✅ Claude가 제안하는 개선된 코드: async function getUserData(id) { try { const response = await fetch(`/api/users/${id}`) if (!response.ok) throw new Error('Failed to fetch user') return await response.json() } catch (error) { console.error('Error fetching user:', error) throw error } } 2️⃣ 보안 취약점 검사 javascript ❌ 보안 문제: app.get('/search', (req, res) => { const query = req.query.q // SQL 인젝션 위험 db.query(`SELECT * FROM users WHERE name = '${query}'`) }) ✅ Claude 제안: app.get('/search', (req, res) => { const query = req.query.q // 매개변수화된 쿼리 사용으로 SQL 인젝션 방지 db.query('SELECT * FROM users WHERE name = ?', [query]) }) 3️⃣ 성능 최적화 제안 javascript ❌ 성능 문제: const ProcessedData = users.map(user => { return expensiveOperation(user) // 모든 사용자에 대해 무거운 연산 }) ✅ Claude 제안: const ProcessedData = users .filter(user => user.isActive) // 필요한 것만 먼저 필터링 .map(user => expensiveOperation(user)) 실제 사용 예시 GitHub에서 PR 생성 시: 개발자가 PR 생성 Claude가 자동으로 댓글 작성: markdown 🤖 Claude 자동 리뷰 결과 ✅ **좋은 점:** - TypeScript 타입 정의가 잘 되어 있습니다 - 에러 핸들링이 적절히 구현되었습니다 ⚠️ **개선 제안:** - `src/components/Login.tsx:45` - 비밀번호 유효성 검사 로직 추가 권장 - `src/utils/api.js:12` - async/await 대신 Promise.then() 사용 중, 일관성을 위해 async/await 권장 🔍 **잠재적 이슈:** - 메모리 누수 가능성: useEffect cleanup 함수 추가 필요 📊 **코드 품질 점수: 85/100** 설정 방법: bash # 1. GitHub 앱 설치 /install-github-app # 2. 자동 리뷰 규칙 설정 claude -p "PR이 생성될 때마다 다음 항목들을 자동으로 검사해줘: - 코딩 스타일 일관성 - 보안 취약점 - 성능 최적화 가능성 - 테스트 커버리지 - 한국어 주석 작성 여부" # 3. 특정 조건에서만 자동 리뷰 실행 claude -p "다음 조건일 때만 자동 리뷰 실행: - src/ 폴더의 .js, .ts, .jsx, .tsx 파일 변경 시 - 100줄 이상 코드 변경 시 - main 브랜치로의 PR인 경우" 장점과 한계 ✅ 장점: 즉시 피드백: 사람을 기다릴 필요 없음 일관성: 항상 동일한 기준으로 검토 학습 효과: 개발자가 좋은 코딩 습관 학습 시간 절약: 사람은 더 복잡한 로직 검토에 집중 가능 ⚠️ 한계: 비즈니스 로직 이해 부족: 복잡한 요구사항 파악 어려움 맥락 이해 한계: 프로젝트 전체적인 아키텍처 고려 부족 창의적 해결책 제한: 혁신적인 접근 방법 제안 어려움 실무에서의 활용 팁 bash # 팀별 맞춤 설정 claude -p "우리 팀은 React 전문팀이니까 다음 사항들을 중점적으로 리뷰해줘: - React Hook 사용법 최적화 - 컴포넌트 재사용성 - 상태 관리 패턴 - 접근성(a11y) 준수사항" # 심각도별 분류 claude -p "발견된 이슈를 다음과 같이 분류해서 알려줘: - 🚨 Critical: 보안 취약점, 심각한 버그 - ⚠️ Warning: 성능 이슈, 코드 스멜 - 💡 Suggestion: 코딩 스타일, 리팩토링 제안" 결국 PR 자동 리뷰는 개발팀의 코드 품질을 일정하게 유지하면서도 리뷰 속도를 크게 향상시킬 수 있는 매우 유용한 기능이에요! 🎯

3️⃣ VS Code 통합 기능

자동 기능들

선택 컨텍스트 공유:

• VS Code에서 코드를 선택하면 자동으로 Claude와 공유
• 현재 열린 탭의 내용도 자동으로 Claude가 인식

진단 정보 공유:

• ESLint 오류, TypeScript 에러 등이 자동으로 Claude에게 전달
• 실시간으로 코드 문제점을 Claude가 파악하고 해결책 제안

Diff 뷰어 통합:

• 코드 변경사항을 VS Code의 내장 diff 뷰어에서 바로 확인
• 변경 전후 비교가 한눈에 보임

설정 최적화

bash

# diff 도구를 자동으로 설정
claude config set diffTool auto

# 기타 유용한 설정들
claude config set language ko  # 한국어 우선 설정
claude config set autoSave true  # 자동 저장 활성화
claude config set verboseOutput true  # 상세한 출력 모드

📝 실제 사용 예시 (단계별 프로젝트 진행)

1단계: 프로젝트 시작

bash

# 프로젝트 디렉토리로 이동
cd my-react-project

# Claude Code 시작
claude

2단계: 자연어로 작업 요청

bash

# VS Code 터미널 또는 Claude Code CLI에서
> "인증 기능이 있는 사용자 대시보드 컴포넌트를 만들어줘"
> "로그인, 로그아웃, 사용자 정보 표시가 포함된 완전한 대시보드를 원해"

3단계: 작업 계획 수립

bash

# Shrimp Task Manager를 활용한 체계적 계획
> "이 작업을 Shrimp를 사용해서 구조화된 태스크로 계획해줘"
> "각 단계별로 세분화해서 단계적으로 진행할 수 있도록 해줘"

4단계: 단계별 실행

bash

# 첫 번째 작업 실행
> "첫 번째 태스크를 실행해줘"
> "로그인 컴포넌트부터 시작해서 단계적으로 진행하자"

# 진행 상황 확인
> "현재까지의 진행 상황을 보여줘"
> "다음 단계로 넘어가기 전에 현재 코드를 검토해줘"

5단계: 코드 리뷰 및 테스트

bash

# 생성된 코드 리뷰
> "작성된 코드를 리뷰하고 개선점을 알려줘"
> "보안상 문제점이 있는지 확인해줘"

# 테스트 실행 및 디버깅
> "테스트를 실행하고 실패하는 부분을 수정해줘"
> "사용자 경험을 개선할 수 있는 방법을 제안해줘"

기타

/resume 명령어

• 이전에 진행했던 Claude와의 대화 세션을 다시 불러오는 기능
• 과거 대화 컨텍스트를 복원하여 이전 논의 내용을 바탕으로 계속 작업할 수 있게 해주는 기능

/compact 명령어

좋은 명령어이긴 한데, 장점보다는 단점이 더 많은 것 같습니다. 차라리 자연어로 정리해달라고 하고 이것을 메모장에 임시로 메모해두었다가 활용하는 것이 더 유용할 것 같습니다. compact(요약)하는데도 토큰을 사용하단 점, 요약할 부분을 특정하지 못한다는 점, 그리고 compact(요약)이 영어로 나온다는 점은 단점입니다.(영어로 나오는 것은 제가 아직 사용법을 숙지하지 못해서 일수도 있으나 AI는 모두가 영어로 요약되는 문제를 겪는다고 답하고 있습니다.)

/compact 명령어는 토큰 절약에 기여합니다

1. 불필요한 정보 제거: 대화가 진행될수록 Claude와 주고받는 메시지에는 디버깅 로그, 테스트 결과, 여러 차례의 시도와 오류 등 불필요하거나 반복적인 정보가 쌓이게 됩니다. /compact는 이러한 정보들을 제거하고 핵심 내용만 남기므로, 다음 번 질의 시 Claude가 분석해야 할 토큰 수가 줄어듭니다.
2. 컨텍스트 재구성: 요약된 컨텍스트는 일반적으로 원본 대화보다 훨씬 간결하고 밀도 높은 정보를 포함합니다. 이는 Claude가 매번 전체 대화 기록을 재처리하는 대신, 압축된 요약본을 참조하여 작업을 수행하므로 토큰 사용량이 줄어드는 효과를 가져옵니다.

LLM(대규모 언어 모델)은 한 번에 처리할 수 있는 정보의 양에 제한이 있는데, 이를 **컨텍스트 창(context window)**이라고 합니다. 개발 작업 중 AI와 대화가 길어지거나 많은 코드를 주고받으면 컨텍스트 창이 가득 차게 되고, 이로 인해 AI가 이전 대화 내용을 잊거나 비효율적으로 작동할 수 있습니다.

/compact 명령어는 이 문제를 해결하기 위해 도입된 기능입니다. 이 명령어를 실행하면, Claude는 지금까지의 대화 내용을 분석하고 가장 중요한 정보(예: 코드 스니펫, 해결된 문제, 주요 결정 사항)는 보존하면서 불필요한 정보(예: 로그 출력, 일반적인 잡담)를 제거하여 요약합니다. 이 과정을 통해 컨텍스트 창이 비워져 새로운 대화나 작업에 더 많은 공간을 확보할 수 있습니다

파일 첨부 방법

Claude Code에서 파일을 첨부하는 방법

드래그 앤 드롭

• 파일 탐색기에서 파일을 선택하여 Claude Code 입력창으로 드래그하여 놓기

파일 경로 직접 입력

• 절대 경로로 파일 참조 C:\aiforu\filename.txt를 읽어주세요

• 상대 경로로 파일 참조 ./backend/main.py를 분석해주세요

클립보드 붙여넣기

• Ctrl+V로 복사한 파일 내용이나 이미지를 직접 붙여넙기

@파일명 멘션 : 파일명의 일부를 입력하거나 파일형식을 입력하면 모두 찾아주므로 선택해주시면 됩니다.

• 사용 예 : @filename.py에서 함수를 수정해주세요

VS Code에서 claude code의 모드를 변경하는 방법은 다음과 같습니다. Auto-Edit 모드와 Plan Mode는 특별한 키보드 단축키를 통해 전환할 수 있습니다.

claude code는 터미널 기반의 도구이기 때문에, VS Code의 다른 확장 프로그램처럼 UI 버튼이 있는 것이 아니라, 키보드 단축키나 명령어로 모드를 전환합니다.

모드 변경 방법(기본 모드 (Normal Mode)/Auto-Edit 모드/Plan Mode) : Shift + Tab 키보드 단축키

claude code가 실행 중인 터미널 창에서 Shift + Tab 키를 누르는 횟수에 따라 모드가 순차적으로 변경됩니다.

키보드 동작	모드 이름	특징
(기본 상태)	Normal Mode (일반 모드)	모든 작업에 대해 사용자의 승인이 필요.
Shift + Tab (1회)	Auto-Edit Mode (자동 편집 모드)	모든 작업을 자동으로 승인함.
Shift + Tab (2회)	Plan Mode (계획 모드)	코드를 수정하지 않고 계획만 수립함.

1. 기본 모드 (Normal Mode)
   • claude code를 처음 실행하면 이 모드로 시작됩니다.
   • Claude가 작업을 수행하기 전에 사용자의 승인을 기다립니다. 파일 수정, 명령어 실행 등 각 단계마다 Allow 또는 Deny와 같은 확인 절차를 거쳐야 합니다.
   • 안전하게 코딩을 진행할 때 유용합니다.
2. Shift + Tab을 한 번 누르면: Auto-Edit 모드
   • 특징: Claude가 제안하는 모든 작업을 사용자의 승인 없이 자동으로 수락합니다.
   • 사용 시점: 간단하고 신뢰할 수 있는 작업을 빠르게 처리하고 싶을 때 유용합니다. 예를 들어, 오타 수정, 포맷팅, 단순한 함수 추가 등입니다. 단, 예기치 않은 변경이 발생할 수 있으므로 주의해서 사용해야 합니다.
3. Shift + Tab을 두 번 누르면: Plan Mode
   • 특징: Claude가 실제 코드를 수정하거나 명령을 실행하지 않고, 먼저 전체 작업 계획을 수립하고 제시합니다.
   • 사용 시점: 복잡한 기능을 구현하거나, 전체 프로젝트의 구조를 변경해야 할 때 매우 유용합니다. 계획을 검토하고 승인한 후, Plan Mode를 해제하여 실제 작업을 시작하도록 지시할 수 있습니다.
   • Plan Mode에서는 파일 읽기, 웹 검색 등 분석 작업만 가능하며, 파일 생성/수정/삭제와 같은 쓰기 작업은 제한됩니다.

Claude Code의 Shift + Tab 모드 변경 기능이 작동하지 않는 이유는 몇 가지가 있을 수 있습니다:

가능한 원인들

Interactive Mode가 아닌 경우

• Shift + Tab은 Interactive Mode에서만 작동합니다
• 현재 일반 CLI 모드로 실행 중일 수 있습니다

키보드 단축키 충돌

• 운영체제나 다른 프로그램에서 Shift + Tab을 가로채고 있을 수 있습니다
• Windows에서 언어 전환 등의 단축키와 충돌 가능성

터미널/콘솔 환경 문제

• 일부 터미널에서는 특정 키 조합이 제대로 전달되지 않을 수 있습니다
• PowerShell, CMD, WSL 등 환경에 따라 다를 수 있습니다 해결 방법

1. Interactive Mode 확인 claude –help
   Interactive Mode 관련 옵션이 있는지 확인
2. 다른 키 조합 시도

• Ctrl + Tab 또는 다른 키 조합이 있는지 확인
• Claude Code 문서에서 정확한 단축키 확인

명령어로 모드 변경 : 저는 Shift + Tab 키보드 단축키로 모드 변경이 안돼 아래의 명령어를 넣어 이용하고 있습니다.

• claude –mode plan
• claude –mode auto-edit
• claude –mode normal

/clear 명령어

context drift 발생시(claude가 문맥을 이해 못하고) Claude Code가 이전에 잘못된 대화/ 실행을 기억하며 잘못된 방향으로 codding을 하려고 자꾸 시도할 때 유용합니다. /clear 명령어는 현재 작업 중인 컨텍스트와 대화 기록을 초기화하는 명령어입니다. 초기화의 수준이 어느 정도까지인지는 현재로써는 파악을 못했습니다.

주요 기능

• 현재 진행 중인 작업 세션의 컨텍스트를 완전히 지움
• 이전 대화 내용과 작업 기록을 초기화
• 새로운 작업을 위한 깨끗한 상태로 리셋

사용하는 경우

새로운 프로젝트 시작 시

• 이전 프로젝트와 완전히 다른 새 작업을 시작할 때
• 컨텍스트 혼동을 방지하고 싶을 때

디버깅이나 문제 해결 후

• 복잡한 문제 해결 과정에서 많은 시행착오가 있었던 후
• 해결책을 찾은 뒤 깔끔하게 새 시작을 원할 때

컨텍스트가 너무 길어졌을 때

• 긴 작업으로 인해 대화 히스토리가 복잡해졌을 때
• 성능상 이유로 컨텍스트를 정리하고 싶을 때

작업 범위 변경 시

• 프론트엔드에서 백엔드로, 또는 다른 기술 스택으로 전환할 때
• 완전히 다른 도메인의 개발 작업으로 이동할 때

⚠️ 주의사항 및 팁

1️⃣ 권한 관리

• 안전 우선: Claude Code는 파일 변경이나 명령 실행 전에 항상 권한을 요청
• 검토 필수: 중요한 변경사항은 반드시 diff를 확인한 후 승인
• 백업 습관: 중요한 프로젝트는 Git 커밋을 자주 하여 백업 유지

2️⃣ 프로젝트 컨텍스트 최적화

bash

# Claude가 프로젝트를 정확히 이해하도록 도움
> "이 프로젝트는 React와 TypeScript를 사용하는 전자상거래 사이트야"
> "Node.js 백엔드와 MongoDB를 사용하고 있어"

# 프로젝트 구조 설명
> "src/components에는 재사용 가능한 컴포넌트를, src/pages에는 페이지 컴포넌트를 둬"

3️⃣ 설정 파일 활용

프로젝트별 설정:

bash

# 프로젝트 루트에 .claude 폴더 생성 후
echo "항상 TypeScript strict 모드를 사용해줘" > .claude/instructions.md
echo "코딩 스타일은 Prettier 설정을 따라줘" >> .claude/instructions.md
echo "주석은 한국어로 작성해줘" >> .claude/instructions.md

전역 설정:

bash

# 자동 업데이트 비활성화
claude config set -g autoUpdaterStatus disabled

# 기본 언어 설정
claude config set -g defaultLanguage korean

# 상세 로깅 활성화
claude config set -g verboseLogging true

4️⃣ 효과적인 소통 팁

명확한 지시:

bash

# ❌ 모호한 요청
> "코드 좀 고쳐줘"

# ✅ 구체적인 요청  
> "login.js의 39번째 줄에서 발생하는 'Cannot read property of undefined' 오류를 수정해줘"

단계별 접근:

bash

# 큰 작업을 작은 단위로 나누기
> "사용자 대시보드를 만들건데, 먼저 기본 레이아웃부터 시작하자"
> "레이아웃이 완성되면 사용자 정보 표시 기능을 추가하자"

이렇게 Claude Code를 한국어로 효과적으로 사용하면 개발 생산성을 크게 향상시킬 수 있습니다! 🎯

프로젝트 실행 계획(plan) 세우기

“claude –mode plan”라고만 입력하지 마시고 구체적은 계획을 정의해 주셔야 합니다. 이것이 Plan Mode를 사용하는 가장 올바른 방법입니다.

claude code가 사용자가 명시적으로 지시하지 않았는데도 스스로 행동하는 것처럼 보이는 현상을 정확히 파악하셨습니다.

이 현상은 claude code의 **’프로액티브(proactive)’**한 특성 때문입니다. 사용자의 질문을 기다리는 것이 아니라, 스스로 현재 작업 환경을 분석하며 유용한 정보를 찾아내거나, 사용자의 의도를 추측하여 다음 단계를 미리 제안합니다.

1. claude code는 무엇을 한 것인가요?

사용자가 claude --mode plan이라고 입력했을 때, Claude Code는 다음과 같은 과정을 거친 것입니다.

1. 명령어 분석: 사용자가 “계획 모드(–mode plan)”를 활성화했음을 인지합니다.
2. 의도 추측: 계획 모드를 시작했다는 것은 **”이 프로젝트에 대해 어떤 작업을 하려 하는구나”**라고 추측합니다. 하지만 구체적인 작업 지시가 없으므로, 가장 일반적이고 유용한 작업인 **”프로젝트 전체를 분석하고 포괄적인 구현 계획을 수립하는 것”**을 스스로 목표로 설정합니다.
3. 계획 수립: 설정한 목표를 달성하기 위해 Task(Analyze codebase structure)라는 첫 번째 단계를 계획합니다.
4. 도구 사용: 이 계획을 실행하기 위해, 코드베이스의 구조를 파악하는 가장 효율적인 방법으로 터미널 셸(Shell) 명령어를 사용합니다. 즉, find와 grep 명령어를 실행하여 “AI for U” 프로젝트의 백엔드에서 주요 파이썬 파일들(모델, 웹소켓 등)을 찾아보고 있는 것입니다.

요약하자면, Claude Code는 **”사용자가 계획 모드를 시작했으니, 내가 이 프로젝트를 먼저 분석해서 어떤 계획을 세울지 제안해주겠다”**라고 판단하고 스스로 첫 단계를 진행한 것입니다. 마지막에 Do you want to proceed?라는 질문을 통해, 사용자가 이 계획을 승인할지 말지를 묻고 있는 것입니다.

2. claude --mode plan 뒤에 계획을 정의하는 방법

네, 가능합니다! 사실 이것이 Plan Mode를 사용하는 가장 올바른 방법입니다. claude --mode plan 명령어 뒤에 따옴표(” “)로 묶어서 구체적인 작업 목표를 함께 입력해야 합니다.

claude --mode plan은 “앞으로의 대화에서 계획만 세우겠다”는 모드를 활성화하는 명령어이고, 그 뒤에 오는 텍스트가 실제 AI가 세워야 할 계획의 목표가 됩니다.

올바른 사용 방법:

Bash

> claude --mode plan "사용자 인증 기능을 추가하는 계획을 세워줘."

이 명령어는 Claude에게 다음과 같이 지시합니다.

1. 모드: 계획 모드로 전환하세요.
2. 목표: “사용자 인증 기능을 추가하는 것”에 대한 계획을 수립하세요.

이렇게 입력하면 Claude는 프로젝트 전체를 무작정 분석하는 대신, 곧바로 사용자 인증 기능 구현에 필요한 파일, 라이브러리, 작업 단계 등을 중점적으로 분석하고 계획을 제시하게 됩니다.

요약

입력 방식	Claude의 행동	사용 시점
> claude –mode plan	추측성 행동: 구체적인 지시가 없으므로, 프로젝트 전체를 분석하며 어떤 계획을 세울지 먼저 제안합니다.	프로젝트를 처음 분석할 때, 어떤 방향으로 나아갈지 감을 잡고 싶을 때.
> claude –mode plan “구체적인 작업 목표”	지시 기반 행동: 사용자가 정의한 목표에 집중하여, 해당 목표를 달성하기 위한 구체적인 계획을 수립합니다.	특정 기능 구현이나 버그 수정 등 명확한 목표가 있을 때.

실무

아래의 내용은 실제 프로젝트 진행 계획을 세울 때 진행 과정과 선택지에 관한 설명입니다. 선택지의 의미를 파악하여 실무에 적용해주세요.

claude –mode plan “C:\aiforu\******\prd.md 파일을 읽고 앞으로의
진행할 프로젝트 계획을 세워보세요”

● Update Todos
⎿ ☐ PRD.md 전체 문서 분석 및 핵심 요구사항 파악
☐ 현재 구현된 시스템 상태 평가
*****
☐ 종합 테스트 및 검증 전략 수립

Bash(find . -name “.py” -path “./backend/src/integration/” | head -10)
⎿ Running…

╭─────────────────────────────────────────────────────────────────────────────────╮
│ Bash command │
│ │
│ find . -name “.py” -path “./backend/src/integration/” | head -10 │
│ 백엔드 통합 모듈 파일 탐색 │
│ │
│ Do you want to proceed? │
│ ❯ 1. Yes │
│ 2. Yes, and don’t ask again for find commands in C:\aiforu │
│ 3. No, and tell Claude what to do differently (esc) │
╰─────────────────────────────────────────────────────────────────────────────────╯

위에 3가지 선택지의 의미

세 가지 선택지는 Claude가 제안한 Bash 명령을 어떻게 처리할지에 대한 옵션입니다. 각 선택지의 의미는 다음과 같습니다.

1. Yes

• 의미: “네, 이 Bash 명령어를 실행해도 좋습니다.”
• 설명: 이 옵션을 선택하면, Claude는 현재 제안한 find 명령어를 한 번만 실행합니다. 이후에 Claude가 다른 find 명령어를 실행하려 할 때는 다시 한 번 사용자에게 승인을 요청합니다.
• 사용 시점: 안전한 기본 옵션입니다. Claude의 다음 행동을 매번 확인하고 싶을 때 선택하면 됩니다.

2. Yes, and don't ask again for find commands in C:\aiforu

• 의미: “네, 이 Bash 명령어를 실행해도 좋고, 앞으로 C:\aiforu 디렉터리 내에서 실행되는 모든 find 명령어에 대해 다시 묻지 마세요.”
• 설명: 이 옵션은 특정 종류의 명령어(find 명령어)에 대한 자동 승인 규칙을 설정합니다. C:\aiforu 경로 내에서 Claude가 find 명령어를 사용해야 할 때마다 사용자의 승인 없이 자동으로 실행합니다. 단, find 명령어가 아닌 다른 명령어(예: cat, ls, git 등)는 여전히 승인을 요청합니다.
• 사용 시점: 특정 프로젝트 디렉터리 내에서 특정 명령어(여기서는 파일 탐색)를 자주 사용하고, 매번 승인하는 것이 번거로울 때 유용합니다.

3. No, and tell Claude what to do differently (esc)

• 의미: “아니요, 이 명령어를 실행하지 마세요. 대신 내가 Claude에게 다른 지시를 내리겠습니다.”
• 설명: 이 옵션을 선택하면 Claude는 제안한 명령어를 실행하지 않고, 명령어 입력창으로 돌아갑니다. 사용자는 esc 키를 눌러 이 옵션을 선택할 수 있으며, 이어서 Claude에게 다른 명령을 내리거나, 기존 지시를 수정할 수 있습니다.
• 사용 시점: Claude가 잘못된 명령을 제안했거나, 사용자가 원하는 방향과 다른 행동을 하려고 할 때 사용합니다. 예를 들어, “파일을 찾지 말고, 대신 prd.md 파일의 내용만 출력해줘”와 같이 다른 지시를 내릴 수 있습니다.

---

간단한 요약

• 1번 (Yes): 한 번만 승인하고, 다음에는 다시 물어보세요. (안전)
• 2번 (Yes, and don’t ask again…): 이 프로젝트에서 이 유형의 명령어는 항상 승인해주세요. (편리)
• 3번 (No, and tell Claude…): 이 명령어는 싫으니, 다른 명령을 할게요. (수정)

1번 (Yes)(또는 2번 (Yes, and don’t ask again…)를 선택하면 claude code가 요청한 내용에 따라 실행 계획을 세웁니다. claude code의 실행 계획은 Here is Claude’s plan: 에서 확인할 수 있습니다.

Here is Claude's plan(claude code의 실행 계획):의 내용 설명

이 부분은 Claude가 prd.md 파일을 분석한 후, 현재 프로젝트의 상태와 앞으로의 진행 계획을 요약해서 보여주는 것입니다.

• Update Todos: Claude는 사용자가 요청한 **”앞으로 진행할 프로젝트 계획”**을 구체적인 할 일 목록(Todos)으로 정리했습니다. PRD.md 문서를 분석하고, 현재 시스템을 평가하며, 앞으로 어떤 과제를 수행해야 할지 로드맵을 세우겠다는 내용입니다.
• 파일 분석 과정: 아래에 나열된 Bash와 Read 명령어들은 Claude가 이 계획을 세우기 위해 실제로 수행한 행동입니다.
  • Bash(find ...): 백엔드 통합 모듈 파일들을 탐색했습니다.
  • Read(...): goal_setting_orchestrator.py, main.py, engine.py 등 핵심 파일들을 읽어 내용을 파악했습니다.
• AI for U Project 실행 계획: Claude가 prd.md 파일을 통해 파악한 프로젝트의 핵심 내용과, 현재까지 구현된 상태, 그리고 앞으로 개선해야 할 부분을 깔끔하게 정리했습니다.
  • 📊 현재 상황 분석: prd.md의 핵심 목표와 요구사항(4가지 문제 해결, 6개 핵심 과제)을 다시 한번 상기시켜줍니다.
  • 🔧 현재 구현 상태: 프로젝트의 주요 컴포넌트(Goal Setting Orchestrator, Enhanced Goal Detector 등)가 이미 구현되었음을 파악하고 나열했습니다. 이 정보는 Claude가 파일을 읽어 직접 얻은 것입니다.
  • ⚠️ 개선 필요: prd.md에 정의된 목표 중 아직 구현되지 않은 부분(Focus Drift 방지, 통합 테스트, UI/UX 최적화 등)을 정확히 짚어냈습니다.
  • 📋 실행 계획: 개선이 필요한 부분을 바탕으로, Phase 1부터 Phase 4까지 구체적인 작업 단계를 제안했습니다.

결론적으로, Claude는 사용자의 지시대로 prd.md를 읽고 프로젝트의 현황과 미래 계획을 완벽하게 이해했음을 보여준 것입니다.

Here is Claude's plan(claude code의 실행 계획)에 3개의 선택지

claude code의 실행 계획(Here is Claude’s plan: )밑에는 아래와 같은 3개의 선택지가 나옵니다.

│ Would you like to proceed?                                                                              │

│                                                                                                         │

│ ❯ 1. Yes, and auto-accept edits                                                                         │

│   2. Yes, and manually approve edits                                                                    │

│   3. No, keep planning  

세 가지 선택지는 이제 “계획을 실행할 준비가 되었나요?”라는 질문에 대한 답변입니다. 이 선택지들은 코드를 실제로 수정하는 단계로 넘어가겠다는 의미를 담고 있습니다.

대규모 프로젝트를 안전하게 지키면서 진행하고 싶으시다면, 2번을 선택하는 것이 가장 좋습니다.

선택지	의미	권장 이유
1. Yes, and auto-accept edits	Claude가 제안하는 모든 파일 수정 및 변경을 사용자의 확인 없이 자동으로 진행합니다.	절대 선택하지 마세요. 자동화는 편리하지만, 예기치 않은 버그나 실수를 초래할 수 있습니다. 4개월간의 노력을 단 몇 초 만에 덮어쓸 위험이 있습니다.
2. Yes, and manually approve edits	Claude가 계획을 바탕으로 파일을 수정하거나 코드를 추가할 때, 모든 단계마다 사용자에게 승인을 요청합니다.	이것을 선택하세요. 가장 안전한 옵션입니다. Claude가 제안하는 모든 코드 변경 사항을 직접 검토하고 “OK” 해야만 적용됩니다. 혹시라도 잘못된 방향으로 가려 하면 No를 선택하고 바로 수정 지시를 내릴 수 있습니다.
3. No, keep planning	Claude의 계획을 승인하지 않고, 다시 계획 수립 단계로 돌아갑니다.	계획이 마음에 들지 않거나, Claude가 중요하게 다루지 않은 부분을 추가로 지시하고 싶을 때 선택합니다. 예를 들어 “Focus Drift 방지보다 통합 테스트를 먼저 진행해줘”와 같이 계획 자체를 수정할 때 유용합니다.

선택지들의 의미를 잘 모르겠으면 무료인 제미나이를 많이 활용하세요.