클로드 코드 사용법: Claude Code 첫 세션부터 권한·CLAUDE.md·MCP까지

클로드 코드(Claude Code) 사용법의 기본은 프로젝트 폴더에서 claude를 실행하고 하고 싶은 일을 말로 적는 것입니다. 그러면 Claude가 파일을 읽고 고치고 명령을 실행한 뒤 결과를 보여 줍니다. 사용자는 바뀐 내용을 확인해 받아들이거나 되돌리면 됩니다. 처음에는 작은 수정 하나를 맡기고 확인하는 한 바퀴를 돌려 보면 나머지 기능이 왜 필요한지 차례로 보입니다.

이 글은 설치 다음에 익힐 것을 순서대로 묶은 입문 지도입니다. 단계마다 꼭 필요한 명령과 판단 기준만 적고 깊은 내용은 따로 쓴 글과 용어 가이드로 연결했습니다. 명령과 기본값은 2026년 10월 16일 Claude Code 공식 문서 기준입니다.

한눈에 보는 순서

1. 설치하고 첫 세션 열기

설치는 Windows PowerShell이면 irm https://claude.ai/install.ps1 | iex, Mac·Linux면 curl -fsSL https://claude.ai/install.sh | bash 한 줄입니다. 명령의 뜻과 오류 해결은 클로드 코드 설치 방법에 있습니다. 무료 플랜에는 Claude Code가 없고 Pro 이상 구독이나 Console(API) 계정, 또는 Amazon Bedrock 같은 지원 클라우드 계정이 필요합니다.

설치가 끝나면 작업할 폴더로 이동해서 실행합니다. Claude Code는 실행한 폴더를 작업 범위로 삼습니다. 하위 폴더에서 열어도 되지만 처음에는 프로젝트 맨 위 폴더에서 여는 편이 헷갈리지 않습니다.

cd ~/my-project
claude

처음 실행하면 브라우저 로그인이 뜨고 로그인 후 입력창 위에 버전·현재 모델·작업 폴더가 표시됩니다. 첫 질문은 프로젝트를 이해하는 데 씁니다. 무엇이 어디 있는지 알아야 나중에 수정 결과도 확인할 수 있거든요.

이 프로젝트가 무엇을 하는지, 폴더 구조와 시작 파일을 설명해 줘

다음 날 이어서 작업할 때는 같은 폴더에서 claude -c(가장 최근 대화 이어가기) 또는 claude -r(목록에서 골라 이어가기)을 씁니다. 종료는 /exit이나 빈 입력창에서 Ctrl+D 두 번입니다.

터미널이 낯설다면 클로드 데스크탑(Claude Desktop) 앱의 Code 탭으로 시작해도 됩니다. 앱 설치와 Code 탭 여는 법은 클로드 데스크탑 설치와 사용법에 있습니다.

연습용 지시가 필요하면 첫 세션 샘플 프롬프트를 그대로 써도 됩니다. 연습을 위해 만든 예시입니다.

2. 기본 조작: 단축키와 슬래시 명령

입력창에서 쓰는 기호와 단축키는 몇 개만 알면 됩니다.

필요한 파일을 @로 지정해 주면 Claude가 폴더 전체를 뒤지는 시간이 줄어듭니다. 공식 퀵스타트는 "Claude Code가 필요한 파일을 알아서 읽으니 직접 맥락을 넣지 않아도 된다"고 하지만 고칠 위치를 알고 있다면 알려 주는 편이 빠릅니다.

슬래시 명령은 /를 치면 목록이 뜹니다. 처음 몇 주 동안 쓰는 건 이 정도입니다.

명령 이름이 낯설다면 슬래시 명령 뜻과 쓰는 법에 개념부터 정리해 두었습니다.

3. 권한(승인) 모드: 어디까지 묻지 않고 할지

권한 모드는 Claude가 파일 수정이나 명령 실행을 사용자에게 묻지 않고 어디까지 진행할지 정하는 설정입니다. 입력창 아래 상태 표시줄에 지금 모드가 보이고 Shift+Tab을 누를 때마다 바뀝니다.

