카테고리 없음

Claude Code Plan mode vs Ask mode vs Code mode 차이: Shift+Tab로 모드 전환하는 법까지

얇은생각 2026. 3. 23. 07:30

Claude Code 완전 정복: Beginner에서 실전 프로젝트까지 (CLI, GitHub, Modes, Tasks, CLAUDE.md)

처음엔 이런 느낌이죠. 누가 terminal에 몇 줄 톡톡 치더니, 웹앱이든 게임이든 그냥 “짜잔” 하고 떠버리는 장면. 뭔가 마술 같기도 하고, 솔직히 살짝 얄미울 정도로 쉬워 보이기도 하고요.

Claude Code는 그 마술을 command line에 그대로 올려둔 도구예요. 폴더 안에서 AI agent에게 “이거 만들어줘”라고 말하면, 파일을 만들고 고치고, 필요하면 command도 실행하고(물론 permission 받고) 프로젝트를 굴려줍니다.

이 글은 제공된 영상 스크립트 내용을 빠짐없이 담아, 한국어로 자연스럽게 풀어쓴 올인원 가이드예요. 완전 초보 기준으로 출발해서 설치 → 사용 → editor 연동 → 모드 전환 → model 선택 → Git/GitHub 버전관리 → background tasks → CLAUDE.md로 memory 유지까지, 끝까지 따라오면 “아, 이제 감 잡았다”가 아니라 “이제 진짜 쓸 수 있겠다” 쪽에 더 가까워질 겁니다.

참고: 스크립트엔 “cloud code”, “clod”처럼 받아쓰기 흔들림이 섞여 있어요. 여기서는 전부 Claude Code로 정리해서 설명합니다.

Claude Code가 뭐예요?

Claude Code는 terminal/CLI에서 돌아가는 도구예요. 여기서 AI agent에게 자연어로 요청하면, 현재 폴더 안의 파일을 만들고 수정하면서 결과물을 내줍니다.

가능한 일은 꽤 폭넓어요.

code generate (처음부터 만들기)
기존 project debug
website 제작
application 생성
작은 game 제작
command 실행(대부분 permission 요청 후 실행)

감각적으로는 “Cursor 같은 AI coding tool을 terminal에 얹어둔 버전”에 가까워요. 차이점은, 이게 shell 안에서 직접 파일을 만지고 command도 돌릴 수 있다는 점. 그래서 속도감이 진짜 미쳤… 아니, 엄청납니다.

그리고 핵심은 이거예요: prompt-based coding.

직접 코드를 빡빡 쓰는 대신, 원하는 결과를 말로 정확히 설명하면 Claude Code가 그걸 코드로 바꿔줍니다. 초보여도 “작게, 정확히”만 잘 하면 꽤 그럴듯한 결과가 나와요.

시작 전에 필요한 것

Claude Code를 쓰려면 Claude에 접근할 수 있어야 하죠. 스크립트 기준으로는 아래 중 하나가 필요합니다.

Claude Pro / Max / Teams / Enterprise subscription
또는 Claude console에서 발급한 API key + tokens/credits

가볍게 테스트만 해볼 거면 가장 저렴한 플랜부터 시작하라고 해요. heavy work를 돌리면 credits가 금방 닳을 수 있거든요.

그리고 비용은 model 선택에 따라 달라집니다(뒤에서 Opus/Sonnet/Haiku 이야기 나옵니다). 대체로 “갑자기 과금 폭탄”이라기보단, credits를 다 쓰면 멈추고 추가 충전하는 구조라 크게 겁먹을 필요는 없다고 스크립트가 말해요.

Claude Code 설치 (Windows/Mac/Linux)

설치는 terminal에서 합니다. (여기서부터 살짝 긴장될 수 있는데… 괜찮아요. 한 번만 넘기면 됩니다.)

1) terminal 열기

Windows: PowerShell 추천
- Windows 검색 → “PowerShell” → 실행
Mac/Linux: Terminal
- Spotlight 검색 → “Terminal”

2) 공식 docs의 install command 실행

스크립트에서는 영상 설명란에 docs 링크가 있고, OS별로 복붙할 command가 제공된다고 안내합니다.

Mac/Linux: curl 기반 command
Windows PowerShell: irm 기반 command
Windows Command Prompt: Command Prompt용 command

중요 포인트 하나.

Claude Code는 desktop app이 아니라, shell/terminal 안에서 돌아가는 CLI tool입니다.

그래서 나중에 쓰려면 또 terminal 열고 claude를 치는 방식이에요.

처음 실행: 인증 + folder trust

