터미널에서 AI와 코딩하기: Claude Code 명령어 완전 정복

Claude Code는 Anthropic에서 개발한 명령줄 기반 AI 개발 도구로, 터미널에서 직접 Claude AI와 상호작용하며 코딩 작업을 수행할 수 있게 해줍니다. 2025년 5월 22일 Claude 4.0 출시와 함께 더욱 강력해진 기능들을 제공하고 있습니다.

Claude 4.0 모델 패밀리 소개

새로운 모델 라인업

Claude Opus 4 - 최고 성능 모델

• 코딩 벤치마크: SWE-bench에서 72.5%, Terminal-bench에서 43.2% 달성
• 특징: 세계 최고의 코딩 모델로 복잡한 장시간 작업에서 지속적인 성능 발휘
• 용도: 복잡한 디버깅, 아키텍처 설계, 보안 분석, 대규모 리팩토링
• 비용: 입력 100만 토큰당 $15, 출력 100만 토큰당 $75

Claude Sonnet 4 - 균형잡힌 성능 모델

• 코딩 벤치마크: SWE-bench에서 72.7%로 Opus 4를 약간 상회
• 특징: Claude Sonnet 3.7의 대폭적인 업그레이드로 향상된 코딩 및 추론 능력
• 용도: 일반적인 개발 작업, 파일 조작, 루틴 코딩 작업
• 비용: 입력 100만 토큰당 $3, 출력 100만 토큰당 $15

Claude 3.5 Haiku - 빠른 응답 모델

• 특징: 단순한 편집, 빠른 질문, 기본 포맷팅에 최적화
• 용도: 간단한 텍스트 편집, 빠른 코드 검토, 기본적인 질문 답변

Claude Code의 22개 슬래시 명령어를 카테고리별로 분류한 분포 차트

1. CLI 명령어 (터미널 실행 명령어)

Claude Code의 핵심은 터미널에서 직접 실행하는 CLI 명령어들입니다.

기본 실행 명령어

claude - 대화형 세션 시작

claude

가장 기본적인 명령어로, 현재 디렉토리를 작업 공간으로 하여 Claude와 대화형 세션을 시작합니다.

실제 사용 예시:

# React 프로젝트 디렉토리에서
cd my-react-app
claude
> 이 React 프로젝트의 구조를 분석하고 개선점을 알려줘

claude "질문" - 초기 프롬프트와 함께 세션 시작

claude "package.json 파일을 분석해줘"
claude "이 프로젝트의 보안 취약점을 찾아줘"
claude "성능 최적화 방안을 제시해줘"

비대화형 모드

claude -p "질문" - 단발성 질문 실행

claude -p "이 함수의 기능을 설명해줘"
claude -p "코드에서 오류를 찾아줘"
claude -p "이 API 응답을 파싱하는 코드를 작성해줘"

파이프라인과 함께 사용하는 고급 예시:

# 로그 파일 분석
cat error.log | claude -p "이 로그에서 오류 패턴을 분석해줘"

# Git 변경사항 요약
git diff | claude -p "변경사항을 요약하고 코드 리뷰를 해줘"

# 테스트 결과 분석
npm test 2>&1 | claude -p "테스트 실패 원인을 분석해줘"

# 코드 복잡도 분석
find . -name "*.js" -exec wc -l {} + | claude -p "이 코드베이스의 복잡도를 평가해줘"

대화 재개 명령어

claude -c 또는 claude --continue - 최근 대화 계속

claude -c
claude --continue

실제 시나리오:

# 어제 작업하던 버그 수정 계속하기
claude -c
> 어제 논의했던 메모리 누수 문제, 해결 방법을 다시 알려줘

claude -r "세션ID" 또는 claude --resume - 특정 대화 재개

claude --resume  # 대화 선택 화면 표시
claude -r "abc123" "이전 작업 계속해줘"  # 특정 세션으로 바로 이동

2. CLI 플래그 (명령어 옵션)

모델 선택 (Claude 4.0 업데이트)

