터미널 CLI 명령·플래그 전체 참조
Claude Code 공식 CLI reference의 실행 형태 34개와 공통 플래그 79개, 최신 하위 옵션
핵심 요약
- 실행 형태 34개와 공통 플래그 79개를 수록합니다.
- v2.1.278까지의 plugin·runner 옵션과 명령별 조건을 확인합니다.
2026-09-22 공식 CLI reference 기준입니다. 아래 34개는 서로 다른 최상위 명령 수가 아니라 공식 표의 실행 형태 수입니다. 공통 플래그 79개에는 제거·deprecated 항목도 포함됩니다. 명령별 상세 옵션은 해당 명령의 --help와 연결된 공식 참조를 함께 확인하세요.
슬래시 명령 전체 목록 · Official CLI reference
실행 명령 34개
| 명령 | 용도 |
|---|---|
claude | 대화형 시작 |
claude "query" | 초기 요청과 함께 시작 |
claude -p "query" | 응답 출력 뒤 종료 |
cat file | claude -p "query" | 표준입력 파일 처리 |
claude -c | 현재 디렉터리의 최근 대화 재개 |
claude -c -p "query" | 최근 대화를 비대화형으로 재개 |
claude -r "<session>" "query" | ID·이름으로 대화 재개 |
claude update | 설치본 업데이트 |
claude gateway | 관리자용 gateway 실행; --config 필요 |
claude install [version] | 지정 버전·채널의 native binary 설치 |
claude auth login | 계정 로그인; --email·--sso·--console 지원 |
claude auth logout | 계정 로그아웃 |
claude auth status | 인증 상태; --text로 읽기 쉬운 출력 |
claude agents | background session 조회·작업 전달 |
claude attach <id> | background session에 터미널 연결 |
claude auto-mode defaults | 기본 classifier 규칙; --label로 필터 |
claude auto-mode reset | 사용자 autoMode 초기화; managed 규칙 유지 |
claude daemon status | supervisor 상태 진단 |
claude daemon stop --any | supervisor 중지; --keep-workers로 작업 보존 |
claude doctor | 읽기 전용 설치·설정 진단 |
claude import [source] | 다른 에이전트 설정 가져오기 |
claude logs <id> | background session 최근 출력 |
claude mcp | MCP 서버 설정 |
claude mcp login <name> | MCP OAuth 로그인; --no-browser 지원 |
claude mcp logout <name> | MCP OAuth 자격 증명 해제 |
claude plugin | plugin 관리; plugins 별칭 |
claude project purge [path] | 프로젝트 로컬 기록 삭제; --dry-run으로 미리보기 |
claude remote-control | 로컬 TUI 없이 Remote Control 서버 실행 |
claude respawn <id> | 대화를 보존하며 background session 재시작 |
claude rm <id> | background 목록·worktree 정리; transcript는 유지 |
claude self-hosted-runner | 자체 인프라의 cloud session runner 실행 |
claude setup-token | CI용 장기 OAuth token 발급·출력 |
claude stop <id> | background session 중지; kill 별칭 |
claude ultrareview [target] | 비대화형 cloud 리뷰; --json·--timeout 지원 |
공통 플래그 79개
| 플래그 | 용도·조건 |
|---|---|
--add-dir | 작업 디렉터리 접근 추가 |
--advisor <model> | 보조 모델 선택 |
--agent | 이번 세션 agent 선택 |
--agents | JSON으로 subagent 정의 |
--allow-dangerously-skip-permissions | bypassPermissions를 전환 목록에 추가 |
--allowedTools, --allowed-tools | 승인 없이 실행할 도구 규칙 |
--append-subagent-system-prompt | subagent prompt에 텍스트 추가 |
--append-subagent-system-prompt-file | subagent prompt에 파일 내용 추가; -p 전용 |
--append-system-prompt | 기본 system prompt에 텍스트 추가 |
--append-system-prompt-file | 기본 system prompt에 파일 추가 |
--autocompact <auto|tokens> | 이번 세션 자동 compact 기준 |
--ax-screen-reader | 스크린 리더용 출력 |
--bare | 자동 탐색을 줄인 최소 실행 |
--betas | API beta header |
--bg, --background | background session 시작 |
--channels | channel notification 수신; preview |
--chrome | Chrome 통합 활성화 |
--cloud | cloud session 생성·메시지 전송 |
--continue, -c | 현재 디렉터리 최근 세션 재개 |
--dangerously-load-development-channels | 개발용 channel 허용 |
--dangerously-skip-permissions | permission prompt 생략 |
--debug | debug 출력; 필터는 = 구문 |
--debug-file <path> | debug log 파일 |
--disable-slash-commands | skill·command 비활성화 |
--disallowedTools, --disallowed-tools | 도구 deny 규칙 |
--effort | reasoning effort |
--enable-auto-mode | v2.1.111 제거; --permission-mode auto 사용 |
--environment <environment-id> | self-hosted cloud environment ID |
--exclude-dynamic-system-prompt-sections | machine별 prompt 부분 분리; -p 전용 |
--exec | --bg와 shell job 실행 |
--fallback-model | fallback 모델 순서 |
--fork-session | 재개 시 새 session ID 생성 |
--forward-subagent-text | subagent text·thinking을 stream에 포함 |
--from-pr | PR·MR 연결 세션 필터 |
--ide | IDE 자동 연결 |
--init | Setup init hook; -p 전용 |
--init-only | 초기화 hook만 실행 후 종료 |
--include-hook-events | hook lifecycle event 출력 |
--include-partial-messages | 부분 streaming event; -p와 stream-json 필요 |
--input-format | 입력 text·stream-json; -p 전용 |
--json-schema | 결과 JSON Schema; -p 전용 |
--maintenance | Setup maintenance hook; -p 전용 |
--max-budget-usd | API 비용 상한; -p 전용·subagent 포함 |
--max-turns | agent turn 상한; -p 전용 |
--mcp-config | MCP JSON 설정 |
--model | 세션 모델 선택 |
--name, -n | 세션 표시 이름 |
--no-chrome | Chrome 통합 비활성화 |
--no-session-persistence | 세션 저장 생략; -p 전용 |
--output-format | text·json·stream-json 출력; -p 전용 |
--permission-mode | 시작 permission mode |
--permission-prompt-tool | headless 승인 응답용 MCP 도구 |
--permission-prompts | -p 승인 응답자 host·none |
--plugin-dir | 로컬 plugin 경로·zip·상위 폴더 |
--plugin-url | 이번 세션 plugin archive URL |
--print, -p | 비대화형 응답 출력 |
--prompt-suggestions | 다음 요청 제안 event; -p·stream-json·verbose 필요 |
--ref <branch> | --environment checkout 기준 ref |
--remote | deprecated; --cloud 별칭 |
--remote-control, --rc | 대화형 세션의 Remote Control |
--remote-control-session-name-prefix <prefix> | 자동 remote session 이름 접두사 |
--replay-user-messages | stream-json 사용자 메시지 재출력 |
--restricted | 평가용 restricted profile |
--resume, -r | ID·이름·transcript로 세션 재개 |
--safe-mode | 사용자화 해제 후 설정 장애 진단 |
--session-id | 명시적 UUID |
--setting-sources | user·project·local 설정 출처 선택 |
--settings | JSON 파일 또는 inline 설정 덮어쓰기 |
--strict-mcp-config | 명시한 MCP 설정만 사용; managed 정책 확인 |
--system-prompt | system prompt 교체 |
--system-prompt-file | 파일로 system prompt 교체 |
--system-prompt-snapshot | off로 request마다 prompt 재구성 |
--teleport | cloud session을 local로 재개 |
--teammate-mode | teammate 표시 방식 |
--tmux | worktree용 tmux; --worktree 필요 |
--tools | 사용 가능한 built-in tool 제한 |
--verbose | 상세 실행 출력 |
--version, -v | 설치 버전 출력 |
--worktree, -w | 격리 git worktree 생성 |
하위 명령과 최신 옵션
| 명령 | 옵션·구분 |
|---|---|
claude auto-mode config | effective classifier 설정 |
claude plugin install / claude plugin update | --json, --accept-command <sha256> (v2.1.271+) |
/plugin install <plugin> --marketplace <source> | marketplace 등록 제안 (v2.1.275+) |
claude plugin eval | JSON·HTML 평가 결과 |
claude self-hosted-runner setup | 운영 설정 walkthrough |
claude self-hosted-runner doctor | 배포된 runner 진단 |
claude self-hosted-runner orchestrator | on-demand runner 생성 |
claude self-hosted-runner --drain-marker-file <path> | SIGTERM 시 파일이 있으면 host drain으로 보고; telemetry 전용 (v2.1.271+) |
--accept-command에는 앞선 --json 실행이 제시한 명령의 SHA-256을 넣습니다. 출력 내용을 검토한 뒤 그 명령만 승인하는 방식이며, 임의 값이나 포괄적 -y로 대체하지 않습니다.
명령별 운영 옵션
| 명령 | 추가 옵션과 적용 범위 |
|---|---|
claude agents | --cwd <path> 필터, --json, --json --all로 완료 세션 포함; dispatch 기본값은 --permission-mode, --model, --effort, --agent |
claude auto-mode reset | -y / --yes로 사용자 설정 초기화 확인 생략; managed 규칙은 유지 |
claude respawn <id> | --all로 실행 중인 background session 전체 재시작 |
claude rm <id> | 거절 출력이 제시한 --discard-unpushed <commit>@<worktree-id> 또는 --force-remove-worktree <worktree-id>를 확인 후 사용; 전자는 미전송 commit도 삭제 |
claude project purge [path] | --dry-run, -i / --interactive, -y / --yes, --all; 먼저 미리보기 |
claude ultrareview [target] | --json, --timeout <minutes>(기본 45분), --post / --no-post(기본). --post는 github.com PR에 사용자 계정으로 댓글 게시 |
실행 예
claude --version
claude auth status --text
claude doctor
claude import cursor --dry-run
claude auto-mode config
claude -p "Explain this repository" --max-turns 3 --output-format json-p 예시는 모델을 호출합니다. /doctor는 세션 안에서 수정도 수행하는 skill이고 claude doctor는 읽기 전용 진단입니다. --allowedTools는 승인 규칙이며, 도구 목록 제한은 --tools로 합니다. --bare와 --safe-mode는 탐색·장애 진단 목적이 다르므로 서로 바꿔 쓰지 않습니다.
출처
출력·예산 플래그 재검증
--forward-subagent-text의 parent_tool_use_id는 해당 작업을 시작한 Agent 또는 Skill 호출을 가리킵니다. fork된 skill이 만든 하위 agent와 중첩 fork skill의 메시지 전달에는 v2.1.275 이상이 필요합니다.
--max-budget-usd는 subagent 비용을 포함하지만, --continue·--resume으로 복원한 이전 실행의 누적 비용은 이번 실행 한도에 합산하지 않습니다.