CLI 사용법

기본 명령어

Claude Code는 간단한 명령어로 시작할 수 있습니다. 프로젝트 디렉토리에서 claude 명령을 실행하면 대화형 세션이 시작됩니다.

# Claude Code 시작
claude

# 특정 디렉토리에서 시작
claude --dir /path/to/project

# 도움말 보기
claude --help

명령줄 옵션

`--dir, -d`

작업 디렉토리를 지정합니다.

claude -d /home/user/my-project

`--print, -p`

비대화형 모드로 실행합니다. CI/CD 파이프라인에서 유용합니다.

claude -p "테스트를 실행하고 결과를 보여줘"

`--model, -m`

사용할 Claude 모델을 지정합니다.

claude -m claude-3-opus

`--api-key`

API 키를 직접 제공합니다.

claude --api-key sk_your_api_key

대화형 모드

기본적으로 Claude Code는 대화형 모드로 실행됩니다. 자연어로 작업을 요청하고 실시간으로 결과를 확인할 수 있습니다.

💬 대화 예시
                                > 현재 프로젝트의 구조를 설명해줘
# Claude가 프로젝트를 분석하고 설명합니다

> package.json의 의존성을 업데이트해줘
# Claude가 파일을 수정하고 변경사항을 보여줍니다

> 변경사항을 커밋해줘
# Claude가 Git 커밋을 생성합니다
                            

비대화형 모드

스크립트나 CI/CD 환경에서는 --print 옵션을 사용하여 비대화형 모드로 실행할 수 있습니다.

# 단일 작업 실행
claude -p "README.md를 업데이트해줘"

# 환경 변수로 API 키 설정
export ANTHROPIC_API_KEY=sk_your_api_key
claude -p "테스트를 실행하고 실패를 수정해줘"

# 도구 사용 제한
claude -p "코드 분석해줘" --allowedTools Read Grep --disallowedTools Write

도구 관리

Claude Code가 사용할 수 있는 도구를 제어할 수 있습니다.

🔧 사용 가능한 도구

Read: 파일 읽기
Write: 파일 쓰기
Bash: 명령 실행
Grep: 파일 검색
WebSearch: 웹 검색

# 특정 도구만 허용
claude --allowedTools Read Grep

# 특정 도구 제외
claude --disallowedTools Write Bash

# Bash 명령 패턴 제한
claude --allowedTools "Bash(npm test:*)" "Bash(git log:*)"

세션 관리

Claude Code는 대화 컨텍스트를 유지하며, 필요에 따라 재설정할 수 있습니다.

# 세션 중 명령어
> /reset  # 대화 컨텍스트 초기화
> /exit   # Claude Code 종료
> /help   # 도움말 표시

기본 명령어

명령줄 옵션

--dir, -d

--print, -p

--model, -m

--api-key