# Claude CLI 완전 가이드 v1: 소개 및 설치

## Claude Code(CLI)란?

Claude Code는 Anthropic이 공식 제공하는 CLI(Command Line Interface) 도구입니다. 터미널에서 직접 Claude AI와 대화하며 코딩, 파일 편집, 프로젝트 분석 등 다양한 개발 작업을 수행할 수 있습니다.

### 주요 특징

- **터미널 네이티브**: IDE 없이 터미널에서 바로 AI 지원 개발
- **코드베이스 인식**: 프로젝트 전체를 이해하고 컨텍스트 기반 지원
- **파일 직접 편집**: 승인 후 파일을 직접 수정
- **다양한 도구 통합**: Git, npm, MCP 서버 등과 연동
- **권한 기반 보안**: 민감한 작업은 항상 사용자 승인 필요

---

## 설치 방법

### 방법 1: Homebrew (macOS/Linux) - 권장

```bash
brew install --cask claude-code
```

### 방법 2: NPM (Node.js 18+ 필요)

```bash
npm install -g @anthropic-ai/claude-code
```

### 방법 3: Curl 스크립트 (macOS, Linux, WSL)

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

### 방법 4: Windows PowerShell

```powershell
irm https://claude.ai/install.ps1 | iex
```

---

## 최초 실행 및 인증

### 1. Claude 실행

설치 후 터미널에서 실행:

```bash
claude
```

### 2. 계정 인증

최초 실행 시 인증 프롬프트가 나타납니다. 다음 중 하나의 계정이 필요합니다:

| 계정 유형 | 특징 |
|----------|------|
| Claude.ai 구독 | Pro/Team 구독자, 최적 성능 권장 |
| Claude Console | API 크레딧 선불 충전 방식 |

브라우저가 열리면 로그인하여 인증을 완료합니다. 인증 정보는 로컬에 저장되어 이후 재인증 불필요.

### 3. 인증 확인

```bash
claude /status
```

버전 정보와 연결 상태가 표시되면 성공입니다.

---

## 설치 상태 점검

설치가 제대로 되었는지 종합 점검:

```bash
claude /doctor
```

다음 항목을 검사합니다:
- 설치 무결성
- 인증 상태
- MCP 서버 연결
- 디스크 공간
- 네트워크 연결

---

## 프로젝트에서 시작하기

### 작업 디렉토리로 이동 후 실행

```bash
cd /path/to/your/project
claude
```

Claude는 현재 디렉토리를 작업 공간으로 인식하고, 해당 프로젝트의 파일들을 컨텍스트로 활용합니다.

### 첫 대화 시작

```
> 이 프로젝트의 구조를 설명해줘
```

```
> /help
```

`/help` 명령으로 사용 가능한 모든 명령어를 확인할 수 있습니다.

---

## 기본 환경 구성

### 설정 파일 위치

| 위치 | 용도 |
|------|------|
| `~/.claude/settings.json` | 사용자 전역 설정 |
| `.claude/settings.json` | 프로젝트별 설정 (팀 공유) |
| `.claude/settings.local.json` | 프로젝트별 개인 설정 (git 무시) |

### 기본 설정 예시

`~/.claude/settings.json`:

```json
{
  "model": "sonnet",
  "permissions": {
    "allow": [
      "Bash(npm run build:*)",
      "Bash(npm test:*)"
    ]
  }
}
```

---

## 다음 단계

v1에서는 Claude CLI의 개요와 설치를 다뤘습니다.

**다음 v2에서는**:
- 커맨드라인 모드 (One-Shot Mode)
- `-p` 플래그와 스크립트 통합
- CI/CD 파이프라인 활용법

을 상세히 알아봅니다.

---

## 빠른 참조

| 명령어 | 설명 |
|--------|------|
| `claude` | Interactive 모드 시작 |
| `claude /status` | 버전 및 연결 상태 확인 |
| `claude /doctor` | 설치 상태 종합 점검 |
| `claude /help` | 도움말 표시 |
| `Ctrl+D` | 종료 |

---

*Claude CLI 완전 가이드 시리즈 v1/10*