--model - AI 모델 지정

# Claude 4.0 모델들
claude --model opus-4         # Claude Opus 4 사용 (최고 성능)
claude --model sonnet-4       # Claude Sonnet 4 사용 (균형잡힌 성능)
claude --model haiku          # Claude 3.5 Haiku 사용 (빠른 응답)

# 전체 모델명으로 지정
claude --model claude-opus-4-20250514
claude --model claude-sonnet-4-20250514

작업 유형별 모델 선택 예시:

# 복잡한 아키텍처 설계
claude --model opus-4 "마이크로서비스 아키텍처를 설계해줘"

# 일반적인 코드 리뷰
claude --model sonnet-4 "이 함수를 리팩토링해줘"

# 빠른 문법 체크
claude --model haiku "이 코드에 문법 오류가 있나?"

디렉토리 및 권한 설정

--add-dir - 추가 작업 디렉토리 지정

claude --add-dir ../frontend --add-dir ../backend
claude --add-dir /home/user/libs
claude --add-dir ~/shared-components --add-dir ./docs

실제 사용 시나리오:

# 풀스택 프로젝트 분석
claude --add-dir ../frontend --add-dir ../backend --add-dir ../database \
  "전체 프로젝트의 데이터 플로우를 분석해줘"

# 라이브러리와 함께 작업
claude --add-dir ~/my-utils-lib \
  "이 유틸리티 라이브러리를 사용해서 프로젝트를 개선해줘"

--allowedTools - 허용할 도구 지정

claude --allowedTools "Bash(git:*)" "Bash(npm:*)" "Read" "Write"
claude --allowedTools "Bash(docker:*)" "Bash(kubectl:*)" "Read"

--disallowedTools - 금지할 도구 지정

claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)" "Bash(chmod:*)"
claude --disallowedTools "Bash(ssh:*)" "Bash(scp:*)"

보안이 중요한 환경에서의 예시:

# 프로덕션 서버에서 안전한 분석만
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)" "Write" \
  --allowedTools "Read" "Bash(ps:*)" "Bash(netstat:*)" \
  "시스템 상태를 분석해줘"

출력 및 세션 제어

--output-format - 출력 형식 지정

claude -p "API 응답 분석 결과" --output-format json
claude -p "데이터 처리 결과" --output-format stream-json
claude -p "코드 리뷰 결과" --output-format markdown

--max-turns - 대화 턴 수 제한

# 간단한 질문으로 제한
claude --max-turns 3 "간단한 코드 리뷰만 해줘"

# 심층 분석 허용
claude --max-turns 10 "복잡한 버그를 해결해줘"

--verbose - 상세 로깅 활성화

claude --verbose

3. 슬래시 명령어 (Claude Code 내부 명령어)

Claude Code 세션 내에서 /로 시작하는 22개의 내장 명령어들입니다.

기본 조작 명령어 (5개)

/help - 사용 가능한 명령어 목록 표시

/help

/clear - 대화 기록 삭제

/clear

사용 시나리오: 토큰 사용량이 많아졌거나 새로운 주제로 전환할 때

/exit - Claude Code 종료

/exit

/status - 계정 및 시스템 상태 확인

/status

출력 예시:

계정: claude.user@example.com
모델: Claude Sonnet 4
세션 시간: 45분
사용된 토큰: 15,324 tokens

/cost - 토큰 사용량과 비용 표시

/cost

출력 예시:

입력 토큰: 8,250 ($0.025)
출력 토큰: 7,074 ($0.106)
총 비용: $0.131

설정 관리 명령어 (7개)

/config - 설정 표시 및 변경

/config

/model - AI 모델 선택 및 변경

/model opus-4
/model sonnet-4
/model claude-3-5-haiku-20241022

실제 사용 예시:

> /model sonnet-4
모델이 Claude Sonnet 4로 변경되었습니다.

> 간단한 함수 리팩토링 해줘
[Sonnet 4로 빠르게 처리...]

> /model opus-4
모델이 Claude Opus 4로 변경되었습니다.

