참조
CLI 참조
참조
CLI 참조
Claude Code 명령줄 인터페이스의 완전한 참조, 명령어와 플래그 포함.
CLI 명령어
| 명령어 | 설명 | 예시 |
|---|---|---|
claude | 대화형 REPL 시작 | claude |
claude "query" | 초기 프롬프트와 함께 REPL 시작 | claude "explain this project" |
claude -p "query" | SDK를 통해 쿼리 후 종료 | claude -p "explain this function" |
cat file | claude -p "query" | 파이프된 콘텐츠 처리 | cat logs.txt | claude -p "explain" |
claude -c | 가장 최근 대화 계속하기 | claude -c |
claude -c -p "query" | SDK를 통해 계속하기 | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | ID로 세션 재개 | claude -r "abc123" "Finish this PR" |
claude update | 최신 버전으로 업데이트 | claude update |
claude mcp | Model Context Protocol (MCP) 서버 구성 | Claude Code 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 "query" |
--output-format | 출력 모드의 출력 형식 지정 (옵션: text, json, stream-json) | claude -p "query" --output-format json |
--input-format | 출력 모드의 입력 형식 지정 (옵션: text, stream-json) | claude -p --output-format json --input-format stream-json |
--verbose | 상세 로깅 활성화, 전체 턴별 출력 표시 (출력 및 대화형 모드 모두에서 디버깅에 유용) | claude --verbose |
--max-turns | 비대화형 모드에서 에이전트 턴 수 제한 | claude -p --max-turns 3 "query" |
--model | 최신 모델의 별칭(sonnet 또는 opus) 또는 모델의 전체 이름으로 현재 세션의 모델 설정 | claude --model claude-sonnet-4-20250514 |
--permission-prompt-tool | 비대화형 모드에서 권한 프롬프트를 처리할 MCP 도구 지정 | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--resume | ID로 특정 세션 재개, 또는 대화형 모드에서 선택 | claude --resume abc123 "query" |
--continue | 현재 디렉토리에서 가장 최근 대화 로드 | claude --continue |
--dangerously-skip-permissions | 권한 프롬프트 건너뛰기 (주의해서 사용) | claude --dangerously-skip-permissions |
--output-format json 플래그는 스크립팅과 자동화에 특히 유용하며,
Claude의 응답을 프로그래밍 방식으로 파싱할 수 있게 해줍니다.
출력 형식, 스트리밍, 상세 로깅, 프로그래밍 방식 사용을 포함한 출력 모드(-p)에 대한 자세한 정보는
SDK 문서를 참조하세요.