# Claude Code 사용법 및 주요 명령 (필요하신 스터디원분들은 참고하세요!)

- 작성자: [유쾌한 사슴](https://community.clauders.ai/member/imported-member-by3KwrAQnI)
- 공간: [에이전트 / 노코드 자동화](https://community.clauders.ai/automation)
- 게시: 2026-05-22
- 연재: [문서 자동화 시스템 설계](https://community.clauders.ai/series/document-automation-systems) 2/5편
- 태그: #문서자동화
- 주소: https://community.clauders.ai/automation/post/claude-code-%EC%82%AC%EC%9A%A9%EB%B2%95-%EB%B0%8F-%EC%A3%BC%EC%9A%94-%EB%AA%85%EB%A0%B9-%ED%95%84%EC%9A%94%ED%95%98%EC%8B%A0-%EC%8A%A4%ED%84%B0%EB%94%94%EC%9B%90%EB%B6%84%EB%93%A4%EC%9D%80-%EC%B0%B8%EA%B3%A0%ED%95%98%EC%84%B8%EC%9A%94-b18699f4-825a-869a-bddb-51e5db3bf738

---

클로드코드 사용법이 익숙하지 않은 스터디원분들을 위해서

정리해서 올리는 내용입니다.

필요하신 분들은 참고해서 활용하세요!

이 내용은 Claude code의 도움으로 제작되었습니다.

**Claude Code 완벽 가이드**

> Anthropic의 공식 CLI 도구 Claude Code의 주요 명령어, 단축키, 사용법 정리 작성일: 2026-05-18

### **설치**

```
# npm으로 설치
npm install -g @anthropic-ai/claude-code

# 또는 공식 인스톨러
curl -fsSL https://claude.ai/install.sh | bash
```

### **첫 실행**

```
# 프로젝트 디렉토리로 이동 후 실행
cd my-project
claude

# 특정 모델 지정
claude --model claude-opus-4-7
claude --model claude-sonnet-4-6
```

### **로그인**

```
# 대화창에서
/login
```

### **세션 관리**

명령어

설명

`/help`

전체 도움말 표시

`/clear`

대화 컨텍스트 완전 초기화

`/compact`

긴 대화를 요약하여 컨텍스트 절약

`/resume`

이전 세션 재개

`/exit`

Claude Code 종료

`/status`

현재 세션 상태 확인

`/cost`

토큰 사용량 및 비용 확인

`/export`

대화 내용 마크다운으로 내보내기

### **설정 및 환경**

명령어

설명

`/config`

설정 메뉴 열기 (테마, 모델 등)

`/model`

사용할 Claude 모델 변경

`/permissions`

도구 권한 설정 (allow/deny)

`/login` / `/logout`

인증 관리

`/add-dir`

작업 가능 디렉토리 추가

`/memory`

CLAUDE.md 메모리 파일 편집

`/vim`

Vim 키바인딩 모드 토글

### **프로젝트 초기화**

명령어

설명

`/init`

CLAUDE.md 자동 생성 (코드베이스 분석)

`/agents`

서브에이전트 관리 (생성/수정/조회)

`/hooks`

훅(Hook) 관리

`/mcp`

MCP 서버 연결 관리

### **코드 작업**

명령어

설명

`/review`

현재 브랜치 또는 PR 코드 리뷰

`/security-review`

보안 취약점 검토

`/pr_comments`

PR 코멘트 조회

`/bug`

버그 리포트 제출

> **참고**: 설치된 플러그인이나 사용자 정의 명령어는 `/` 입력 시 자동 표시됩니다.

### **기본 단축키**

단축키

동작

`Ctrl+C`

현재 작업 취소 / 종료

`Ctrl+D`

Claude Code 종료

`Ctrl+L`

화면 지우기

`Ctrl+R`

명령 히스토리 검색

`Esc`

진행 중인 작업 중단

`Esc` 2회

이전 메시지로 점프 (편집 가능)

`Shift+Tab`

모드 순환 전환 (Default → Auto-accept → Plan)

`↑` / `↓`

이전 입력 히스토리 탐색

`Tab`

자동 완성 (파일 경로, 명령어)

`\` + `Enter`

줄바꿈 (메시지 내)

`Alt+Enter`

줄바꿈 (일부 터미널)

### **다중 줄 입력**

- `"""` (트리플 쿼트) 또는 `\` + Enter로 여러 줄 입력
- 이미지는 **드래그앤드롭** 또는 **클립보드 붙여넣기** (Ctrl+V)

### **모드 전환**

`Shift+Tab`을 누르면 순차적으로 모드가 변경됩니다:

1. **Default Mode** — 매 도구 호출마다 확인
2. **Auto-accept Mode** — 파일 편집 자동 수락
3. **Plan Mode** — 읽기 전용, 실행 전 계획 수립

### **Default Mode (기본)**

- 파일 편집, 셸 명령 등 모든 도구 사용 시 사용자 승인 필요
- 안전하지만 상호작용이 많음

### **Auto-accept Mode (자동 수락)**

- 파일 편집 자동 수락
- 빠른 반복 작업에 적합
- 위험한 명령(rm, git push 등)은 여전히 확인

### **Plan Mode (계획 모드)**

- **읽기 전용** 모드
- 파일 수정/실행 없이 분석 및 계획만 수립
- `ExitPlanMode`로 계획 승인 후 실행 시작
- 대규모 변경 전 권장

```
# Plan Mode 진입
Shift+Tab을 눌러 "Plan mode"로 전환

# 작업 지시
"인증 시스템을 OAuth로 마이그레이션할 계획 세워줘"

# Claude가 계획 제시 → 승인 → 실행
```

### **VS Code / Cursor**

1. Marketplace에서 **"Claude Code"** 확장 설치
2. `Cmd/Ctrl+Esc`로 패널 열기
3. 에디터의 선택 영역, 진단 정보를 자동 컨텍스트로 사용

### **JetBrains (IntelliJ, PyCharm 등)**

1. Plugins → **"Claude Code"** 설치
2. 우측 사이드바에서 활성화

### **주요 IDE 기능**

- 선택한 코드 자동 첨부 (`@selection`)
- 에러/경고 자동 감지 (`mcp__ide__getDiagnostics`)
- Jupyter 노트북 셀 실행 (`mcp__ide__executeCode`)

### **워크플로우 1: 새 기능 추가**

```
1. /init                              # 처음이면 CLAUDE.md 생성
2. Shift+Tab → Plan Mode
3. "사용자 인증 기능을 JWT로 추가해줘"
4. 계획 검토 → 승인
5. Shift+Tab → Auto-accept Mode
6. 실행 자동 진행
7. ! npm test                         # 직접 테스트
8. "커밋 메시지 작성하고 커밋해줘"
```

### **워크플로우 2: 코드 리뷰**

```
1. git checkout feature-branch
2. claude
3. /review                            # 전체 변경 리뷰
4. /security-review                   # 보안 검토
```

### **워크플로우 3: 디버깅**

```
1. @logs/error.log @src/api/handler.ts
2. "이 에러의 원인 찾아줘"
3. ! npm run debug                    # 디버그 모드 실행
4. Claude가 로그 분석 후 수정 제안
```

### **워크플로우 4: 대규모 리팩터링**

```
1. Plan Mode 진입
2. "전역 상태관리를 Redux에서 Zustand로 마이그레이션 계획 세워줘"
3. 단계별 계획 검토
4. 각 단계마다 분리 실행 (한 번에 다 하지 말 것)
5. 단계별 git commit
```

### **컨텍스트가 너무 길어졌을 때**

```
/compact                  # 요약 후 계속
/clear                    # 완전 초기화 (새 작업 시작 시)
```

### **Claude가 의도와 다르게 동작할 때**

```
Esc Esc                   # 이전 메시지로 돌아가서 수정
# 잘못된 동작이 반복되면 → 명확하게 설명 추가
```

### **권한 프롬프트가 너무 많을 때**

```
/permissions              # 자주 쓰는 명령 allowlist 추가
또는 /fewer-permission-prompts 스킬 실행
```

### **비용이 걱정될 때**

```
/cost                     # 실시간 사용량 확인
/model                    # Haiku 등 저렴한 모델로 전환
/compact                  # 컨텍스트 줄이기
```

### **세션을 잃어버렸을 때**

```
claude --resume           # 또는 /resume
```

### **1. 파일 참조는 **`@`**로**

```
@src/**/*.ts            # 글롭 패턴 가능
@README.md @CHANGELOG.md  # 여러 파일 동시
```

### **2. 셸 출력을 컨텍스트에 넣기**

```
! curl -s https://api.example.com/data | jq .
```

### **3. 이미지 분석**

스크린샷이나 다이어그램을 드래그앤드롭하면 Claude가 시각적으로 분석합니다.

### **4. 멀티 에이전트 협업**

```
# 여러 서브에이전트를 병렬 호출하여 빠른 분석
"code-reviewer와 security-reviewer를 병렬로 돌려줘"
```

### **5. CLAUDE.md를 짧고 명확하게**

- 200줄 이상이면 컨텍스트 낭비
- 코드베이스에서 추론 가능한 내용은 제외
- "왜(Why)" 위주로 작성

## **참고 링크**

- 공식 문서: [https://docs.claude.com/claude-code](https://docs.claude.com/claude-code)
- GitHub 이슈: [https://github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)
- 모델 비교: Opus 4.7 (최고 성능) / Sonnet 4.6 (균형) / Haiku 4.5 (빠름·저렴)

_Made with Claude Code | 2026-05-18_