설치가 끝나면 테스트는 간단해요.

terminal에서 claude 입력
뭔가 UI가 뜨면 성공

첫 실행에서는 보통:

browser로 넘어가서 account 인증
지금 폴더를 trust 할지 묻는 안내
- 여기서 “Yes, trust the folder” 같은 선택을 해줍니다

그리고 Claude Code UI가 terminal에 뜹니다.

참고로 terminal을 닫으면 세션이 사라지니, 다음에 다시 쓰려면 terminal을 열고 claude를 다시 실행하면 됩니다.

Desktop app: 더 쉽지만 CLI랑은 달라요

terminal이 아직 부담스럽다면, Claude desktop app도 옵션이에요. 스크립트에서는 “Claude Code랑 완전히 같진 않지만 비슷하게 coding을 돕는 모드가 있다”고 설명합니다.

desktop app에서는:

chat / code mode 전환
project 선택
prompt 작성
mode 선택(coding / asking / planning)
file 추가
GitHub 연결
model 선택

이런 게 비교적 UI 친화적으로 제공돼요.

다만 스크립트의 결론은 분명합니다.

“진짜로 serious work 하려면” → CLI(Claude Code) 쪽이 더 강력하다

terminal에서 GitHub 연결하기 (gh auth login)

local Git과 GitHub를 연결하려면, 스크립트에서는 GitHub CLI를 써서 이렇게 합니다.

gh auth login

재미있는 포인트: 스크립트 화자는 이 command를 외우고 있지 않았고, Claude Code에게 물어서 알아냈다고 해요. (이게 이런 tool의 매력입니다.)

흐름은 대략 이렇습니다.

gh auth login 실행
Claude가 permission 요청 → 승인
만약 gh가 없다면 “G was not found” 같은 메시지가 뜰 수 있음
그럼 Claude가 설치를 도와줌(스크립트에선 “option C”로 설치)
다시 gh auth login 실행 승인

그 다음은 one-time code 인증.

terminal에 URL이 뜨고
one-time code가 표시됨
browser에서 URL 열기
GitHub account 선택(스크립트 예시는 “tech with Tim”)
code 붙여넣고 continue
authorization 완료

끝나면 terminal에서 로그인 완료 메시지를 확인합니다.

스크립트에서는 “초반 설정이 번거롭긴 하지만, 나중에 GitHub에 자동으로 쌓이는 걸 보면 진짜 가치가 있다”고 말해요.

Cursor/VS Code 같은 code editor에서 작업하기

Claude Code를 terminal에서만 쓰는 사람도 있지만, 스크립트는 “대부분은 code editor 안에서 terminal을 열고 함께 쓴다”고 설명합니다.

이유는 간단해요.

Claude Code가 만드는 file을 왼쪽 파일 트리에서 바로 보고
변경사항을 눈으로 확인하면서
terminal 부담을 줄일 수 있으니까요

스크립트가 언급하는 editor들:

VS Code
Cursor (특히 추천)
JetBrains IDE
VS Code fork 계열(예: Windsurf)

기본 세팅 흐름

Cursor(또는 VS Code) 열기
File → Open Folder
Desktop 같은 기억하기 쉬운 위치 선택
새 폴더 만들기(스크립트에서는 “Claude code test”가 이미 있어 “Claude code test two”로 만듦)
그 폴더 열기

editor 안에서 terminal 열기

Windows: Ctrl + ` (backtick)
Mac: Cmd + `

또는:

Ctrl + Shift + P (Mac은 Cmd + Shift + P)
“terminal” 검색
Create New Terminal 선택

파일 트리 토글

왼쪽 사이드바 버튼 클릭
또는 Ctrl + B / Cmd + B

그리고 editor terminal에서 claude를 실행하면, 해당 폴더 컨텍스트로 Claude Code가 뜹니다.

스크립트에서는 Cursor를 쓰면 Claude Code가 이를 감지하고 integration 관련 힌트를 주기도 한다고 언급해요.

Basic 사용: 웹 Tic-Tac-Toe 만들기

세팅이 제대로 됐는지 확인하는 가장 쉬운 방법—작은 걸 하나 만들어보는 거죠.

스크립트에서는 이렇게 요청합니다.

“make tic tac toe that I can play on the web.”

Claude Code가 파일을 만들고 수정하려고 할 때 permission을 물을 수 있어요. 이때 화자는:

“Yes, allow all edits during the session”을 선택
화살표 키로 옵션 이동 후 Enter

생성이 끝나면 Claude가 “이 HTML 파일을 열면 된다” 같은 실행 방법을 안내합니다.

