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) Tool입니다. 터미널에서 작동하며 개발자들이 아이디어를 Quickly 코드로 Convert하고, 버그를 Edit하고, 코드베이스를 탐색하는 데 혁신적인 도움을 provides. 이 가이드에서는 Claude Code의 설치부터 고급 Feature까지 모든 것을 상세히 다룹니다.

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는 에Previous트 기반 아키텍처를 Use하는 터미널 네이티브 AI Tool입니다. 기존의 IDE 플러그인과 달리, Claude Code는 터미널에서 직접 작동하며 파Day Edit, 명령 실행, Git 커밋 Generate 등을 자율적으로 수행할 수 있습니다.

┌─────────────────────────────────────────────────────────┐
│                  Claude Code 아키텍처                      │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   [Use자] ─────────────────────────────── [터미널]      │
│       │                                       │         │
│       ▼                                       ▼         │
│   자연어 명령  ────────────► Claude Code Engine        │
│                                      │                  │
│                    ┌─────────────────┼─────────────────┐│
│                    ▼                 ▼                 ▼│
│               [파Day 읽기]      [코드 Edit]      [명령 실행]│
│               [Search/Minutes석]      [테스트 작성]    [Git 작업]│
│                                                         │
└─────────────────────────────────────────────────────────┘

1.2 Week요 Features

터미널 네이티브: IDE가 아닌 터미널에서 직접 작동
에Previous트 모드: 자율적으로 작업을 계획하고 실행
파이핑 Support: Unix 철학에 따라 다른 Tool와 연결 Available
직접 실행: 파Day Edit, 명령 실행, Git 커밋 Generate Available
맥락 인식: All 코드베이스를 이해하고 작업

1.3 Week요 Use 사례

Use 사례	Description	Example 명령
코드 Generate	자연어 Description에서 코드 작성	"Use자 인증 API 엔드포인트 Generate해줘"
버그 Edit	Error Minutes석 및 자동 Edit	"TypeError Error Edit해줘"
리팩토링	코드 품질 개선	"이 함수를 TypeScript로 Convert해줘"
테스트 작성	Unit 테스트 자동 Generate	"이 모듈에 대한 테스트 코드 작성해줘"
문서화	코드 Week석 및 README 작성	"이 프로젝트의 README 작성해줘"

2. 설치 및 Start하기

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 Start
claude

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

2.3 시스템 요구사항

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

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

3.1 기본 명령어

Claude Code는 Various 슬래시 명령어를 provides:

명령어	Description
`/help`	Help 표시
`/config`	Settings 인터페이스 Open
`/model`	AI 모델 Select (Sonnet, Opus, Haiku)
`/clear`	대화 히스토리 Reset
`/compact`	대화 압축 (Token 절약)
`/cost`	Token Use량 및 비용 통계
`/exit`	Claude Code 종료

3.2 고급 명령어

명령어	Description
`/agents`	서브에Previous트 관리
`/mcp`	MCP 서버 연동 관리
`/memory`	CLAUDE.md 메모리 Edit
`/permissions`	권한 관리
`/resume`	Previous 대화 Resume
`/hooks`	Hooks Settings
`/sandbox`	샌드박스 모드 활성화
`/doctor`	설치 상태 Check
`/bug`	버그 리포트 제출

3.3 Use자 정의 슬래시 명령어

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

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

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

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

이후 /commit "버그 Edit" 형태로 Use할 수 있습니다.

4. 에Previous트 모드와 서브에Previous트

4.1 에Previous트 모드란?

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

┌─────────────────────────────────────────────────────────┐
│                   에Previous트 모드 워크플로우                   │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   [작업 요청] → [Minutes석/계획] → [실행] → [검증] → [Complete]    │
│                     │         │         │              │
│                     ▼         ▼         ▼              │
│              코드베이스   파Day Edit   테스트 실행         │
│               탐색      명령 실행   Result Check           │
│                                                         │
└─────────────────────────────────────────────────────────┘

4.2 서브에Previous트 (Sub-agents)

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

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

---
name: code-reviewer
description: 코드 Review 전문가. 코드 변경 후 Use
tools: Read, Grep, Glob, Bash
model: sonnet
---

