Claude Code 튜토리얼 — 첫 세션, CLAUDE.md, 계획 모드, 권한 (2026)

1. 프로젝트를 열고 메모리 파일 작성하기

cd your-project
claude
/init

/init 는 저장소를 살펴보고 CLAUDE.md 초안을 작성합니다. 빌드 방법, 테스트 방법, 규칙, 건드리지 말아야 할 항목이 포함됩니다. 이 파일을 수정하세요. 이후 모든 세션이 이 파일을 먼저 읽으므로 하루 만에 투자한 노력이 보상됩니다. 에이전트가 매번 프로젝트를 처음부터 다시 파악하지 않게 됩니다.

2. 계획 모드: 변경이 아닌 계획 요청하기

Claude Code에는 계획 모드가 내장되어 있습니다. Shift+Tab을 눌러 권한 모드가 plan으로 표시될 때까지 전환하거나, 다음으로 시작하세요: claude --permission-mode plan. 그러면 다시 전환하기 전까지 에이전트는 읽고 생각할 수 있지만 수정하거나 실행할 수는 없습니다. 익숙하지 않은 코드베이스를 탐색하는 가장 안전한 방법이자, 큰 변경을 시작하는 가장 저렴한 방법입니다.

> Plan how to add rate limiting to the /api/upload route. Don't edit anything yet.

계획을 읽고, 일상적인 언어로 수정 사항을 알려주세요. 그런 다음: go ahead. 계획한 뒤 실행하면 에이전트가 수정하면서 탐색하게 하는 것보다 변경 품질이 좋아지고 세션 비용도 줄어듭니다.

3. 테스트 실행시키기

테스트 실행 방법을 알려주거나 CLAUDE.md에 명시하고, 변경 후 테스트를 실행하도록 요청하세요. 수정, 테스트, 실패 내용 확인, 해결로 이어지는 반복 과정은 에이전트가 가장 잘하는 작업입니다. 권한 요청을 주의 깊게 살펴보세요. 각각은 에이전트가 할 수 있는 작업의 범위를 제한할 기회입니다.

4. 권한

/permissions

읽기와 수정은 자유롭게 허용하고, 안전한 특정 명령은 허용하세요(Bash(npm test), Bash(git diff *)). 파괴적인 작업은 항상 승인을 요청하도록 유지하세요. 스크립트에서는 다음을 사용해 동일한 권한 구성을 지정하세요: --allowedTools.

5. 주제가 바뀌면 압축하기

/compact focus on the rate limiter; drop the earlier exploration

컨텍스트는 비용입니다. 매 턴마다 지금까지의 모든 내용이 다시 전송됩니다. 방향이 바뀔 때마다 컨텍스트를 압축하고, /clear 을 서로 관련 없는 작업 사이에 사용하세요. 이 습관 하나로 대부분의 사용자는 요금을 절반으로 줄일 수 있습니다.

6. 단계별로 모델 선택하기

기본적으로 Sonnet 등급을 사용하세요. 정말 어려운 결정을 내려야 할 때만, /model 을 사용해 Opus로 전환하고, 결정을 내린 뒤 다시 돌아오세요. 모델 가이드에서는 등급과 특정 모델을 고정하는 방법을 설명합니다.

7. 커밋하고 검토하기

> Commit this as a single change with a message that explains the rate limit values.

에이전트에게 커밋하게 한 다음 diff를 직접 읽어보세요. 에이전트는 CLAUDE.md를 매우 잘 기억하는 빠르고 지치지 않는 주니어 엔지니어입니다. 주니어 엔지니어의 결과물을 검토하듯 에이전트의 결과물도 검토하세요.

다음 단계

스킬 — 팀의 절차를 한 번 가르쳐 두세요.
하위 에이전트(/agents) — 대규모 작업을 전문 에이전트들에게 나누어 맡기세요.
MCP 서버(/mcp) — 데이터베이스, 브라우저, 티켓 추적 도구에 접근할 수 있게 하세요.
GitHub Action — 모든 풀 리퀘스트에 동일한 반복 과정을 적용하세요.
요금 — 정액제 요금제로 사용량 계량기를 더 이상 신경 쓰지 않는 방법도 알아보세요.

먼저 무료로 사용해 보세요

신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

코드 CLAUDECODE로 계정 만들기

자주 묻는 질문

CLAUDE.md란 무엇인가요?

Claude Code가 매 세션 시작 시 읽는 프로젝트 메모리 파일입니다. 빌드 및 테스트 명령, 규칙, 작업 범위 제한을 담습니다. /init이 초안을 작성하고, 사용자가 최신 상태로 유지합니다.

Claude Code의 계획 모드란 무엇인가요?

수정 없이 계획을 요청하고, 승인한 뒤 실행하는 방식입니다. 탐색하면서 수정하는 방식보다 변경 품질이 좋고 세션도 짧아지며 비용도 줄어듭니다.

Claude Code가 매번 권한을 요청하지 않게 하려면 어떻게 해야 하나요?

/permissions로 안전한 도구와 명령을 사전 승인하거나, 스크립트에서 --allowedTools를 사용하세요. 파괴적인 명령은 항상 승인을 요청하도록 유지하세요.

게이트웨이에서 Claude Code 실행하기

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.

API 키 발급받기 무제한 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

Claude Code 튜토리얼: 첫 실전 세션

TLDR