--add-dir | Claude가 파일을 읽고 편집할 수 있도록 추가 작업 디렉터리를 추가합니다. 파일 액세스 권한을 부여합니다. Claude Code는 이러한 디렉터리에서 대부분의 .claude/ 구성을 검색하지 않습니다. 각 경로가 디렉터리로 존재하는지 검증합니다. \\server\share와 같은 대부분의 네트워크 경로를 추가할 수 없습니다. 이러한 디렉터리를 세션 간에 유지하려면 설정에서 permissions.additionalDirectories를 설정합니다 | claude --add-dir ../apps ../lib |
--advisor <model> | 이 세션에 대해 모델 별칭 fable, opus 또는 sonnet, 또는 전체 모델 ID를 사용하여 서버 측 advisor 도구를 활성화합니다. 세션에 대해 advisorModel 설정보다 우선합니다. fable은 Fable 액세스가 필요합니다 | claude --advisor opus |
--agent | 현재 세션에 대한 에이전트를 지정합니다(agent 설정 재정의) | claude --agent my-custom-agent |
--agents | JSON을 통해 사용자 정의 서브에이전트를 동적으로 정의합니다. CLI 정의 서브에이전트에 대해 나열된 필드를 허용합니다. Claude Code는 시작 시 JSON을 검증하고 잘못된 값에서 종료합니다. 메시지 및 검증을 건너뛰는 플래그와 환경 변수는 Invalid --agents configuration을 참조하세요. 검증에는 Claude Code v2.1.242 이상이 필요합니다 | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allow-dangerously-skip-permissions | Shift+Tab 모드 사이클에 bypassPermissions를 추가하되 시작하지 않습니다. plan과 같은 다른 모드에서 시작하고 나중에 bypassPermissions로 전환할 수 있습니다. 권한 모드를 참조하세요 | claude --permission-mode plan --allow-dangerously-skip-permissions |
--allowedTools, --allowed-tools | 권한을 묻지 않고 실행되는 도구입니다. 패턴 매칭에 대해 권한 규칙 구문을 참조하세요. 사용 가능한 도구를 제한하려면 대신 --tools를 사용하세요. 작업 추적 도구 중 하나를 여기에 이름 지으면 Claude Code도 세션을 옵트인합니다 | "Bash(git log *)" "Bash(git diff *)" "Read" |
--append-subagent-system-prompt | 포크된 서브에이전트를 제외한 모든 서브에이전트의 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다. 포크된 서브에이전트는 대화 자체의 프롬프트를 재사용합니다. 중첩된 서브에이전트를 포함합니다. -p를 사용한 비대화형 모드에서만 적용됩니다. Claude Code v2.1.205 이상이 필요합니다 | claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query" |
--append-subagent-system-prompt-file | 파일에서 텍스트를 로드하고 서브에이전트 시스템 프롬프트에 추가합니다. 명령줄에 전달하기에 너무 긴 텍스트의 경우 --append-subagent-system-prompt의 대안입니다. 두 플래그를 결합할 수 없습니다. -p를 사용한 비대화형 모드에서만 적용됩니다. Claude Code v2.1.261 이상이 필요합니다 | claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query" |
--append-system-prompt | 기본 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다 | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file | 파일에서 추가 시스템 프롬프트 텍스트를 로드하고 기본 프롬프트에 추가합니다 | claude --append-system-prompt-file ./extra-rules.txt |
--autocompact <auto|tokens> | 저장된 설정을 변경하지 않고 이 세션에 대해 auto-compact 윈도우를 설정합니다. /autocompact와 동일한 값을 허용합니다. 해당 섹션에서 값 형식과 플래그를 재정의하는 것을 다룹니다. Claude Code v2.1.221 이상이 필요합니다 | claude --autocompact 500k |
--ax-screen-reader | 스크린 리더 친화적 출력을 렌더링합니다: 장식 테두리나 애니메이션 없는 평면 텍스트입니다. 클래식 렌더러를 강제하므로 tui 설정은 효과가 없습니다. 연결된 백그라운드 세션은 여전히 전체 화면으로 렌더링됩니다. CLAUDE_AX_SCREEN_READER 및 axScreenReader 설정보다 우선합니다. Claude Code v2.1.181 이상이 필요합니다 | claude --ax-screen-reader |
--bare | 최소 모드: 훅, 스킬, 사용자 정의 명령, 서브에이전트, 설치된 플러그인, MCP 서버, 자동 메모리 및 CLAUDE.md의 자동 검색을 건너뜁니다. 스크립트된 호출이 더 빠르게 시작됩니다. --add-dir로 전달하는 디렉터리의 스킬은 여전히 로드됩니다. Claude는 Bash, 파일 읽기 및 파일 편집 도구에 액세스할 수 있습니다. CLAUDE_CODE_SIMPLE을 설정합니다. 베어 모드를 참조하세요 | claude --bare -p "query" |
--betas | API 요청에 포함할 베타 헤더입니다(API 키 사용자만 해당) | claude --betas interleaved-thinking |
--bg, --background | 세션을 백그라운드 에이전트로 시작하고 즉시 반환합니다. 세션 ID 및 관리 명령을 인쇄합니다. --exec와 결합하여 Claude 세션 대신 셸 명령을 백그라운드 작업으로 실행하거나, --agent와 결합하여 특정 서브에이전트를 실행합니다. -p/--print와 결합할 수 없습니다. 오류 참조를 참조하세요 | claude --bg "investigate the flaky test" |
--channels | (연구 미리보기) Claude가 이 세션에서 수신해야 하는 채널 알림이 있는 MCP 서버입니다. plugin:<name>@<marketplace> 항목의 공백으로 구분된 목록입니다. claude.ai 또는 Console API 키를 통한 Anthropic 인증이 필요합니다 | claude --channels plugin:my-notifier@my-marketplace |
--chrome | 웹 자동화 및 테스트를 위해 Chrome 브라우저 통합을 활성화합니다 | claude --chrome |
--cloud | 작업 설명을 사용하여 새 클라우드 세션을 만듭니다. 세션 ID(session_... 또는 cse_...) 또는 claude.ai/code URL을 사용하여 -p로 기존 세션에 메시지를 대기열에 넣습니다. 후속 메시지 전송을 참조하세요. | claude --cloud "Fix the login bug" |
--continue, -c | 현재 디렉터리에서 가장 최근 대화를 로드합니다. 완료된 백그라운드 세션을 포함합니다. 완료된 백그라운드 세션을 열려면 Claude Code v2.1.257 이상이 필요합니다. claude -p 또는 Agent SDK로 생성된 세션과 첫 번째 프롬프트가 /loop인 세션을 건너뜁니다. claude -p --continue는 -p, SDK 및 /loop 세션을 포함합니다. 이 디렉터리를 /add-dir로 추가한 세션을 포함합니다 | claude --continue |
--dangerously-load-development-channels | 로컬 개발을 위해 승인된 허용 목록에 없는 채널을 활성화합니다. plugin:<name>@<marketplace> 및 server:<name> 항목을 허용합니다. 확인을 요청합니다 | claude --dangerously-load-development-channels server:webhook |
--dangerously-skip-permissions | 권한 프롬프트를 건너뜁니다. --permission-mode bypassPermissions과 동등합니다. 이것이 건너뛰는 것과 건너뛰지 않는 것에 대해 권한 모드를 참조하세요. --bg로 시작된 세션의 경우, 모드는 감독자가 세션을 다시 시작할 때 유지됩니다 | claude --dangerously-skip-permissions |
--debug | --debug='mcp,startup' 또는 --debug='!1p'와 같은 선택적 카테고리 필터링으로 디버그 모드를 활성화합니다. 필터는 = 형식에서만 바인딩됩니다. 공백으로 구분된 필터는 필터링 없이 디버그 모드를 활성화합니다 | claude --debug='mcp,startup' |
--debug-file <path> | 특정 파일 경로에 디버그 로그를 작성합니다. 암묵적으로 디버그 모드를 활성화합니다. CLAUDE_CODE_DEBUG_LOGS_DIR보다 우선합니다 | claude --debug-file /tmp/claude-debug.log |
--disable-slash-commands | 이 세션에 대해 모든 스킬 및 명령을 비활성화합니다 | claude --disable-slash-commands |
--disallowedTools, --disallowed-tools | 거부 규칙입니다. 베어 도구 이름은 Claude의 컨텍스트에서 일치하는 도구를 제거합니다: "Edit"는 Edit를 제거하고, "*"는 모든 도구를 제거하며, "mcp__*"는 모든 MCP 도구를 제거합니다. Bash(rm *)와 같은 범위 지정 규칙은 도구를 사용 가능하게 두고 작성된 대로 일치하는 호출만 거부합니다. EndConversation을 이름 지은 규칙은 다른 도구가 남아 있는 동안 제거할 수 없습니다 | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort | 현재 세션에 대해 노력 수준을 설정합니다. 옵션: low, medium, high, xhigh, max 또는 ultracode입니다. 사용 가능한 수준은 모델에 따라 다릅니다. ultracode는 ultracode가 켜진 상태에서 xhigh 노력을 요청하며, Claude Code v2.1.203 이상이 필요합니다. 이 세션에 대해 modelSettings 및 effortLevel 설정을 재정의하고 유지되지 않습니다 | claude --effort high |
--enable-auto-mode | v2.1.111에서 제거됨. 자동 모드는 이제 Shift+Tab 사이클에 기본적으로 있습니다. --permission-mode auto를 사용하여 시작합니다 | claude --permission-mode auto |
--environment <environment-id> | 주어진 ID를 가진 자체 호스팅 환경에서 실행되는 새 클라우드 세션을 만듭니다. 환경 ID는 ccpool_로 시작합니다. 디스패치 동작 및 거부하는 플래그 조합에 대해 --environment 디스패치 동작을 참조하세요. Claude Code v2.1.224 이상이 필요합니다 | claude -p "Fix the login bug" --environment ccpool_abc123 |
--exclude-dynamic-system-prompt-sections | 시스템 프롬프트의 머신별 섹션(작업 디렉터리, 환경 정보, 메모리 경로, git-repo 플래그)을 첫 번째 사용자 메시지로 이동합니다. 동일한 작업을 실행하는 다양한 사용자 및 머신 간에 프롬프트 캐시 재사용을 개선합니다. 기본 시스템 프롬프트에만 적용됩니다. --system-prompt 또는 --system-prompt-file이 설정되면 무시됩니다. 스크립트된 다중 사용자 워크로드에 -p와 함께 사용합니다 | claude -p --exclude-dynamic-system-prompt-sections "query" |
--exec | Claude 세션을 시작하는 대신 PTY 지원 백그라운드 작업으로 셸 명령을 실행합니다. 셸에서 시작하려면 --bg와 함께 사용합니다 | claude --bg --exec 'pytest -x' |
--fallback-model | 기본 모델이 과부하되거나 사용할 수 없을 때(예: 폐기된 모델) 지정된 모델로 자동 폴백을 활성화합니다. 순서대로 시도되는 쉼표로 구분된 목록을 허용합니다. 폴백 모델 체인을 참조하세요. 세션 간에 체인을 유지하려면 이 플래그가 재정의하는 fallbackModel 설정을 사용합니다 | claude --fallback-model sonnet,haiku |
--fork-session | 재개할 때 원본을 재사용하는 대신 새 세션 ID를 만듭니다(--resume 또는 --continue와 함께 사용) | claude --resume abc123 --fork-session |
--forward-subagent-text | 서브에이전트 텍스트 및 사고 블록을 parent_tool_use_id 설정된 assistant 및 user 메시지로 출력 스트림에 내보내므로 각 서브에이전트의 트랜스크립트를 재구성할 수 있습니다. 이 플래그 없이 Claude Code는 포그라운드에서 실행되는 서브에이전트의 텍스트 및 사고 블록을 생략합니다. --print 및 --output-format stream-json이 필요합니다. Claude Code는 또한 중첩된 서브에이전트의 메시지를 전달하며, 각 메시지를 생성한 Agent 또는 Skill 도구 호출의 ID로 parent_tool_use_id를 설정합니다. 이는 Claude Code v2.1.219 이상이 필요합니다. 포크된 스킬이 생성한 서브에이전트의 메시지와 중첩된 포크된 스킬의 메시지는 v2.1.275 이상이 필요합니다. CLAUDE_CODE_FORWARD_SUBAGENT_TEXT 환경 변수는 동일한 동작을 활성화합니다. Claude Code v2.1.211 이상이 필요합니다 | claude -p --output-format stream-json --verbose --forward-subagent-text "query" |
--from-pr | 특정 풀 요청에 연결된 세션으로 필터링된 세션 선택기를 엽니다. PR 번호, GitHub 또는 GitHub Enterprise PR URL, GitLab 병합 요청 URL 또는 Bitbucket 풀 요청 URL을 허용합니다. Claude가 풀 요청을 만들 때 세션이 자동으로 연결됩니다 | claude --from-pr 123 |
--ide | 정확히 하나의 유효한 IDE를 사용할 수 있는 경우 시작 시 IDE에 자동으로 연결합니다 | claude --ide |
--init | init 매처를 사용하여 세션 전에 Setup 훅을 실행합니다(인쇄 모드만 해당) | claude -p --init "query" |
--init-only | Setup 및 SessionStart 훅을 실행한 다음 대화를 시작하지 않고 종료합니다 | claude --init-only |
--include-hook-events | 훅 수명 주기 이벤트를 출력 스트림에 포함합니다. SessionStart 및 Setup 훅 이벤트는 항상 포함되며 이 플래그가 필요하지 않습니다. Notification, SessionEnd, PreCompact 및 PostCompact와 같은 일부 훅 이벤트는 이 플래그를 사용하더라도 hook_started 이벤트를 생성하지 않습니다. 이러한 이벤트의 경우 Claude Code는 여전히 hook_progress를 내보내며, 1초 이상 실행되는 명령 훅은 출력을 생성하고, 백그라운드에서 실행되는 훅이 완료될 때만 hook_response를 내보냅니다. --output-format stream-json이 필요합니다 | claude -p --output-format stream-json --verbose --include-hook-events "query" |
--include-partial-messages | 출력에 부분 스트리밍 이벤트를 포함합니다. --print 및 --output-format stream-json이 필요합니다 | claude -p --output-format stream-json --verbose --include-partial-messages "query" |
--input-format | 인쇄 모드에 대한 입력 형식을 지정합니다(옵션: text, stream-json) | claude -p --output-format json --input-format stream-json |
--json-schema | 에이전트가 워크플로우를 완료한 후 JSON 스키마와 일치하는 검증된 JSON 출력을 가져옵니다(인쇄 모드만 해당). 구조화된 출력을 참조하세요. Claude Code는 잘못된 스키마에서 오류로 종료되고 클라이언트 측 검증 없이 주석으로 format 키워드를 허용합니다 | claude -p --json-schema '{"type":"object","properties":{...}}' "query" |
--maintenance | maintenance 매처를 사용하여 세션 전에 Setup 훅을 실행합니다(인쇄 모드만 해당) | claude -p --maintenance "query" |
--max-budget-usd | API 호출에 지출할 최대 달러 금액입니다. 중지하기 전에 지출합니다(인쇄 모드만 해당). 서브에이전트의 지출이 한도에 포함됩니다. --continue 또는 --resume으로 대화로 돌아올 때 이전 실행에서 복원된 합계는 이에 포함되지 않습니다. 지출이 한도에 도달하면 다른 서브에이전트를 생성하면 Budget limit reached로 실패하고 Claude Code는 여전히 실행 중인 백그라운드 서브에이전트를 중지합니다. 한도 적용 동작에는 Claude Code v2.1.217 이상이 필요합니다 | claude -p --max-budget-usd 5.00 "query" |
--max-turns | 에이전트 턴의 수를 제한합니다(인쇄 모드만 해당). 한도에 도달하면 오류로 종료됩니다. 기본적으로 제한이 없습니다. --input-format stream-json을 사용하면 한도가 턴을 끝낼 때 여전히 대기열에 있는 메시지는 대기열에 남아 있고 자체 한도로 새 턴을 시작합니다 | claude -p --max-turns 3 "query" |
--mcp-config | JSON 파일 또는 문자열에서 MCP 서버를 로드합니다(공백으로 구분). 이 플래그를 -p와 함께 전달하면 Claude Code는 첫 번째 턴을 실행하기 전에 여전히 보류 중인 서버가 연결될 때까지 기다립니다. MCP_TIMEOUT 시작 시간 초과(기본값 30초)까지입니다. 캐시된 도구 목록이 있는 서버는 대기를 건너뛰고 처음 사용할 때 연결됩니다. 대기에는 Claude Code v2.1.221 이상이 필요합니다 | claude --mcp-config ./mcp.json |
--model | sonnet, opus, haiku 또는 fable과 같은 모델 별칭 또는 모델의 전체 이름으로 현재 세션에 대한 모델을 설정합니다. model 설정 및 ANTHROPIC_MODEL을 재정의합니다 | claude --model claude-sonnet-5 |
--name, -n | 세션의 표시 이름을 설정합니다. /resume 및 터미널 제목에 표시됩니다. claude --resume <name>으로 명명된 세션을 재개할 수 있습니다. 대화형 세션에서 이 머신의 다른 라이브 세션이 이미 이름을 사용하는 경우 Claude Code는 그 변형을 적용합니다.
/rename은 세션 중에 이름을 변경하고 프롬프트 표시줄에도 표시합니다 | claude -n "my-feature-work" |
--no-chrome | 이 세션에 대해 Chrome 브라우저 통합을 비활성화합니다 | claude --no-chrome |
--no-session-persistence | 세션 지속성을 비활성화하므로 세션이 디스크에 저장되지 않고 재개할 수 없습니다. 인쇄 모드만 해당입니다. CLAUDE_CODE_SKIP_PROMPT_HISTORY 환경 변수는 모든 모드에서 동일한 작업을 수행합니다 | claude -p --no-session-persistence "query" |
--output-format | 인쇄 모드에 대한 출력 형식을 지정합니다(옵션: text, json, stream-json) | claude -p "query" --output-format json |
--permission-mode | 지정된 권한 모드에서 시작합니다. default, acceptEdits, plan, auto, dontAsk, bypassPermissions 또는 manual을 default의 별칭으로 허용합니다. manual 별칭은 UI가 Manual로 레이블 지정하는 권한 모드를 선택하며 Claude Code v2.1.200 이상이 필요합니다. claude --help는 default 대신 이를 나열하고 두 값 모두 작동합니다. 설정 파일의 defaultMode를 재정의합니다. 이 플래그 또는 --dangerously-skip-permissions 없이 새 세션은 세션이 시작되는 권한 모드에 설명된 권한 모드에서 시작됩니다. -p의 경우 아무것도 구성되지 않으면 default입니다 | claude --permission-mode plan |
--permission-prompt-tool | 비대화형 모드에서 권한 프롬프트를 처리할 MCP 도구를 지정합니다. Claude Code는 첫 번째 턴을 실행하기 전에 해당 도구의 MCP 서버가 연결될 때까지 기다립니다. MCP_TIMEOUT 시작 시간 초과(기본값 30초)까지입니다.
프롬프트 도구는 사용자 상호 작용이 필요한 것으로 표시된 MCP 도구를 승인할 수 없습니다. Claude Code는 하나에 대한 allow 결과를 거부로 변환합니다. 이 제한에는 Claude Code v2.1.199 이상이 필요합니다 | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--permission-prompts | 인쇄 모드에서 권한 프롬프트에 응답하는 사람을 설정합니다. 기본 host를 사용하면 Claude Code는 Agent SDK 호스트 또는 --permission-prompt-tool 도구로 보냅니다. 아무도 응답할 수 없을 때 none을 전달하면 Claude Code는 대신 거부합니다. 무인 실행에서 권한 프롬프트 끄기를 참조하세요. Claude Code v2.1.259 이상이 필요합니다 | claude -p --permission-prompts none "query" |
--plugin-dir | 이 세션에만 디렉터리 또는 .zip 아카이브에서 플러그인을 로드하거나 플러그인 폴더에서 여러 개를 로드합니다. 각 플래그는 하나의 경로를 사용합니다. 더 많은 경로에 대해 플래그를 반복합니다: --plugin-dir A --plugin-dir B.zip. 플러그인 폴더를 전달하려면 Claude Code v2.1.265 이상이 필요합니다 | claude --plugin-dir ./my-plugin |
--plugin-url | 이 세션에만 URL에서 플러그인 .zip 아카이브를 가져옵니다. 여러 플러그인에 대해 플래그를 반복하거나 단일 따옴표 값에 공백으로 구분된 URL을 전달합니다 | claude --plugin-url https://example.com/plugin.zip |
--print, -p | 대화형 모드 없이 응답을 인쇄합니다(프로그래밍 방식 사용에 대한 Agent SDK 문서 참조) | claude -p "query" |
--prompt-suggestions | 각 턴 후에 예측된 다음 사용자 프롬프트를 사용하여 prompt_suggestion 메시지를 내보냅니다. 매우 짧은 대화는 없을 수 있습니다. --print, --output-format stream-json 및 --verbose가 필요합니다. 프롬프트 제안을 참조하세요 | claude -p --prompt-suggestions --output-format stream-json --verbose "query" |
--ref <branch> | --environment를 사용하면 새 세션의 체크아웃을 로컬 HEAD 대신 명명된 ref를 기반으로 합니다 | claude -p "Run the smoke test" --environment ccpool_abc123 --ref main |
--remote | --cloud의 더 이상 사용되지 않는 별칭. 기존 세션 형식 포함 | claude --remote "Fix the login bug" |
--remote-control, --rc | Remote Control이 활성화된 대화형 세션을 시작하므로 claude.ai 또는 Claude 앱에서도 제어할 수 있습니다. 선택적으로 세션의 이름을 전달합니다 | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> | 명시적 이름이 설정되지 않은 경우 자동 생성된 Remote Control 세션 이름의 접두사입니다. 기본값은 머신의 호스트 이름이며 myhost-graceful-unicorn과 같은 이름을 생성합니다. 동일한 효과를 위해 CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX를 설정합니다 | claude remote-control --remote-control-session-name-prefix dev-box |
--replay-user-messages | stdin에서 사용자 메시지를 다시 내보내 stdout으로 승인합니다. --input-format stream-json 및 --output-format stream-json이 필요합니다 | claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages |
--restricted | 제한된 모드에서 시작합니다. 평가 하네스가 공유 머신에서 claude를 구동하고 Claude Code가 해당 머신의 명령을 실행하거나 사용자 및 프로젝트 설정을 읽지 않아야 할 때 사용합니다. Claude Code는 명령을 실행하거나 코드를 실행하는 기본 제공 도구와 WebFetch를 제거합니다. --tools에서 개별적으로 이름을 지정하지 않는 한 default 사전 설정을 통해서는 제거합니다. 또한 기본 제공 파일 도구를 작업 디렉터리로 제한하고, 관리되는 설정 및 --settings만 로드하며, bypassPermissions를 거부하고, 제한된 세션에서 클라우드 세션을 만드는 것을 거부합니다. Claude Code v2.1.248 이상이 필요합니다 | claude --restricted -p "query" |
--resume, -r | ID 또는 이름으로 특정 세션을 재개하거나 세션을 선택할 대화형 선택기를 표시합니다. ID 대신 세션의 .jsonl 트랜스크립트 파일의 절대 경로를 전달할 수 있습니다. 선택기 및 이름 검색에는 이 디렉터리를 /add-dir로 추가한 세션이 포함됩니다. 세션 ID를 전달하면 Claude Code는 현재 프로젝트 디렉터리 및 해당 git 워크트리를 검색한 다음 이 머신의 다른 모든 프로젝트를 검색합니다. v2.1.223 이전에는 ID 검색이 현재 프로젝트 디렉터리 및 해당 git 워크트리만 다루었습니다. 백그라운드 세션은 bg로 표시된 선택기에 나타납니다 | claude --resume auth-refactor |
--safe-mode | 손상된 구성을 문제 해결하기 위해 모든 사용자 정의를 비활성화하여 시작합니다: CLAUDE.md, 스킬, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버 및 자동 메모리는 로드되지 않습니다. 인증, 모델 선택, 기본 제공 도구 및 권한은 정상적으로 작동하며, 이는 --bare와 다릅니다. 관리되는 설정 정책은 여전히 적용되며, 정책 구성 훅, 상태 줄 및 파일 제안 명령을 포함합니다. 관리되는 플러그인, 관리되는 스킬, 관리되는 CLAUDE.md 및 정책 구성 MCP 서버는 포함되지 않습니다. 자동 모델 폴백을 트리거하는 사용자 정의를 확인하는 데 유용합니다. CLAUDE_CODE_SAFE_MODE를 설정합니다 | claude --safe-mode |
--session-id | 대화에 특정 세션 ID를 사용합니다(유효한 UUID여야 함) | claude --session-id "550e8400-e29b-41d4-a716-446655440000" |
--setting-sources | 로드할 설정 소스의 쉼표로 구분된 목록(user, project, local) | claude --setting-sources user,project |
--settings | 설정 JSON 파일 또는 인라인 JSON 문자열의 경로입니다. 여기서 설정한 값은 이 세션에 대해 settings.json 파일의 동일한 키를 재정의합니다. 생략한 키는 파일 기반 값을 유지합니다. 파일은 2 MiB 이하의 일반 파일이어야 합니다. 설정 우선 순위를 참조하세요 | claude --settings ./settings.json |
--strict-mcp-config | --mcp-config의 MCP 서버만 사용하고 다른 모든 MCP 구성을 무시합니다. 관리되는 MCP 파일에서 플래그가 수행하는 작업에 대해 managed-mcp.json으로 독점 제어를 참조하세요 | claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt | 전체 시스템 프롬프트를 사용자 정의 텍스트로 바꿉니다 | claude --system-prompt "You are a Python expert" |
--system-prompt-file | 파일에서 시스템 프롬프트를 로드하여 기본 프롬프트를 바꿉니다 | claude --system-prompt-file ./custom-prompt.txt |
--system-prompt-snapshot | off를 전달하여 대화의 첫 번째 요청에 기록된 프롬프트를 재사용하는 대신 모든 요청에서 시스템 프롬프트를 다시 빌드합니다. 예를 들어 --continue 실행 간에 --append-system-prompt 텍스트를 반복할 때입니다. Claude Code v2.1.257 이상이 필요합니다 | claude --system-prompt-snapshot off |
--teleport | 로컬 터미널에서 클라우드 세션을 재개합니다 | claude --teleport |
--teammate-mode | 에이전트 팀 팀원이 표시되는 방식을 설정합니다: in-process(기본값), auto, tmux 또는 iterm2. 이 세션에 대해 teammateMode 설정을 재정의합니다. 디스플레이 모드 선택을 참조하세요 | claude --teammate-mode auto |
--tmux | 워크트리에 대한 tmux 세션을 만듭니다. --worktree가 필요합니다. 사용 가능할 때 iTerm2 네이티브 창을 사용합니다. 기존 tmux의 경우 --tmux=classic을 전달합니다 | claude -w feature-auth --tmux |
--tools | Claude가 사용할 수 있는 기본 제공 도구를 제한합니다. 모두 비활성화하려면 "", 기본 집합의 경우 "default" 또는 "Bash,Edit,Read"와 같은 도구 이름을 사용합니다. macOS, Linux 및 WSL에서 기본 집합은 Glob 도구 동작에 설명된 대로 Glob 및 Grep을 제외합니다. 작업 추적 도구 중 하나를 여기에 이름 지으면 Claude Code도 세션을 옵트인합니다. 플래그는 MCP 도구에 영향을 주지 않습니다. 이들도 거부하려면 --disallowedTools "mcp__*"를 사용합니다. EndConversation을 생략하는 목록은 제거하지 않습니다. ""는 MCP 도구가 남아 있지 않을 때만 제거합니다 | claude --tools "Bash,Edit,Read" |
--verbose | 자세한 로깅을 활성화하고 전체 턴별 출력을 표시합니다. 이 세션에 대해 viewMode 설정을 재정의합니다 | claude --verbose |
--version, -v | 버전 번호를 출력합니다 | claude -v |
--worktree, -w | Claude를 <repo>/.claude/worktrees/<name>의 격리된 git 워크트리에서 시작합니다. 이름을 지정하지 않으면 Claude Code가 생성합니다. #<number>, GitHub 풀 요청 URL 또는 GitLab 병합 요청 URL을 전달하여 해당 PR 또는 MR을 origin에서 가져오고 워크트리를 분기합니다. GitLab 병합 요청에서 분기하려면 Claude Code v2.1.233 이상이 필요합니다 | claude -w feature-auth |