Claude Code v2.1.283부터 대화형으로 여는 터미널·VS Code 세션은 따로 정하지 않으면 Auto 모드로 시작합니다(Auto를 쓸 수 없는 조건이면 Manual). 공식 문서는 Auto 모드가 확인 창을 줄여 줄 뿐 안전을 보장하지 않는다고 경고합니다. 그래서 이 글은 처음 며칠은 Manual로 시작해 Claude가 무엇을 하려는지 하나씩 보며 익히기를 권합니다. 공식 문서가 Manual 시작을 권한 것은 아니고, 이 경고를 근거로 한 이 글의 판단입니다. Manual로 여는 명령은 이렇습니다.

claude --permission-mode manual

항상 Manual로 시작하고 싶다면 ~/.claude/settings.json에 아래처럼 적습니다.

{
  "permissions": {
    "defaultMode": "default"
  }
}

여러 파일이 함께 바뀌는 기능은 Plan 모드로 계획부터 받습니다. 입력 앞에 /plan을 붙이거나 Shift+Tab으로 Plan에 두면 Claude가 코드를 읽고 계획을 내놓은 뒤 승인할 때까지 소스를 고치지 않습니다. 계획을 보면 바꿀 범위를 미리 알 수 있고 의도가 다르게 전달됐을 때 일찍 바로잡을 수 있습니다. 문구 하나 고치는 정도라면 바로 맡겨도 됩니다.

권한 모드라는 개념은 권한 모드 뜻에 따로 정리했습니다.

4. CLAUDE.md로 규칙 남기기

새 대화를 열 때마다 같은 설명을 반복하고 있다면 CLAUDE.md에 적을 때입니다. CLAUDE.md는 Claude Code가 세션을 시작할 때마다 읽는 규칙 파일이고 프로젝트 맨 위 폴더(./CLAUDE.md 또는 ./.claude/CLAUDE.md)에 둡니다. 모든 프로젝트에 적용할 개인 취향은 ~/.claude/CLAUDE.md에 둡니다.

시작은 /init입니다. Claude가 코드를 훑어보고 빌드 명령·테스트 방법·관례를 담은 초안을 만듭니다. 그다음 Claude가 스스로 알아낼 수 없는 것만 덧붙입니다.

• 빌드·테스트·실행 명령
• 도구가 못 잡는 코드 스타일
• 건드리면 안 되는 폴더
• 두 번 이상 틀린 부분에 대한 지시

공식 문서는 파일 하나를 200줄 아래로 두라고 권합니다. 길수록 컨텍스트를 차지하고 오히려 덜 따르기 때문입니다. 제대로 불러왔는지는 /context의 Memory files 목록에서 확인합니다. 저장소에 이미 AGENTS.md가 있고 프로젝트 쪽 CLAUDE.md가 없으면 v2.1.277부터는 AGENTS.md를 대신 읽습니다.

작은 예: 메모 정리 프로젝트

아래는 연습용 샘플입니다. 실제 팀 규칙이 아닙니다.

# 메모 정리

- 입력은 public/samples/meeting-notes-before.txt 만 사용한다
- 결과는 결정 사항 / 할 일 / 확인이 필요한 사실 세 섹션으로 나눈다
- 출처 없는 숫자는 외부에 쓰지 말라고 표시한다
- 결제·인증 코드를 만들지 않는다

이 규칙으로 정리한 기대 결과는 meeting-notes-after.md와 같은 골격입니다. 넣을 것·뺄 것 체크리스트와 복사해 쓰는 템플릿은 CLAUDE.md 작성법에, 개념은 에이전트 메모리 파일 뜻에 있습니다.

5. 컨텍스트 관리와 되돌리기

컨텍스트는 Claude가 지금 한 번에 보고 있는 대화·파일·규칙의 양입니다. 이전 작업 기록이 계속 쌓이면 지금 일과 관계없는 내용까지 매번 함께 읽게 되고 사용량도 빨리 줄어듭니다. 습관은 세 가지면 됩니다.