스크립트에서는 “start tic tac toe dot HTML”처럼 실행을 시도하고, browser로 열 permission을 승인해서 실제로 게임이 뜨는 걸 보여줘요.

그리고 중요한 관찰 하나.

작업 폴더에 파일들이 생성되고
“Doc Claude” 같은 폴더/메타데이터도 생길 수 있음

그래서 editor에서 하면 file들이 생성되는 걸 바로 볼 수 있어 더 편합니다.

명령어 감 잡기: /help, /commands, 특수기호

Claude Code는 그냥 자연어만 치는 도구가 아니라, 여러 command와 입력 모드가 있어요.

/help

/help를 치면 기본 도움말과 단축키, 입력 방식이 한 번에 정리됩니다.

특수기호들

스크립트 설명 기준으로:

! → bash mode (shell command 쪽)
/ → Claude Code commands
@ → file/path reference (prompt에 파일을 붙이는 느낌)
& → background tasks / keybinds 등과 관련(스크립트 화자는 거의 안 써봤다고 솔직히 말함)

/commands

/commands를 치면 가능한 command 목록이 쭉 나오는데, 이것만 훑어봐도 “이런 것도 되네?”가 계속 튀어나온다고 해요.

custom commands도 만들 수 있다고 언급하지만, 스크립트에선 깊게 다루진 않습니다.

Modes & shortcuts: Plan / Ask / Code

Claude Code의 핵심 mode는 3가지예요.

Ask mode (기본)

file edit나 command 실행 전에 permission을 묻는 쪽

Code mode

보다 자동으로 작업을 진행(덜 물어보고 더 빠르게)

Plan mode

먼저 자세한 plan을 만들고 그 plan대로 실행

mode 전환 방법

Shift + Tab으로 mode를 순환합니다.

스크립트는 Plan → Ask(기본) → Code 순으로 왔다 갔다 한다고 설명해요.

자주 쓰는 shortcuts

입력창 비우기: Escape → Escape
이전 prompt 재사용: Up/Down Arrow
multiline prompt 만들기: Alt + Enter(Windows) / Option + Enter(Mac)
실행 중단: Escape

이런 것들만 알아도 체감 난이도가 확 떨어져요.

Planning prompt 예시: top-down shooter 만들기

스크립트가 강조하는 AI coding의 진짜 핵심은 이것입니다.

“AI가 뭘 할지 알아서 해주겠지”로 가면 결과가 흔들리고
“내가 뭘 원하는지 명확히 말하면” 결과가 훨씬 좋아진다

그래서 화자는 Plan mode에서 먼저 생각을 길게 풀어놓습니다.

게임 요구사항(스크립트 그대로 정리)

browser에서 실행 가능한 top-down shooter

sprites 또는 최소한 보기 좋은 character animation
player가 gun을 가짐
enemies가 여러 방향에서 몰려옴
arrow keys로 이동
mouse로 aim 하고 click으로 shoot
levels / progression
menu screen
너무 복잡하지 않게
2D retro style

화자는 typing 대신 dictation tool인 Whisper Flow로 말해서 입력해요.

그리고 마지막에 한 줄 더 못 박습니다.

“create a plan for this game, then we’ll start executing and coding it.”

Claude가 plan을 만든 뒤 clarification 질문을 던집니다.

sound 넣을까요? → no sounds for now
화면 크기? → 800×600 선택

그리고 실행 여부를 묻는 단계에서 화자는:

“Yes, clear the context and auto accept edits”를 선택합니다.

여기서 clear the context는 이전 대화 내용을 API 요청에 계속 포함하지 않게 해서 tokens를 아끼는 선택이라고 설명합니다.

Verbose 보기, tokens, background 처리

plan을 만들거나 실행할 때 Claude Code UI에서:

얼마나 오래 걸리는지
tokens를 얼마나 쓰는지

같은 걸 볼 수 있다고 스크립트가 짚어요.

verbose 모드(로그 보기)

스크립트에서는:

Ctrl + O로 확장해서 내부 로그/상황을 더 자세히 보고
다시 Ctrl + O로 접는다고 설명합니다.

background로 돌리기

작업이 길어질 때는:

Ctrl + B / Cmd + B로 background 실행이 가능하다고 언급해요.

또한 동시에 여러 Claude Code 세션을 띄워 parallel로 작업할 수도 있다고 스크립트가 말합니다.

Model 선택: Opus / Sonnet / Haiku

비용이 신경 쓰이면 model을 바꾸면 됩니다.

/model

Claude가 idle 상태일 때 이 command를 치면 model 선택 UI가 뜹니다.

