Anthropic Claude Code 완벽 가이드: AI 코딩 어시스턴트의 모든 것

Complete Guide to Anthropic Claude Code: Everything About AI Coding Assistant

2025-12-25 인공지능

Claude Code는 Anthropic에서 개발한 공식 AI 코딩 어시스턴트 CLI(Command Line Interface) ツール입니다. 터미널에서 작동하며 개발자들이 아이디어를 速く 코드로 変換하고, 버그를 修正하고, 코드베이스를 탐색하는 데 혁신적인 도움을 提供します. 이 가이드에서는 Claude Code의 설치부터 고급 機能까지 모든 것을 상세히 다룹니다.

English: Claude Code is the official AI coding assistant CLI tool developed by Anthropic. It operates in the terminal and provides revolutionary assistance to developers in quickly converting ideas into code, fixing bugs, and navigating codebases. This guide covers everything from installation to advanced features of Claude Code in detail.

1. Claude Code란 무엇인가?

1.1 핵심 개념

Claude Code는 에前へ트 기반 아키텍처를 使用하는 터미널 네이티브 AI ツール입니다. 기존의 IDE 플러그인과 달리, Claude Code는 터미널에서 직접 작동하며 파日編集, 명령 실행, Git 커밋 生成 등을 자율적으로 수행할 수 있습니다.

┌─────────────────────────────────────────────────────────┐
│                  Claude Code 아키텍처                      │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   [使用자] ─────────────────────────────── [터미널]      │
│       │                                       │         │
│       ▼                                       ▼         │
│   자연어 명령  ────────────► Claude Code Engine        │
│                                      │                  │
│                    ┌─────────────────┼─────────────────┐│
│                    ▼                 ▼                 ▼│
│               [파日 읽기]      [코드 修正]      [명령 실행]│
│               [検索/分석]      [테스트 작성]    [Git 작업]│
│                                                         │
└─────────────────────────────────────────────────────────┘

1.2 週요 特徴

터미널 네이티브: IDE가 아닌 터미널에서 직접 작동
에前へ트 모드: 자율적으로 작업을 계획하고 실행
파이핑 サポート: Unix 철학에 따라 다른 ツール와 연결 可能
직접 실행: 파日編集, 명령 실행, Git 커밋 生成可能
맥락 인식: 全体 코드베이스를 이해하고 작업

1.3 週요 使用 사례

使用 사례	説明	例 명령
코드 生成	자연어 説明에서 코드 작성	"使用자 인증 API 엔드포인트 生成해줘"
버그 修正	エラー分석 및 자동 修正	"TypeError エラー修正해줘"
리팩토링	코드 품질 개선	"이 함수를 TypeScript로 変換해줘"
테스트 작성	単位 테스트 자동 生成	"이 모듈에 대한 테스트 코드 작성해줘"
문서화	코드 週석 및 README 작성	"이 프로젝트의 README 작성해줘"

2. 설치 및 開始하기

2.1 설치 방법

Claude Code는 여러 가지 방법으로 설치할 수 있습니다:

macOS/Linux/WSL (권장)

# 공식 설치 스크립트
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

# PowerShell에서 실행
irm https://claude.ai/install.ps1 | iex

Homebrew (macOS)

# Homebrew를 통한 설치
brew install --cask claude-code

NPM

# NPM을 통한 설치
npm install -g @anthropic-ai/claude-code

2.2 첫 번째 실행

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

# Claude Code 開始
claude

# 첫 실행 시 로그인 필요
/login

2.3 시스템 요구사항

운영체제: macOS 10.15+, Windows 10+, Linux (Ubuntu 20.04+)
Node.js: 18.0 이상 (NPM 설치 시)
메모리: 最小 4GB RAM 권장
인터넷: 안정적인 인터넷 연결 필요

3. 슬래시 명령어 완벽 가이드

3.1 기본 명령어

Claude Code는 様々な 슬래시 명령어를 提供します:

명령어	説明
`/help`	ヘルプ 표시
`/config`	設定 인터페이스 開く
`/model`	AI 모델 選択 (Sonnet, Opus, Haiku)
`/clear`	대화 히스토리 リセット
`/compact`	대화 압축 (トークン 절약)
`/cost`	トークン使用량 및 비용 통계
`/exit`	Claude Code 종료

3.2 고급 명령어

명령어	説明
`/agents`	서브에前へ트 관리
`/mcp`	MCP 서버 연동 관리
`/memory`	CLAUDE.md 메모리 編集
`/permissions`	권한 관리
`/resume`	前へ 대화 再開
`/hooks`	Hooks 設定
`/sandbox`	샌드박스 모드 활성화
`/doctor`	설치 상태 確認
`/bug`	버그 리포트 제출