당신은 시니어 코드 Review어입니다. Next 원칙을 따라 코드를 Review해Week세요:
1. 가독성과 유지보수성 Check
2. Security 취약점 검토
3. 성능 최적화 제안
4. 테스트 커버리지 Check

4.3 내장 서브에Previous트

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

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

5.1 MCP란?

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

5.2 MCP 서버 설치

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

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

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

5.3 MCP 관리 명령어

# 모든 서버 나열
claude mcp list

# 특정 서버 Info Check
claude mcp get github

# 서버 제거
claude mcp remove github

# years old션 내에서 관리
/mcp

5.4 Popular 있는 MCP 서버

서버	용도
GitHub	Save소, 이슈, PR 관리
Sentry	Error 모니터링 및 Minutes석
Notion	문서 및 데이터베이스 접근
Jira	프로젝트 관리 및 이슈 추적
PostgreSQL	데이터베이스 쿼리 및 관리
Slack	팀 커뮤니케이션 통합
Google Drive	파Day Save 및 Share
Figma	디자인 자산 접근

6. Skills Feature

6.1 Skills란?

Skills는 Claude가 자동으로 발견하고 Use하는 재Use Available한 역량입니다. 특정 작업을 수행하기 for 지침, 템플릿, 스크립트를 Include할 수 있습니다.

6.2 Skill 구조

my-skill/
├── SKILL.md          # Required: 스킬 정의
├── reference.md      # Select: 참조 문서
├── examples.md       # Select: Use Yes제
├── scripts/
│   └── helper.py     # Select: 헬퍼 스크립트
└── templates/
    └── template.txt  # Select: 템플릿 파Day

6.3 SKILL.md 작성

---
name: pdf-processing
description: PDF 파Day에서 Text 추출, 양식 채우기, PDF 병합. PDF 파Day 작업 시 Use
allowed-tools: Read, Grep, Glob
---

# PDF 처리

## 지시사항

1. PyPDF 또는 pdfplumber 라이브러리 Use
2. Text 추출 시 레이아웃 유지
3. Error 처리 Include
4. 처리 Result 보고

6.4 Skills Save 위치

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

7. Hooks Feature

7.1 Hooks란?

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

7.2 Hook 이벤트 종류

이벤트	Description	Use 사례
`PreToolUse`	Tool 실행 전	특정 작업 차단
`PostToolUse`	Tool 실행 후	코드 포매팅 자동화
`PermissionRequest`	권한 요청 시	권한 로깅
`UserPromptSubmit`	프롬프트 제출 시	Input 검증
`Notification`	알림 전송 시	외부 알림 연동
`Stop`	응답 Complete 시	Complete 알림
`SessionStart`	세션 Start 시	환경 Reset
`SessionEnd`	세션 종료 시	정리 작업

7.3 Hooks Settings Yes제