• 작업이 바뀌면 /clear. 공식 비용 문서가 컨텍스트 관리에서 첫 번째로 꼽는 습관입니다. 이전 대화는 /resume으로 다시 열 수 있습니다.
• 한 작업이 길어지면 /compact. /compact 결제 버그 수정에 집중처럼 무엇을 남길지 적어 주면 요약이 그 방향으로 됩니다. 한도에 가까워지면 자동으로도 요약합니다.
• 지금 상태는 /context로 확인. 어떤 항목이 공간을 많이 차지하는지 보여 줍니다.

되돌리기는 두 겹으로 준비합니다. Claude Code는 새 요청을 보낼 때마다 체크포인트를 남기고 Esc 두 번이나 /rewind로 코드·대화를 그 시점으로 돌릴 수 있습니다. 다만 체크포인트는 Claude가 셸 명령으로 바꾼 파일을 추적하지 않고 서브에이전트가 고친 파일도 대부분 되돌리지 못합니다. 공식 문서도 체크포인트가 버전 관리를 대신하지 않는다고 적어 두었으니 작업 단위마다 git 커밋을 남깁니다.

• 작업 전에 작업 트리를 깨끗하게 둡니다
• 작업 하나가 끝나면 커밋합니다(Claude에게 "변경 내용 설명을 붙여 커밋해 줘"라고 해도 됩니다)
• 원하지 않은 변경은 /diff로 확인한 뒤 필요한 파일만 되돌립니다

용어가 낯설다면 컨텍스트 윈도우, 컨텍스트 압축, 체크포인트·되돌리기, git 커밋 순서로 읽으면 됩니다. 사용량을 줄이는 습관은 Claude Code 비용 줄이는 7가지에 모았습니다.

6. MCP·스킬·서브에이전트: 필요할 때 하나씩

처음부터 전부 설정할 필요는 없습니다. 공식 문서도 "같은 실수가 두 번 나오면 CLAUDE.md, 같은 프롬프트를 반복하면 스킬"처럼 신호가 보일 때 하나씩 붙이라고 안내합니다.

MCP는 이렇게 한 줄로 붙이고 /mcp에서 연결 상태와 로그인을 확인합니다.

claude mcp add --transport http notion https://mcp.notion.com/mcp

예전의 .claude/commands/이름.md 사용자 명령은 스킬로 합쳐졌고 기존 파일도 그대로 /이름으로 동작합니다. 셋의 차이는 MCP와 Skills 차이, 붙일 만한 서버와 최소 설정은 MCP 서버 추천 5개, 긴 작업을 스킬로 나누는 기준은 긴 작업을 스킬로 쪼개기에 있습니다. MCP 개념부터 보려면 MCP 뜻을 읽으세요.

7. 모델과 비용 고르기

2026년 10월 16일 공식 문서 기준으로 Pro·Max·Team·Enterprise와 API 계정의 기본 모델은 Opus 5.5이고 Opus 5.5의 생각 깊이(effort) 기본값은 medium입니다. 바꾸는 방법은 두 가지입니다.

• /model: 모델 고르기. opus, sonnet, haiku, fable 같은 별칭을 쓸 수 있고 고른 모델은 다음 세션의 기본값이 됩니다(선택창에서 s를 누르면 이번 세션에만 적용).
• /effort: low부터 max까지. 범위가 분명한 일상 작업은 medium, 기존 코드의 버그처럼 확인이 중요한 일은 high가 공식 문서의 안내입니다.

저는 2026년 9월 25일부터 모든 작업을 Opus 5.5 하나로 돌리고 있습니다. 그때 effort를 어떻게 정했는지는 Opus 5.5 effort 설정과 프롬프트에 적었습니다. 모델별 차이와 고르는 기준은 클로드 모델 고르는 법, 작고 싼 모델을 서브에이전트에 쓰는 설정은 Haiku 5.5 쓰임새에 있습니다.