3.3 使用자 정의 슬래시 명령어

자신만의 명령어를 만들 수 있습니다:

# 위치: .claude/commands/commit.md

---
argument-hint: [message]
description: 깃 커밋 메시지 生成
---

`git diff HEAD`를 보고 적절한 깃 커밋 메시지를 만들어週세요: $ARGUMENTS

이후 /commit "버그 修正" 형태로 使用할 수 있습니다.

4. 에前へ트 모드와 서브에前へ트

4.1 에前へ트 모드란?

Claude Code의 에前へ트 모드는 자율적으로 작업을 계획하고 실행하는 機能입니다:

┌─────────────────────────────────────────────────────────┐
│                   에前へ트 모드 워크플로우                   │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   [작업 요청] → [分석/계획] → [실행] → [검증] → [完了]    │
│                     │         │         │              │
│                     ▼         ▼         ▼              │
│              코드베이스   파日 修正   테스트 실행         │
│               탐색      명령 실행   結果 確認           │
│                                                         │
└─────────────────────────────────────────────────────────┘

4.2 서브에前へ트 (Sub-agents)

특화된 AI 어시스턴트를 정의하여 使用할 수 있습니다:

# 위치: .claude/agents/code-reviewer.md

---
name: code-reviewer
description: 코드 レビュー 전문가. 코드 변경 후 使用
tools: Read, Grep, Glob, Bash
model: sonnet
---

당신은 시니어 코드 レビュー어입니다. 次へ 원칙을 따라 코드를 レビュー해週세요:
1. 가독성과 유지보수성 確認
2. セキュリティ 취약점 검토
3. 성능 최적화 제안
4. 테스트 커버리지 確認

4.3 내장 서브에前へ트

Plan Agent: 계획 모드에서 코드베이스 연구
Explore Agent: 빠른 코드 탐색 (읽기 전용)
General Purpose Agent: 복잡한 다단계 작업 처리

5. MCP (Model Context Protocol) 서버 연동

5.1 MCP란?

MCP는 외부 ツール와 데이터 소스를 Claude Code에 연결하는 개방형 프로토콜입니다. GitHub, Jira, Slack 등 様々な 서비스와 통합할 수 있습니다.

5.2 MCP 서버 설치

# HTTP 서버 追加
claude mcp add --transport http notion https://mcp.notion.com/mcp

# SSE 서버 追加
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Local Stdio 서버 追加
claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

5.3 MCP 관리 명령어

# 모든 서버 나열
claude mcp list

# 특정 서버 情報 確認
claude mcp get github

# 서버 제거
claude mcp remove github

# 歳션 내에서 관리
/mcp

5.4 人気 있는 MCP 서버

서버	용도
GitHub	保存소, 이슈, PR 관리
Sentry	エラー 모니터링 및 分석
Notion	문서 및 데이터베이스 접근
Jira	프로젝트 관리 및 이슈 추적
PostgreSQL	데이터베이스 쿼리 및 관리
Slack	팀 커뮤니케이션 통합
Google Drive	파日保存 및 共有
Figma	디자인 자산 접근

6. Skills 機能

6.1 Skills란?

Skills는 Claude가 자동으로 발견하고 使用하는 재使用可能한 역량입니다. 특정 작업을 수행하기 ための 지침, 템플릿, 스크립트를 含む할 수 있습니다.

6.2 Skill 구조

my-skill/
├── SKILL.md          # 必須: 스킬 정의
├── reference.md      # 選択: 참조 문서
├── examples.md       # 選択: 使用 はい제
├── scripts/
│   └── helper.py     # 選択: 헬퍼 스크립트
└── templates/
    └── template.txt  # 選択: 템플릿 파日

6.3 SKILL.md 작성

---
name: pdf-processing
description: PDF 파日에서 テキスト 추출, 양식 채우기, PDF 병합. PDF 파日 작업 시 使用
allowed-tools: Read, Grep, Glob
---

# PDF 처리

## 지시사항

1. PyPDF 또는 pdfplumber 라이브러리 使用
2. テキスト 추출 시 레이아웃 유지
3. エラー 처리 含む
4. 처리 結果 보고

6.4 Skills 保存 위치

프로젝트: .claude/skills/skill-name/
개인: ~/.claude/skills/skill-name/

7. Hooks 機能

7.1 Hooks란?

Hooks는 특정 이벤트에서 자동으로 실행되는 커스텀 셸 명령어입니다. 워크플로우 자동화에 매우 유용합니다.

7.2 Hook 이벤트 종류