{
  "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 실제 Use 사례

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

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" Search
3. Install 클릭

Week요 단축키

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

Key Features

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

8.2 JetBrains IDE 통합

IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE를 Support합니다:

Support IDE

IntelliJ IDEA
PyCharm
WebStorm
GoLand
PhpStorm
Android Studio

설치 방법

Settings → Plugins → Marketplace → "Claude Code" Search → Install

Key Features

IDE 내 차이점 보기
Select 컨Text 자동 Share
IDE 진단 Info Share
파Day 참조 단축키: Cmd/Ctrl+Option/Alt+K

9. Settings 및 구성

9.1 Settings 파Day 위치

Use자 Settings: ~/.claude/settings.json
프로젝트 Settings: .claude/settings.json
로컬 Settings: .claude/settings.local.json (Git 무시)

9.2 Week요 Settings 옵션

{
  "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 Settings 우선순위

Enterprise (최고) - 조직 정책
Command Line - years old션 임시 Settings
Local Project - 개인 프로젝트 Settings
Project - 팀 Share Settings
User (최저) - 개인 기본 Settings

10. Security 및 권한 관리

10.1 3계층 권한 시스템

Tool 유형	Example	승인 필요
읽기 전용	파Day 읽기, Grep, Glob	No
Bash 명령	셸 명령 실행	Yes
파Day Edit	파Day 쓰기, Edit	Yes

10.2 권한 규칙 Settings

{
  "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: 각 Tool Use 시 권한 요청
acceptEdits: 파Day Edit 자동 승인
plan: Minutes석만 Available (Edit 불가)
bypassPermissions: 모든 권한 자동 승인 (Caution 필요!)

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

10.4 Security 모범 사례

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

11. CLI 플래그 및 옵션

11.1 기본 Use

# 대화형 모드
claude

# 한 번의 작업 실행
claude "Use자 인증 Feature 구현해줘"

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

11.2 years old션 관리

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

# 특정 years old션 Resume
claude -r "session-name"

11.3 모델 및 권한

# 특정 모델 Use
claude --model opus
claude --model sonnet
claude --model haiku

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

11.4 Add Settings

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

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

# 에Previous트 Settings
claude --agents '{"reviewer":{"description":"...","prompt":"..."}}'

12. 키보드 단축키

단축키	Feature
`Ctrl+C`	Input/Generate Cancel
`Ctrl+D`	세션 종료
`Ctrl+L`	화면 지우기
`Ctrl+O`	상세 Output 토글
`Ctrl+R`	역순 히스토리 Search
`Esc` + `Esc`	변경 사항 되돌리기
`?`	단축키 Help
`Up/Down`	명령 히스토리 이동

13. 실전 워크플로우 Example

13.1 새 Feature 개발

claude
> Use자 프로필 API 엔드포인트 Generate해줘
> 데이터베이스 마이그레이션 작성해줘
> 테스트 코드 Add해줘
> 커밋 Generate해줘

13.2 버그 Edit

claude
> Error: TypeError: Cannot read property 'name' of undefined at line 45
> 버그 Minutes석하고 Edit해줘
> 테스트 실행해서 Check해줘

13.3 코드 리팩토링

claude
/agents
> 코드 Review어 에Previous트로 src/utils 폴더 검토해줘
> 권장 사항 적용해줘

14. 결론 및 권장사항

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

핵심 활용 팁

Skills 활용: 반복적인 작업은 Skills로 자동화하세요
Hooks Settings: 코드 포매팅, 린팅 등을 자동화하세요
MCP 연동: GitHub, Jira 등 필요한 서비스를 연결하세요
Security Settings: 민감한 파Day은 반드시 deny 목록에 Add하세요
IDE 통합: VS Code나 JetBrains IDE와 함께 Use하면 더욱 강력합니다

Claude Code를 through 더 빠르고 효율적인 개발 경험을 Start해보세요!

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 Week요 Features

1.3 Week요 Use 사례

2. 설치 및 Start하기

2.1 설치 방법

macOS/Linux/WSL (권장)

Windows PowerShell

Homebrew (macOS)

NPM

2.2 첫 번째 실행

2.3 시스템 요구사항

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

3.1 기본 명령어

3.2 고급 명령어

3.3 Use자 정의 슬래시 명령어

4. 에Previous트 모드와 서브에Previous트

4.1 에Previous트 모드란?

4.2 서브에Previous트 (Sub-agents)

4.3 내장 서브에Previous트

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

5.1 MCP란?

5.2 MCP 서버 설치

5.3 MCP 관리 명령어

5.4 Popular 있는 MCP 서버

6. Skills Feature

6.1 Skills란?

6.2 Skill 구조

6.3 SKILL.md 작성

6.4 Skills Save 위치

7. Hooks Feature

7.1 Hooks란?

7.2 Hook 이벤트 종류

7.3 Hooks Settings Yes제

7.4 실제 Use 사례

8. IDE 통합

8.1 VS Code 확장 프로그램

설치 방법

Week요 단축키

Key Features

8.2 JetBrains IDE 통합

Support IDE

설치 방법

Key Features

9. Settings 및 구성

9.1 Settings 파Day 위치

9.2 Week요 Settings 옵션

9.3 Settings 우선순위

10. Security 및 권한 관리

10.1 3계층 권한 시스템

10.2 권한 규칙 Settings

10.3 권한 모드

10.4 Security 모범 사례

11. CLI 플래그 및 옵션

11.1 기본 Use

11.2 years old션 관리

11.3 모델 및 권한

11.4 Add Settings

12. 키보드 단축키

13. 실전 워크플로우 Example

13.1 새 Feature 개발

13.2 버그 Edit

13.3 코드 리팩토링

14. 결론 및 권장사항

핵심 활용 팁

이 글 Share