비용은 /usage로 봅니다. 구독자에게는 플랜 한도 막대와 무엇이 한도를 썼는지가 나옵니다. 세션 금액 숫자는 API 사용자를 위한 추정치라 구독 청구서와 관계없습니다. 요금제 비교는 클로드 요금제 비교에 있습니다.

잘 되는 지시와 안 되는 지시

공식 모범 사례 문서가 첫 실천 항목으로 꼽는 건 Claude가 스스로 확인할 방법을 함께 주는 것입니다. 테스트, 빌드 결과, 비교할 스크린샷처럼 통과·실패를 알려 주는 기준이 있으면 Claude가 직접 돌려 보고 고칩니다.

파일 경로, 기대 결과, 제약 조건, 확인 방법을 같이 적습니다. 어떻게 적을지 막막하면 프롬프트 작성 구조로 목표와 조건부터 정리해 보세요.

자주 묻는 질문

코딩을 모르는데 쓸 수 있나요?

시작할 수 있습니다. 공식 터미널 안내도 코딩을 몰라도 원하는 것을 말로 설명하면 된다고 적고 있습니다. 실행 결과를 보고 기대와 다른 부분을 설명하는 것부터 해 보세요. 용어가 낯설다면 바이브 코딩이란을 먼저 읽어도 좋습니다.

터미널과 데스크톱 앱, VS Code 중 어디서 써야 하나요?

공식 문서에 따르면 터미널·VS Code·데스크톱·웹 어디서 쓰든 같은 Claude Code 엔진에 연결되고 CLAUDE.md·설정·MCP 서버도 똑같이 적용됩니다. 바뀐 파일을 화면으로 보며 시작하고 싶다면 데스크톱 앱의 Code 탭, 반복 작업을 스크립트로 돌리거나 서버에서 쓰려면 터미널이 맞습니다. 비교는 Desktop Code 탭 vs 터미널 CLI에 있습니다.

Cursor나 Codex와 무엇이 다른가요?

Cursor는 편집기 안에서 코드를 보며 고치는 데 강하고 Claude Code는 작업 전체를 맡기는 데 강합니다. 코덱스(Codex)는 OpenAI가 만든 같은 종류의 코딩 에이전트로 ChatGPT 구독으로 씁니다. 비교는 Cursor vs Claude Code와 클로드 코드 vs 코덱스에 있습니다.

실수로 파일을 지우면요?

이 대화에서 Claude가 파일 편집 도구로 바꾼 내용은 /rewind로 되돌릴 수 있습니다. 셸 명령으로 지운 파일이나 서브에이전트가 고친 파일은 체크포인트로 복원되지 않을 수 있으니 git으로 되돌립니다. git이 추적 중인 파일의 커밋하지 않은 변경은 git restore로 되돌릴 수 있지만 한 번도 커밋하지 않은 새 파일은 복구되지 않습니다. 중요한 폴더라면 작업 전에 커밋이나 백업을 남겨 두세요.

다음 단계

• CLAUDE.md 작성법
• MCP와 Skills 차이
• 글 읽는 순서 전체는 Claude Code 시작하기, 강의 안내는 홈과 수강료

출처와 확인 (2026-10-16)

• Overview(모든 화면이 같은 엔진·설정 공유)
• Quickstart(첫 세션, claude -c·-r, /exit)
• Interactive mode(단축키, !·@, /btw)
• Commands(슬래시 명령 전체)
• Permission modes(모드별 동작, v2.1.283 Auto 시작, defaultMode)
• Memory(CLAUDE.md 위치, /init, 200줄, AGENTS.md)
• Context window(자동 요약, /compact·/clear·/context)
• Checkpointing(되돌리기와 한계)
• Extend Claude Code(기능을 붙이는 순서)
• MCP, Skills, Subagents
• Model configuration(기본 모델·effort 기본값과 레벨 안내)
• Costs(/usage)
• Best practices(확인 방법을 함께 주기)
• Terminal guide
• 샘플 프롬프트