이벤트	説明	使用 사례
`PreToolUse`	ツール 실행 전	특정 작업 차단
`PostToolUse`	ツール 실행 후	코드 포매팅 자동화
`PermissionRequest`	권한 요청 시	권한 로깅
`UserPromptSubmit`	프롬프트 제출 시	入力 검증
`Notification`	알림 전송 시	외부 알림 연동
`Stop`	응답 完了 시	完了 알림
`SessionStart`	세션 開始 시	환경 リセット
`SessionEnd`	세션 종료 시	정리 작업

7.3 Hooks 設定はい제

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' >> ~/.claude/bash-log.txt"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$file_path\""
          }
        ]
      }
    ]
  }
}

7.4 실제 使用 사례

코드 포매팅: TypeScript/JavaScript 파日保存 시 자동 포매팅
파日 보호: 프로덕션 파日修正 차단
로깅: 모든 bash 명령 기록
린팅: 파日修正 후 자동 린트 실행

8. IDE 통합

8.1 VS Code 확장 프로그램

Claude Code는 VS Code와 완벽하게 통합됩니다:

설치 방법

# VS Code 마켓플레이스에서 설치
1. Cmd+Shift+X (Mac) / Ctrl+Shift+X (Windows/Linux)
2. "Claude Code" 検索
3. Install 클릭

週요 단축키

단축키	機能
`Cmd/Ctrl+Esc`	에디터와 Claude 사이 포커스 전환
`Cmd/Ctrl+Shift+Esc`	새 탭에서 대화 開く
`Alt+K`	@-멘션 파日 참조 삽입

主な機能

인라인 차이점 검토
@-멘션으로 파日 참조
계획 レビュー 인터페이스
여러 탭/창에서 대화

8.2 JetBrains IDE 통합

IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE를 サポート합니다:

サポート IDE

IntelliJ IDEA
PyCharm
WebStorm
GoLand
PhpStorm
Android Studio

설치 방법

Settings → Plugins → Marketplace → "Claude Code" 検索 → Install

主な機能

IDE 내 차이점 보기
選択 컨テキスト 자동 共有
IDE 진단 情報共有
파日 참조 단축키: Cmd/Ctrl+Option/Alt+K

9. 設定 및 구성

9.1 設定 파日 위치

使用자 設定: ~/.claude/settings.json
프로젝트 設定: .claude/settings.json
로컬 設定: .claude/settings.local.json (Git 무시)

9.2 週요 設定 옵션

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)"
    ],
    "additionalDirectories": ["../docs/"],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "production",
    "CUSTOM_VAR": "value"
  },
  "model": "claude-sonnet-4-5-20250929",
  "outputStyle": "Explanatory",
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true
  },
  "attribution": {
    "commit": "Generated with Claude Code",
    "pr": "Generated with Claude Code"
  }
}

9.3 設定 우선순위

Enterprise (최고) - 조직 정책
Command Line - 歳션 임시 設定
Local Project - 개인 프로젝트 設定
Project - 팀 共有設定
User (최저) - 개인 기본 設定

10. セキュリティ 및 권한 관리

10.1 3계층 권한 시스템

ツール 유형	例	승인 필요
읽기 전용	파日 읽기, Grep, Glob	いいえ
Bash 명령	셸 명령 실행	はい
파日修正	파日 쓰기, 編集	はい

10.2 권한 규칙 設定

