CLI 사용법 및 제어
CLI 사용법 및 제어
명령줄에서 Claude Code를 사용하는 방법, CLI 명령어, 플래그 및 슬래시 명령어를 알아보세요.
시작하기
Claude Code는 상호작용할 수 있는 두 가지 주요 방법을 제공합니다:
- 대화형 모드:
claude를 실행하여 REPL 세션 시작 - 일회성 모드: 빠른 명령을 위해
claude -p "쿼리"를 사용
CLI 명령어
| 명령어 | 설명 | 예시 |
|---|---|---|
claude | 대화형 REPL 시작 | claude |
claude "쿼리" | 초기 프롬프트로 REPL 시작 | claude "이 프로젝트 설명해줘" |
claude -p "쿼리" | 일회성 쿼리 실행 후 종료 | claude -p "이 함수 설명해줘" |
cat file | claude -p "쿼리" | 파이프된 콘텐츠 처리 | cat logs.txt | claude -p "설명해줘" |
claude -c | 가장 최근 대화 계속하기 | claude -c |
claude -c -p "쿼리" | 출력 모드로 계속하기 | claude -c -p "타입 오류 확인해줘" |
claude -r "<session-id>" "쿼리" | ID로 세션 재개 | claude -r "abc123" "이 PR 완성해줘" |
claude update | 최신 버전으로 업데이트 | claude update |
claude mcp | Model Context Protocol 서버 구성 | 튜토리얼의 MCP 섹션 참조 |
CLI 플래그
다음 명령줄 플래그로 Claude Code의 동작을 사용자 지정할 수 있습니다:
| 플래그 | 설명 | 예시 |
|---|---|---|
--add-dir | Claude가 접근할 수 있는 추가 작업 디렉토리 추가(각 경로가 디렉토리로 존재하는지 검증) | claude --add-dir ../apps ../lib |
--allowedTools | settings.json 파일 외에도 사용자 허가 없이 허용되어야 하는 도구 목록 | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--disallowedTools | settings.json 파일 외에도 사용자 허가 없이 거부되어야 하는 도구 목록 | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--print, -p | 대화형 모드 없이 응답 출력(프로그래밍 방식 사용에 대한 자세한 내용은 SDK 문서 참조) | claude -p "쿼리" |
--output-format | 출력 모드의 출력 형식 지정(옵션: text, json, stream-json) | claude -p "쿼리" --output-format json |
--verbose | 상세 로깅 활성화, 전체 턴별 출력 표시(출력 및 대화형 모드 모두에서 디버깅에 유용) | claude --verbose |
--max-turns | 비대화형 모드에서 에이전트 턴 수 제한 | claude -p --max-turns 3 "쿼리" |
--model | 최신 모델의 별칭(sonnet 또는 opus) 또는 모델의 전체 이름으로 현재 세션의 모델 설정 | claude --model claude-sonnet-4-20250514 |
--permission-prompt-tool | 비대화형 모드에서 권한 프롬프트를 처리할 MCP 도구 지정 | claude -p --permission-prompt-tool mcp_auth_tool "쿼리" |
--resume | ID로 특정 세션을 재개하거나 대화형 모드에서 선택 | claude --resume abc123 "쿼리" |
--continue | 현재 디렉토리에서 가장 최근 대화 불러오기 | claude --continue |
--dangerously-skip-permissions | 권한 프롬프트 건너뛰기(주의해서 사용) | claude --dangerously-skip-permissions |
--output-format json 플래그는 특히 스크립팅 및 자동화에 유용하며, Claude의 응답을 프로그래밍 방식으로 파싱할 수 있습니다.
출력 형식, 스트리밍, 상세 로깅 및 프로그래밍 방식 사용을 포함한 출력 모드(-p)에 대한 자세한 정보는 SDK 문서를 참조하세요.
슬래시 명령어
대화형 세션 중 Claude의 동작을 제어합니다:
| 명령어 | 목적 |
|---|---|
/bug | 버그 보고(대화를 Anthropic에 전송) |
/clear | 대화 기록 지우기 |
/compact [instructions] | 선택적 집중 지침으로 대화 압축 |
/config | 구성 보기/수정 |
/cost | 토큰 사용 통계 표시 |
/doctor | Claude Code 설치 상태 확인 |
/help | 사용법 도움말 보기 |
/init | CLAUDE.md 가이드로 프로젝트 초기화 |
/login | Anthropic 계정 전환 |
/logout | Anthropic 계정에서 로그아웃 |
/memory | CLAUDE.md 메모리 파일 편집 |
/model | AI 모델 선택 또는 변경 |
/permissions | 권한 보기 또는 업데이트 |
/pr_comments | 풀 리퀘스트 댓글 보기 |
/review | 코드 리뷰 요청 |
/status | 계정 및 시스템 상태 보기 |
/terminal-setup | 줄바꿈을 위한 Shift+Enter 키 바인딩 설치(iTerm2 및 VSCode만 해당) |
/vim | 삽입 모드와 명령 모드를 번갈아 사용하는 vim 모드 진입 |
특수 단축키
#로 빠른 메모리
입력을 #으로 시작하여 즉시 메모리 추가:
이를 저장할 메모리 파일을 선택하라는 메시지가 표시됩니다.
터미널에서 줄 바꿈
다음을 사용하여 여러 줄 명령 입력:
- 빠른 이스케이프:
\입력 후 Enter - 키보드 단축키: Option+Enter(또는 구성된 경우 Shift+Enter)
터미널에서 Option+Enter 설정 방법:
Mac Terminal.app의 경우:
- 설정 → 프로필 → 키보드 열기
- “Option을 Meta 키로 사용” 체크
iTerm2 및 VSCode 터미널의 경우:
- 설정 → 프로필 → 키 열기
- 일반에서 왼쪽/오른쪽 Option 키를 “Esc+“로 설정
iTerm2 및 VSCode 사용자를 위한 팁: Claude Code 내에서 /terminal-setup을 실행하여 더 직관적인 대안으로 Shift+Enter를 자동으로 구성하세요.
구성 세부 정보는 설정의 터미널 설정을 참조하세요.
Vim 모드
Claude Code는 /vim 또는 /config를 통해 활성화할 수 있는 Vim 키 바인딩의 하위 집합을 지원합니다.
지원되는 하위 집합에는 다음이 포함됩니다:
- 모드 전환:
Esc(NORMAL로),i/I,a/A,o/O(INSERT로) - 탐색:
h/j/k/l,w/e/b,0/$/^,gg/G - 편집:
x,dw/de/db/dd/D,cw/ce/cb/cc/C,.(반복)