스크립트 기준 3가지:

Opus: 가장 강력, 복잡한 작업에 적합, 가장 비쌈
Sonnet: 밸런스형, 대부분의 작업에 무난
Haiku: 빠르고 저렴, 가벼운 작업에 좋음

한마디로 “어려운 일은 Opus, 보통은 Sonnet, 빠르게 툭툭은 Haiku” 같은 감각이죠.

shooter 실행 데모(스크립트 흐름)

plan 실행이 끝나고 나면 shooter 파일을 실행해보는 장면이 나와요.

처음엔 command가 잘못되었는지 “파일을 못 찾는다” 같은 상황이 잠깐 나오지만, 다시 시도해서 browser에서 게임을 띄웁니다.

그 결과:

캐릭터 이동 가능
shoot 가능
wave 형태로 enemies가 몰려옴
health/HUD 같은 UI 요소 존재
menu bar도 보임

화자는 “첫 iteration치고 꽤 괜찮다”고 말하면서, 이후엔 이런 식으로 바로 개선 prompt를 던질 수 있다고 합니다.

“add power ups to this app”

Git & version control: commit/push 자동화

여기서부터는 진짜 실전 감각이에요.

스크립트는 큰 project를 할수록 Claude Code에게 이렇게 지시하라고 권합니다.

새 Git repository 만들기
GitHub repository 생성
clean commit message로 commit
GitHub로 push를 자주 해서 항상 안전하게 저장

화자가 예시로 말하는 뉘앙스는 이런 느낌입니다.

“from now on, make a new git repository for this project. make clean commit messages, save locally, and push to GitHub regularly so we can revert anytime.”

Claude가 필요한 command를 실행하면서 설정을 끝내고, 실제로 GitHub URL을 열어보면 repository가 생성되어 있고 commit들도 올라와 있다고 보여줘요.

(“나랑 Claude가 같이 commit을 쌓고 있다”는 식으로요.)

session은 잊는다—CLAUDE.md로 memory 만들기

여기 진짜 중요합니다.

Claude Code는 session 기반이라서, /exit 하고 새로 claude를 실행하면… 이전 대화 맥락을 그대로 기억하지 않습니다.

물론 codebase나 Git history를 읽어서 어느 정도 추론은 할 수 있지만, “내가 원하는 작업 규칙”까지 자동으로 기억하진 않아요.

그래서 스크립트는 CLAUDE.md를 소개합니다.

CLAUDE.md 생성

/init

이 command를 실행하면 Claude가 프로젝트를 분석해서 CLAUDE.md를 만들어줍니다.

스크립트에서 예시로 들어가는 내용은 대략 이런 항목들이에요.

project overview
실행 방법(run instructions)
development setup
design pattern
color scheme
Git workflow

그리고 여기서 끝이 아니죠. CLAUDE.md는 직접 수정해서 규칙을 심어두는 용도입니다.

예를 들어 스크립트 화자는 이렇게 요청합니다.

“작업할 때마다 regular하게 commit하고 GitHub로 push하라. clean commit message를 써라.”

Claude가 CLAUDE.md를 업데이트하고, 그 다음 session을 새로 열어서:

“what do you know about this project?”

라고 물으면 Claude가 CLAUDE.md를 읽고 프로젝트 정보를 정리해서 답하는 모습을 보여줍니다.

Tasks: web server 같은 long-running 작업

Claude Code에는 background로 돌아가는 tasks 개념이 있습니다.

보기:

/tasks

또는 shortcut:

Ctrl + T

왜 tasks가 필요해요?

web server처럼 계속 돌아가야 하는 command는 terminal을 “붙잡아”버리죠(blocking). Claude가 이걸 감지하고 background task로 돌려줄 수 있습니다.

스크립트 데모에서는 게임을 host하기 위한 web server를 실행하려고 하자, Claude가 bash task를 background로 실행합니다.

/tasks 또는 Ctrl+T로 들어가면:

어떤 task가 실행 중인지
얼마나 오래 돌았는지

확인할 수 있고, 필요하면 task를 kill해서 종료할 수 있다고 설명해요.

그리고 다시 한 번:

실행 중 멈추고 싶으면 Escape

이것도 꼭 기억하라고 합니다.

고급 기능 미리보기: agents, MCP, hooks, skills

스크립트의 마지막은 “더 깊게 파면 이런 것도 있다” 소개 파트입니다.

agents (/agents)

여러 agent를 만들어 역할 분담을 할 수 있어요.

UI/styling 담당 agent
backend 담당 agent