{
  "permissions": {
    "allow": [
      "Bash(npm run build)",
      "Bash(npm run test:*)",
      "Read(./src/**)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Bash(rm -rf:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

10.3 권한 모드

default: 각 ツール使用 시 권한 요청
acceptEdits: 파日編集 자동 승인
plan: 分석만 可能 (修正 불가)
bypassPermissions: 모든 권한 자동 승인 (注意 필요!)

# 권한 모드 변경
claude --permission-mode plan
claude --permission-mode acceptEdits

10.4 セキュリティ 모범 사례

민감한 파日(.env, credentials.json 등)은 deny 목록에 追加
읽기 전용 Skills에는 allowed-tools: Read, Grep, Glob 제한
정기적으로 /permissions로 권한 검토
프로덕션 환경에서는 샌드박스 모드 활성화

11. CLI 플래그 및 옵션

11.1 기본 使用

# 대화형 모드
claude

# 한 번의 작업 실행
claude "使用자 인증 機能 구현해줘"

# 쿼리 후 종료
claude -p "이 프로젝트의 구조 説明해줘"

11.2 歳션 관리

# 가장 최근 대화 계속
claude -c

# 특정 歳션 再開
claude -r "session-name"

11.3 모델 및 권한

# 특정 모델 使用
claude --model opus
claude --model sonnet
claude --model haiku

# 권한 모드 設定
claude --permission-mode plan
claude --dangerously-skip-permissions

11.4 追加設定

# 追加 디렉토리 접근
claude --add-dir ../docs

# 시스템 프롬프트 追加
claude --append-system-prompt "Always use TypeScript"

# 에前へ트 設定
claude --agents '{"reviewer":{"description":"...","prompt":"..."}}'

12. 키보드 단축키

단축키	機能
`Ctrl+C`	入力/生成キャンセル
`Ctrl+D`	세션 종료
`Ctrl+L`	화면 지우기
`Ctrl+O`	상세 出力 토글
`Ctrl+R`	역순 히스토리 検索
`Esc` + `Esc`	변경 사항 되돌리기
`?`	단축키 ヘルプ
`Up/Down`	명령 히스토리 이동

13. 실전 워크플로우 例

13.1 새 機能 개발

claude
> 使用자 프로필 API 엔드포인트 生成해줘
> 데이터베이스 마이그레이션 작성해줘
> 테스트 코드 追加해줘
> 커밋 生成해줘

13.2 버그 修正

claude
> エラー: TypeError: Cannot read property 'name' of undefined at line 45
> 버그 分석하고 修正해줘
> 테스트 실행해서 確認해줘

13.3 코드 리팩토링

claude
/agents
> 코드 レビュー어 에前へ트로 src/utils 폴더 검토해줘
> 권장 사항 적용해줘

14. 결론 및 권장사항

Claude Code는 개발자의 생산성을 혁신적으로 향상시키는 AI 코딩 어시스턴트입니다. 터미널 네이티브 환경에서 자율적으로 작업을 수행하고, MCP를 を通じて様々な 외부 서비스와 통합할 수 있습니다.

핵심 활용 팁

Skills 활용: 반복적인 작업은 Skills로 자동화하세요
Hooks 設定: 코드 포매팅, 린팅 등을 자동화하세요
MCP 연동: GitHub, Jira 등 필요한 서비스를 연결하세요
セキュリティ設定: 민감한 파日은 반드시 deny 목록에 追加하세요
IDE 통합: VS Code나 JetBrains IDE와 함께 使用하면 더욱 강력합니다

Claude Code를 を通じて 더 빠르고 효율적인 개발 경험을 開始해보세요!

English: Claude Code is an AI coding assistant that revolutionizes developer productivity. It operates autonomously in terminal-native environments and can integrate with various external services through MCP. Leverage Skills for automation, set up Hooks for code formatting, connect necessary services via MCP, and always add sensitive files to the deny list for security. Start your faster, more efficient development experience with Claude Code!

목록으로 돌아가기

Anthropic Claude Code 완벽 가이드: AI 코딩 어시스턴트의 모든 것

Complete Guide to Anthropic Claude Code: Everything About AI Coding Assistant

1. Claude Code란 무엇인가?

1.1 핵심 개념

1.2 週요 特徴

1.3 週요 使用 사례

2. 설치 및 開始하기

2.1 설치 방법

macOS/Linux/WSL (권장)

Windows PowerShell

Homebrew (macOS)

NPM

2.2 첫 번째 실행

2.3 시스템 요구사항

3. 슬래시 명령어 완벽 가이드

3.1 기본 명령어

3.2 고급 명령어

3.3 使用자 정의 슬래시 명령어

4. 에前へ트 모드와 서브에前へ트

4.1 에前へ트 모드란?

4.2 서브에前へ트 (Sub-agents)

4.3 내장 서브에前へ트

5. MCP (Model Context Protocol) 서버 연동

5.1 MCP란?

5.2 MCP 서버 설치

5.3 MCP 관리 명령어

5.4 人気 있는 MCP 서버

6. Skills 機能

6.1 Skills란?

6.2 Skill 구조

6.3 SKILL.md 작성

6.4 Skills 保存 위치

7. Hooks 機能

7.1 Hooks란?

7.2 Hook 이벤트 종류

7.3 Hooks 設定 はい제

7.4 실제 使用 사례

8. IDE 통합

8.1 VS Code 확장 프로그램

설치 방법

週요 단축키

主な機能

8.2 JetBrains IDE 통합

サポート IDE

설치 방법

主な機能

9. 設定 및 구성

9.1 設定 파日 위치

9.2 週요 設定 옵션

9.3 設定 우선순위

10. セキュリティ 및 권한 관리

10.1 3계층 권한 시스템

10.2 권한 규칙 設定

10.3 권한 모드

10.4 セキュリティ 모범 사례

11. CLI 플래그 및 옵션

11.1 기본 使用

11.2 歳션 관리

11.3 모델 및 권한

11.4 追加 設定

12. 키보드 단축키

13. 실전 워크플로우 例

13.1 새 機能 개발

13.2 버그 修正

13.3 코드 리팩토링

14. 결론 및 권장사항

핵심 활용 팁

이 글 共有する

7.3 Hooks 設定はい제

11.4 追加設定