> 이제 전체 아키텍처를 분석해줘
[Opus 4로 심층 분석...]

/permissions - 접근 권한 관리

/permissions
/permissions add /home/user/project
/permissions remove /tmp/unsafe

/login - Anthropic 계정 전환

/login

/logout - 현재 계정에서 로그아웃

/logout

/doctor - 설치 상태 진단

/doctor

출력 예시:

✓ Claude Code 버전: 1.2.3
✓ 네트워크 연결: 정상
✓ API 키: 유효
✗ Git 설정: 누락 (해결 방법: git config --global user.email "your@email.com")

/terminal-setup - 터미널 설정 설치

/terminal-setup

프로젝트 관리 명령어 (4개)

/init - CLAUDE.md 프로젝트 가이드 생성

/init

생성되는 CLAUDE.md 예시:

# 프로젝트: React E-commerce App

## 프로젝트 구조
- `/src/components`: React 컴포넌트
- `/src/services`: API 서비스
- `/src/utils`: 유틸리티 함수

## 주요 명령어
- `npm start`: 개발 서버 실행
- `npm test`: 테스트 실행
- `npm run build`: 프로덕션 빌드

## 코딩 스타일
- TypeScript 사용
- ESLint + Prettier 적용
- 함수형 컴포넌트 선호

/memory - CLAUDE.md 메모리 파일 편집

/memory

추가할 수 있는 메모리 정보 예시:

## 기억할 사항
- 이 프로젝트는 Redux Toolkit 사용
- API 기본 URL: https://api.example.com
- 테스트는 Jest + React Testing Library
- 배포는 Vercel 사용
- 주요 의존성: axios, react-query, styled-components

/add-dir - 추가 작업 디렉토리 추가

/add-dir ../backend
/add-dir /home/user/shared-libs
/add-dir ~/Desktop/design-assets

/compact - 대화 기록 압축

/compact
/compact "API 구현 관련 내용만"
/compact "버그 수정 관련 논의만"

개발 지원 명령어 (4개)

/review - 코드 리뷰 요청

/review

실제 리뷰 결과 예시:

코드 리뷰 결과:

🟢 좋은 점:
- TypeScript 타입 정의가 명확함
- 에러 핸들링이 적절함
- 컴포넌트 분리가 잘 되어 있음

🟡 개선 사항:
- `UserList.tsx`: useCallback 사용으로 불필요한 리렌더링 방지 필요
- `api.ts`: 타임아웃 설정 추가 권장
- `utils.ts`: 유닛 테스트 추가 필요

🔴 수정 필요:
- `LoginForm.tsx` 라인 25: 비밀번호 유효성 검사 로직 누락

/pr_comments - Pull Request 코멘트 확인

/pr_comments

/vim - Vim 에디터 모드 활성화

/vim

/mcp - MCP 서버 연결 관리

/mcp

시스템 관리 명령어 (2개)

/bug - Anthropic에 버그 신고

/bug

/resume - 과거 대화 선택 재개

/resume

4. 커스텀 슬래시 명령어

사용자가 직접 만드는 명령어로 반복 작업을 자동화할 수 있습니다.

커스텀 명령어 생성 방법

프로젝트 스코프 (.claude/commands/)

mkdir -p .claude/commands

사용자 스코프 (~/.claude/commands/)

mkdir -p ~/.claude/commands

실제 커스텀 명령어 예시

성능 최적화 명령어

# .claude/commands/optimize.md
성능 최적화를 수행해줘:

1. 번들 크기 분석
2. 렌더링 성능 체크
3. 메모리 사용량 확인
4. 네트워크 요청 최적화
5. 개선 방안 제시

현재 프로젝트의 성능 병목을 찾고 구체적인 해결책을 제시해줘.

사용 방법:

/project:optimize

버그 수정 플로우 명령어

# .claude/commands/fix-issue.md
다음 단계로 버그를 분석하고 수정해줘:

1. 문제 재현 시나리오 작성
2. 관련 코드 파일 식별
3. 근본 원인 분석
4. 수정 방안 제안
5. 테스트 케이스 작성
6. 코드 구현
7. 검증 방법 제시

단계별로 자세히 설명하면서 진행해줘.

컴포넌트 생성 템플릿

# ~/.claude/commands/component.md
React 컴포넌트를 생성해줘:

1. TypeScript 인터페이스 정의
2. 함수형 컴포넌트 구현
3. styled-components 스타일링
4. Props 검증
5. 스토리북 스토리 작성
6. 유닛 테스트 작성

우리 프로젝트의 코딩 스타일과 패턴을 따라서 작성해줘.

고급 커스텀 명령어 예시

배포 전 체크리스트

# .claude/commands/deploy-check.md
배포 전 다음 사항들을 체크해줘:

## 코드 품질
- [ ] 린트 오류 없음
- [ ] 타입 체크 통과
- [ ] 테스트 커버리지 80% 이상

## 보안
- [ ] 민감 정보 하드코딩 없음
- [ ] 의존성 취약점 없음
- [ ] API 엔드포인트 보안

## 성능
- [ ] 번들 크기 적정
- [ ] 이미지 최적화 완료
- [ ] 레이지 로딩 적용

각 항목별로 현재 상태를 체크하고 문제가 있으면 해결 방안을 제시해줘.

API 문서 생성

# .claude/commands/api-docs.md
현재 코드에서 API 엔드포인트를 분석하고 다음 형식으로 문서를 생성해줘:

## API 엔드포인트 목록

### GET /api/users
- **설명**: 사용자 목록 조회
- **파라미터**: 
- **응답**: 
- **에러 코드**: 

각 엔드포인트별로 상세한 문서를 작성하고 OpenAPI 스펙도 함께 생성해줘.

실전 워크플로우 예시

새 프로젝트 시작

# 1. 프로젝트 초기화
cd my-new-project
claude

> /init
> 이 프로젝트에 대한 개발 가이드를 만들어줘

# 2. 개발 환경 설정
> package.json에 필요한 의존성을 추가해줘
> ESLint와 Prettier 설정을 최적화해줘

버그 수정 워크플로우

# 1. 이전 작업 재개
claude -c

> 어제 논의했던 로그인 버그 상황을 요약해줘

# 2. 커스텀 명령어로 체계적 분석
> /project:fix-issue

# 3. 모델 전환으로 심층 분석
> /model opus-4
> 더 복잡한 메모리 누수 문제도 함께 분석해줘

코드 리뷰 및 배포 준비

claude --model sonnet-4

> /review
> /project:deploy-check
> /project:api-docs

# Git과 연계하여 변경사항 분석
git diff | claude -p "이번 변경사항의 영향도를 분석해줘"

요금제별 모델 접근

Claude Pro 플랜 ($20/월)

• Sonnet 4 접근 가능
• 일반적인 개발 작업에 적합

Claude Max 5x ($100/월)

• Sonnet 4 + 제한적 Opus 4 접근
• 중간 규모 프로젝트에 적합

Claude Max 20x ($200/월)

• 모든 모델 무제한 접근
• 대규모 프로젝트나 팀 사용에 최적

API 사용

• 토큰당 과금으로 모든 모델 접근 가능
• 사용량에 따른 유연한 비용 구조

마무리

Claude Code는 Claude 4.0의 도입과 함께 개발자들의 워크플로우를 혁신적으로 개선할 수 있는 도구가 되었습니다. 특히 Opus 4의 뛰어난 코딩 성능과 Sonnet 4의 효율성, 그리고 다양한 명령어 시스템을 통해 복잡한 개발 작업부터 일상적인 코딩까지 모든 영역에서 AI의 도움을 받을 수 있습니다.

커스텀 슬래시 명령어를 활용하면 팀만의 표준화된 작업 방식을 구축할 수 있고, CLI 플래그로 보안과 성능을 최적화할 수 있어 프로덕션 환경에서도 안전하게 사용할 수 있습니다.