같이 나눠서 병렬로 굴리는 식이죠. 다만 스크립트에서도 “복잡해질 수 있어서 이번 튜토리얼에서는 깊게 다루지 않는다”고 선을 그어요.

MCP (외부 서비스 연결)

MCP server를 붙이면 Claude의 능력이 확장됩니다.

스크립트에서 예로 든 서비스:

Notion
Gmail
Google Drive

그리고 “더 많은 서비스”를 연결할 수 있다고 언급합니다.

hooks / keybinds / memory / skills

hooks: 특정 행동에 자동으로 command 실행
keybinds: 단축키 설정
memory: 설정/관리
skills: 반복 작업 recipe처럼 저장해두고 “이 skill 실행해”라고 시킬 수 있음

즉, 단순히 code generation에서 끝나는 게 아니라, 제대로 세팅하면 workflow 자체를 자동화하는 플랫폼처럼 쓸 수 있다는 메시지예요.

정리: 결국 제일 중요한 건 이거

이 튜토리얼이 말하는 핵심을 한 문장으로 줄이면:

Plan 먼저 잡고, 요구사항은 구체적으로, 작업은 작게 쪼개고, Git으로 언제든 되돌릴 수 있게 하자.

Claude Code는 속도가 너무 빠르기 때문에, safety belt(Git/GitHub, CLAUDE.md)가 있으면 체감 난이도가 확 내려갑니다.

그리고 “뭘 만들지”가 선명할수록 결과물도 선명해져요. 이건 진짜입니다.

FAQ

1) Claude Code를 한 문장으로 설명하면?

terminal에서 AI agent에게 말로 지시하면, 현재 폴더에 code를 만들고 수정해주는 CLI tool이에요.

2) programming을 잘 몰라도 쓸 수 있나요?

스크립트는 “가능하다”고 말해요. 대신 요구사항을 구체적으로 하고, 작은 단위로 요청하는 게 중요합니다.

3) Claude Code는 desktop app인가요?

아니요. shell/terminal 안에서 돌아가는 CLI입니다.

4) 무엇이 있어야 시작할 수 있죠?

Claude subscription(Pro/Max/Teams/Enterprise) 또는 API key + tokens/credits가 필요합니다.

5) Windows 설치 팁이 있나요?

PowerShell에서 docs의 install command를 실행하고, 권한 에러가 나면 PowerShell을 Run as Administrator로 실행하라고 합니다.

6) Mac/Linux는요?

Terminal에서 docs의 curl 기반 install command를 실행하는 흐름으로 설명됩니다.

7) Plan mode와 Ask mode 차이는?

Ask mode는 실행/수정 전에 permission을 자주 묻고, Plan mode는 먼저 plan을 만든 뒤 그 plan대로 진행합니다.

8) mode 전환은 어떻게 해요?

Shift + Tab으로 Plan / Ask / Code를 순환합니다.

9) Opus/Sonnet/Haiku는 어떻게 고르죠?

복잡한 작업은 Opus, 대부분은 Sonnet, 빠르고 저렴하게 툭툭은 Haiku—이런 감각으로 안내합니다.

10) 왜 Git/GitHub를 그렇게 강조하나요?

AI가 빠르게 많은 변경을 만들기 때문에, commit으로 checkpoint를 남기고 필요하면 revert하기 위해서예요. GitHub는 remote backup 역할도 합니다.

11) CLAUDE.md는 정확히 뭐죠?

프로젝트 안에 두는 규칙/설명 문서입니다. 새 session에서도 Claude가 이 파일을 읽고 workflow를 유지하게 도와줘요.

12) tasks는 어떤 상황에 쓰나요?

web server처럼 계속 돌아가는 long-running command를 background로 돌릴 때요. /tasks 또는 Ctrl+T로 확인합니다.

치트시트

claude → Claude Code 실행
/help → 도움말
/commands → command 목록
/model → Opus/Sonnet/Haiku 선택
/init → CLAUDE.md 생성
/tasks → background tasks 목록
/agents → agents 관리
/exit → 세션 종료

Shortcuts:

Shift + Tab → mode 전환(Plan/Ask/Code)
Escape, Escape → 입력창 비우기
Up/Down Arrow → 이전 prompt 불러오기
Alt/Option + Enter → multiline prompt
Ctrl + O → verbose 보기 토글
Ctrl + B / Cmd + B → 작업 background 처리(스크립트에서 언급)
Ctrl + T → tasks 보기(스크립트에서 언급)

저작자표시 (새창열림)

현재글Claude Code Plan mode vs Ask mode vs Code mode 차이: Shift+Tab로 모드 전환하는 법까지