57 CLI 플래그57 CLI 플래그

58</h2>58</h2>

59 59 

60이러한 명령줄 플래그를 사용하여 Claude Code의 동작을 사용자 정의합니다. `claude --help`는 모든 플래그를 나열하지 않으므로, `--help`에 플래그가 없다고 해서 사용할 수 없다는 의미는 아닙니다.60Claude Code의 동작을 이러한 명령줄 플래그로 사용자 정의합니다. `claude --help`는 모든 플래그를 나열하지 않으므로, 플래그가 `--help`에 없다고 해서 사용할 수 없다는 의미는 아닙니다.

61 61 

62| 플래그 | 설명 | 예시 |62| 플래그 | 설명 | 예시 |

63| :---------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |63| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |

64| `--add-dir` | Claude가 파일을 읽고 편집할 수 있는 추가 작업 디렉토리를 추가합니다. 파일 액세스를 부여합니다. Claude Code는 이러한 디렉토리에서 [대부분의 `.claude/` 구성을 검색하지 않습니다](/docs/ko/permissions#additional-directories-grant-file-access-not-configuration). 각 경로가 디렉토리로 존재하는지 검증합니다. 대부분의 [네트워크 경로](/docs/ko/errors#working-directory-is-a-network-path)(예: `\\server\share`)를 추가할 수 없습니다. 이러한 디렉토리를 세션 간에 유지하려면 설정에서 [`permissions.additionalDirectories`](/docs/ko/settings-reference#permissions-additionaldirectories)를 설정합니다 | `claude --add-dir ../apps ../lib` |64| `--add-dir` | Claude가 파일을 읽고 편집할 수 있도록 추가 작업 디렉터리를 추가합니다. 파일 액세스 권한을 부여합니다. Claude Code는 이러한 디렉터리에서 대부분의 `.claude/` 구성을 [검색하지 않습니다](/docs/ko/permissions#additional-directories-grant-file-access-not-configuration). 각 경로가 디렉터리로 존재하는지 검증합니다. `\\server\share`와 같은 대부분의 [네트워크 경로](/docs/ko/errors#working-directory-is-a-network-path)를 추가할 수 없습니다. 이러한 디렉터리를 세션 간에 유지하려면 설정에서 [`permissions.additionalDirectories`](/docs/ko/settings-reference#permissions-additionaldirectories)를 설정합니다 | `claude --add-dir ../apps ../lib` |

65| `--advisor <model>` | 이 세션에 대해 서버 측 [advisor 도구](/docs/ko/advisor)를 활성화합니다. 모델 별칭 `fable`, `opus` 또는 `sonnet`, 또는 전체 모델 ID를 사용합니다. `advisorModel` 설정보다 우선합니다. `fable`은 [Fable 액세스](/docs/ko/advisor#choose-an-advisor-model)가 필요합니다 | `claude --advisor opus` |65| `--advisor <model>` | 이 세션에 대해 모델 별칭 `fable`, `opus` 또는 `sonnet`, 또는 전체 모델 ID를 사용하여 서버 측 [advisor 도구](/docs/ko/advisor)를 활성화합니다. 세션에 대해 `advisorModel` 설정보다 우선합니다. `fable`은 [Fable 액세스](/docs/ko/advisor#choose-an-advisor-model)가 필요합니다 | `claude --advisor opus` |

66| `--agent` | 현재 세션에 대한 에이전트를 지정합니다(`agent` 설정 재정의) | `claude --agent my-custom-agent` |66| `--agent` | 현재 세션에 대한 에이전트를 지정합니다(`agent` 설정 재정의) | `claude --agent my-custom-agent` |

67| `--agents` | JSON을 통해 사용자 정의 subagents를 동적으로 정의합니다. [CLI 정의 subagents에 대해 나열된 필드](/docs/ko/sub-agents#choose-the-subagent-scope)를 허용합니다. Claude Code는 시작 시 JSON을 검증하고 잘못된 값에서 종료합니다. [`Invalid --agents configuration`](/docs/ko/errors#invalid-agents-configuration)에서 메시지와 검증을 건너뛰는 플래그 및 환경 변수를 참조하세요. 검증에는 Claude Code v2.1.242 이상이 필요합니다 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |67| `--agents` | JSON을 통해 사용자 정의 서브에이전트를 동적으로 정의합니다. [CLI 정의 서브에이전트에 대해 나열된 필드](/docs/ko/sub-agents#choose-the-subagent-scope)를 허용합니다. Claude Code는 시작 시 JSON을 검증하고 잘못된 값에서 종료합니다. 메시지 및 검증을 건너뛰는 플래그와 환경 변수는 [`Invalid --agents configuration`](/docs/ko/errors#invalid-agents-configuration)을 참조하세요. 검증에는 Claude Code v2.1.242 이상이 필요합니다 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

68| `--allow-dangerously-skip-permissions` | `Shift+Tab` 모드 사이클에 `bypassPermissions`를 추가합니다. 이를 통해 `plan`과 같은 다른 모드에서 시작하고 나중에 `bypassPermissions`로 전환할 수 있습니다. [권한 모드](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode) 참조 | `claude --permission-mode plan --allow-dangerously-skip-permissions` |68| `--allow-dangerously-skip-permissions` | `Shift+Tab` 모드 사이클에 `bypassPermissions`를 추가하되 시작하지 않습니다. `plan`과 같은 다른 모드에서 시작하고 나중에 `bypassPermissions`로 전환할 수 있습니다. [권한 모드](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)를 참조하세요 | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

69| `--allowedTools`, `--allowed-tools` | 권한 프롬프트 없이 실행되는 도구입니다. 패턴 매칭에 대해 [권한 규칙 구문](/docs/ko/settings-reference#permission-rule-syntax)을 참조하세요. 사용 가능한 도구를 제한하려면 `--tools`를 대신 사용하세요. [작업 추적 도구](/docs/ko/tools-reference#task-tool-availability) 중 하나를 여기에 이름 지으면 Claude Code도 세션을 옵트인합니다 | `"Bash(git log *)" "Bash(git diff *)" "Read"` |69| `--allowedTools`, `--allowed-tools` | 권한을 묻지 않고 실행되는 도구입니다. 패턴 매칭에 대해 [권한 규칙 구문](/docs/ko/settings-reference#permission-rule-syntax)을 참조하세요. 사용 가능한 도구를 제한하려면 대신 `--tools`를 사용하세요. [작업 추적 도구](/docs/ko/tools-reference#task-tool-availability) 중 하나를 여기에 이름 지으면 Claude Code도 세션을 옵트인합니다 | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

70| `--append-subagent-system-prompt` | 모든 [subagent](/docs/ko/sub-agents)의 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다. 중첩된 subagents를 포함하며, [포크된 subagent](/docs/ko/sub-agents#fork-the-current-conversation)는 제외합니다. 포크된 subagent는 대화 자체의 프롬프트를 재사용합니다. `-p`를 사용한 비대화형 모드에만 적용됩니다. Claude Code v2.1.205 이상이 필요합니다 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |70| `--append-subagent-system-prompt` | [포크된 서브에이전트](/docs/ko/sub-agents#fork-the-current-conversation)를 제외한 모든 [서브에이전트](/docs/ko/sub-agents)의 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다. 포크된 서브에이전트는 대화 자체의 프롬프트를 재사용합니다. `-p`를 사용한 비대화형 모드에서만 적용됩니다. Claude Code v2.1.205 이상이 필요합니다 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

71| `--append-subagent-system-prompt-file` | 파일에서 텍스트를 로드하고 [subagent](/docs/ko/sub-agents) 시스템 프롬프트에 추가합니다. 명령줄에 전달하기에 너무 긴 텍스트의 경우 `--append-subagent-system-prompt`의 대안입니다. 두 플래그를 결합할 수 없습니다. `-p`를 사용한 비대화형 모드에만 적용됩니다. Claude Code v2.1.261 이상이 필요합니다 | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |71| `--append-subagent-system-prompt-file` | 파일에서 텍스트를 로드하고 [서브에이전트](/docs/ko/sub-agents) 시스템 프롬프트에 추가합니다. 명령줄에 전달하기에 너무 긴 텍스트의 경우 `--append-subagent-system-prompt`의 대안입니다. 두 플래그를 결합할 수 없습니다. `-p`를 사용한 비대화형 모드에서만 적용됩니다. Claude Code v2.1.261 이상이 필요합니다 | `claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"` |

72| `--append-system-prompt` | 기본 시스템 프롬프트의 끝에 사용자 정의 텍스트를 추가합니다 | `claude --append-system-prompt "Always use TypeScript"` |72| `--append-system-prompt` | 기본 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다 | `claude --append-system-prompt "Always use TypeScript"` |

73| `--append-system-prompt-file` | 파일에서 추가 시스템 프롬프트 텍스트를 로드하고 기본 프롬프트에 추가합니다 | `claude --append-system-prompt-file ./extra-rules.txt` |73| `--append-system-prompt-file` | 파일에서 추가 시스템 프롬프트 텍스트를 로드하고 기본 프롬프트에 추가합니다 | `claude --append-system-prompt-file ./extra-rules.txt` |

74| `--autocompact <auto\|tokens>` | 이 세션에 대해 저장된 설정을 변경하지 않고 [auto-compact 윈도우](/docs/ko/model-config#set-the-auto-compact-window)를 설정합니다. `/autocompact`와 동일한 값을 허용합니다. 해당 섹션에서 값 형식과 플래그를 재정의하는 것을 다룹니다. Claude Code v2.1.221 이상이 필요합니다 | `claude --autocompact 500k` |74| `--autocompact <auto\|tokens>` | 저장된 설정을 변경하지 않고 이 세션에 대해 [auto-compact 윈도우](/docs/ko/model-config#set-the-auto-compact-window)를 설정합니다. `/autocompact`와 동일한 값을 허용합니다. 해당 섹션에서 값 형식과 플래그를 재정의하는 것을 다룹니다. Claude Code v2.1.221 이상이 필요합니다 | `claude --autocompact 500k` |

75| `--ax-screen-reader` | 스크린 리더 친화적 출력을 렌더링합니다: 장식용 테두리나 애니메이션 없는 평문입니다. 클래식 렌더러를 강제하므로 [`tui`](/docs/ko/settings-reference#tui) 설정은 이 세션에 효과가 없습니다. 연결된 [백그라운드 세션](/docs/ko/agent-view)은 여전히 전체 화면으로 렌더링됩니다. [`CLAUDE_AX_SCREEN_READER`](/docs/ko/env-vars) 및 [`axScreenReader`](/docs/ko/settings-reference#axscreenreader) 설정보다 우선합니다. Claude Code v2.1.181 이상이 필요합니다 | `claude --ax-screen-reader` |75| `--ax-screen-reader` | 스크린 리더 친화적 출력을 렌더링합니다: 장식 테두리나 애니메이션 없는 평면 텍스트입니다. 클래식 렌더러를 강제하므로 [`tui`](/docs/ko/settings-reference#tui) 설정은 효과가 없습니다. 연결된 [백그라운드 세션](/docs/ko/agent-view)은 여전히 전체 화면으로 렌더링됩니다. [`CLAUDE_AX_SCREEN_READER`](/docs/ko/env-vars) 및 [`axScreenReader`](/docs/ko/settings-reference#axscreenreader) 설정보다 우선합니다. Claude Code v2.1.181 이상이 필요합니다 | `claude --ax-screen-reader` |

76| `--bare` | 최소 모드: hooks, skills, 사용자 정의 명령어, subagents, plugins, MCP 서버, 자동 메모리 및 CLAUDE.md의 자동 검색을 건너뜁니다. 스크립트된 호출이 더 빠르게 시작됩니다. `--add-dir`로 전달하는 디렉토리의 Skills는 여전히 로드됩니다. Claude는 Bash, 파일 읽기 및 파일 편집 도구에 액세스할 수 있습니다. [`CLAUDE_CODE_SIMPLE`](/docs/ko/env-vars)을 설정합니다. [bare 모드](/docs/ko/headless#start-faster-with-bare-mode) 참조 | `claude --bare -p "query"` |76| `--bare` | 최소 모드: 훅, 스킬, 사용자 정의 명령, 서브에이전트, 플러그인, MCP 서버, 자동 메모리 및 CLAUDE.md의 자동 검색을 건너뜁니다. 스크립트된 호출이 더 빠르게 시작됩니다. `--add-dir`로 전달하는 디렉터리의 스킬은 여전히 로드됩니다. Claude는 Bash, 파일 읽기 및 파일 편집 도구에 액세스할 수 있습니다. [`CLAUDE_CODE_SIMPLE`](/docs/ko/env-vars)을 설정합니다. [베어 모드](/docs/ko/headless#start-faster-with-bare-mode)를 참조하세요 | `claude --bare -p "query"` |

77| `--betas` | API 요청에 포함할 베타 헤더(API 키 사용자만 해당) | `claude --betas interleaved-thinking` |77| `--betas` | API 요청에 포함할 베타 헤더입니다(API 키 사용자만 해당) | `claude --betas interleaved-thinking` |

78| `--bg`, `--background` | 세션을 [백그라운드 에이전트](/docs/ko/agent-view)로 시작하고 즉시 반환합니다. 세션 ID와 관리 명령어를 인쇄합니다. `--exec`과 결합하여 Claude 세션 대신 셸 명령어를 백그라운드 작업으로 실행하거나, `--agent`와 결합하여 특정 subagent를 실행합니다. `-p`/`--print`와 결합할 수 없습니다. [오류 참조](/docs/ko/errors#command-line-errors) 참조 | `claude --bg "investigate the flaky test"` |78| `--bg`, `--background` | 세션을 [백그라운드 에이전트](/docs/ko/agent-view)로 시작하고 즉시 반환합니다. 세션 ID 및 관리 명령을 인쇄합니다. `--exec`와 결합하여 Claude 세션 대신 셸 명령을 백그라운드 작업으로 실행하거나, `--agent`와 결합하여 특정 서브에이전트를 실행합니다. `-p`/`--print`와 결합할 수 없습니다. [오류 참조](/docs/ko/errors#command-line-errors)를 참조하세요 | `claude --bg "investigate the flaky test"` |

79| `--channels` | (연구 미리보기) Claude가 이 세션에서 수신해야 할 [채널](/docs/ko/channels) 알림이 있는 MCP 서버입니다. `plugin:<name>@<marketplace>` 항목의 공백으로 구분된 목록입니다. Claude.ai 또는 Console API 키를 통한 Anthropic 인증이 필요합니다 | `claude --channels plugin:my-notifier@my-marketplace` |79| `--channels` | (연구 미리보기) Claude가 이 세션에서 수신해야 하는 [채널](/docs/ko/channels) 알림이 있는 MCP 서버입니다. `plugin:<name>@<marketplace>` 항목의 공백으로 구분된 목록입니다. claude.ai 또는 Console API 키를 통한 Anthropic 인증이 필요합니다 | `claude --channels plugin:my-notifier@my-marketplace` |

80| `--chrome` | 웹 자동화 및 테스트를 위해 [Chrome 브라우저 통합](/docs/ko/chrome)을 활성화합니다 | `claude --chrome` |80| `--chrome` | 웹 자동화 및 테스트를 위해 [Chrome 브라우저 통합](/docs/ko/chrome)을 활성화합니다 | `claude --chrome` |

81| `--cloud` | 작업 설명으로 claude.ai에서 새 [웹 세션](/docs/ko/claude-code-on-the-web)을 생성합니다. 세션 ID(`session_...` 또는 `cse_...`) 또는 claude.ai/code URL로 `-p`를 사용하여 기존 세션에 메시지를 대기열에 넣습니다. [후속 메시지 전송](/docs/ko/claude-code-on-the-web#send-follow-ups-from-the-cli) 참조 | `claude --cloud "Fix the login bug"` |81| `--cloud` | 작업 설명을 사용하여 새 [클라우드 세션](/docs/ko/claude-code-on-the-web)을 만듭니다. 세션 ID(`session_...` 또는 `cse_...`) 또는 claude.ai/code URL을 사용하여 `-p`로 기존 세션에 메시지를 대기열에 넣습니다. [후속 메시지 전송](/docs/ko/claude-code-on-the-web#send-follow-ups-from-the-cli)을 참조하세요. | `claude --cloud "Fix the login bug"` |

82| `--continue`, `-c` | 현재 디렉토리에서 가장 최근 대화를 로드합니다. [완료된 백그라운드 세션](/docs/ko/sessions#resume-a-session)을 포함합니다. 완료된 백그라운드 세션을 열려면 Claude Code v2.1.257 이상이 필요합니다. `claude -p` 또는 Agent SDK로 생성된 세션과 첫 번째 프롬프트가 `/loop`인 세션을 건너뜁니다. `claude -p --continue`는 `-p`, SDK 및 `/loop` 세션을 포함합니다. `/add-dir`으로 이 디렉토리를 추가한 세션을 포함합니다 | `claude --continue` |82| `--continue`, `-c` | 현재 디렉터리에서 가장 최근 대화를 로드합니다. [완료된 백그라운드 세션](/docs/ko/sessions#resume-a-session)을 포함합니다. 완료된 백그라운드 세션을 열려면 Claude Code v2.1.257 이상이 필요합니다. `claude -p` 또는 Agent SDK로 생성된 세션과 첫 번째 프롬프트가 `/loop`인 세션을 건너뜁니다. `claude -p --continue`는 `-p`, SDK 및 `/loop` 세션을 포함합니다. 이 디렉터리를 `/add-dir`로 추가한 세션을 포함합니다 | `claude --continue` |

83| `--dangerously-load-development-channels` | 로컬 개발을 위해 승인된 허용 목록에 없는 [채널](/docs/ko/channels-reference#test-during-the-research-preview)을 활성화합니다. `plugin:<name>@<marketplace>` 및 `server:<name>` 항목을 허용합니다. 확인을 요청합니다 | `claude --dangerously-load-development-channels server:webhook` |83| `--dangerously-load-development-channels` | 로컬 개발을 위해 승인된 허용 목록에 없는 [채널](/docs/ko/channels-reference#test-during-the-research-preview)을 활성화합니다. `plugin:<name>@<marketplace>` 및 `server:<name>` 항목을 허용합니다. 확인을 요청합니다 | `claude --dangerously-load-development-channels server:webhook` |

84| `--dangerously-skip-permissions` | 권한 프롬프트를 건너뜁니다. `--permission-mode bypassPermissions`와 동일합니다. 이것이 건너뛰는 것과 건너뛰지 않는 것에 대해 [권한 모드](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)를 참조하세요. `--bg`로 시작된 세션의 경우, 모드는 [감독자가 세션을 다시 시작할 때 지속됩니다](/docs/ko/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | 권한 프롬프트를 건너뜁니다. `--permission-mode bypassPermissions`과 동등합니다. 이것이 건너뛰는 것과 건너뛰지 않는 것에 대해 [권한 모드](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)를 참조하세요. `--bg`로 시작된 세션의 경우, 모드는 [감독자가 세션을 다시 시작할 때 유지됩니다](/docs/ko/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | 선택적 카테고리 필터링을 사용하여 디버그 모드를 활성화합니다(예: `--debug='mcp,startup'` 또는 `--debug='!1p'`). 필터는 `=` 형식에만 바인딩됩니다. 공백으로 구분된 필터는 필터링 없이 디버그 모드를 활성화합니다 | `claude --debug='mcp,startup'` |85| `--debug` | `--debug='mcp,startup'` 또는 `--debug='!1p'`와 같은 선택적 카테고리 필터링으로 디버그 모드를 활성화합니다. 필터는 `=` 형식에서만 바인딩됩니다. 공백으로 구분된 필터는 필터링 없이 디버그 모드를 활성화합니다 | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | 디버그 로그를 특정 파일 경로에 씁니다. 암묵적으로 디버그 모드를 활성화합니다. `CLAUDE_CODE_DEBUG_LOGS_DIR`보다 우선합니다 | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | 특정 파일 경로에 디버그 로그를 작성합니다. 암묵적으로 디버그 모드를 활성화합니다. `CLAUDE_CODE_DEBUG_LOGS_DIR`보다 우선합니다 | `claude --debug-file /tmp/claude-debug.log` |

87| `--disable-slash-commands` | 이 세션에 대해 모든 skills 및 명령어를 비활성화합니다 | `claude --disable-slash-commands` |87| `--disable-slash-commands` | 이 세션에 대해 모든 스킬 및 명령을 비활성화합니다 | `claude --disable-slash-commands` |

88| `--disallowedTools`, `--disallowed-tools` | 거부 규칙입니다. 단순 도구 이름은 Claude의 컨텍스트에서 해당 도구를 제거합니다: `"Edit"`는 Edit를 제거하고, `"*"`는 모든 도구를 제거하며, `"mcp__*"`는 모든 MCP 도구를 제거합니다. `Bash(rm *)`과 같은 범위 지정 규칙은 도구를 사용 가능하게 유지하고 [작성된 대로](/docs/ko/permissions#bash-rule-limits) 일치하는 호출만 거부합니다. [`EndConversation`](/docs/ko/tools-reference#endconversation-tool-behavior)을 이름 지은 규칙은 다른 도구가 남아 있는 동안 이를 제거할 수 없습니다 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |88| `--disallowedTools`, `--disallowed-tools` | 거부 규칙입니다. 베어 도구 이름은 Claude의 컨텍스트에서 일치하는 도구를 제거합니다: `"Edit"`는 Edit를 제거하고, `"*"`는 모든 도구를 제거하며, `"mcp__*"`는 모든 MCP 도구를 제거합니다. `Bash(rm *)`와 같은 범위 지정 규칙은 도구를 사용 가능하게 두고 [작성된 대로](/docs/ko/permissions#bash-rule-limits) 일치하는 호출만 거부합니다. [`EndConversation`](/docs/ko/tools-reference#endconversation-tool-behavior)을 이름 지은 규칙은 다른 도구가 남아 있는 동안 제거할 수 없습니다 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | 현재 세션에 대한 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 설정합니다. 옵션: `low`, `medium`, `high`, `xhigh`, `max` 또는 `ultracode`. 사용 가능한 수준은 모델에 따라 다릅니다. `ultracode`는 `xhigh` 노력으로 요청하고 [ultracode](/docs/ko/workflows#let-claude-decide-with-ultracode)를 켜며, Claude Code v2.1.203 이상이 필요합니다. [`modelSettings`](/docs/ko/settings-reference#modelsettings) 및 [`effortLevel`](/docs/ko/settings-reference#effortlevel) 설정을 이 세션에 대해 재정의하며 지속되지 않습니다 | `claude --effort high` |89| `--effort` | 현재 세션에 대해 [노력 수준](/docs/ko/model-config#adjust-effort-level)을 설정합니다. 옵션: `low`, `medium`, `high`, `xhigh`, `max` 또는 `ultracode`입니다. 사용 가능한 수준은 모델에 따라 다릅니다. `ultracode`는 [ultracode](/docs/ko/workflows#let-claude-decide-with-ultracode)가 켜진 상태에서 `xhigh` 노력을 요청하며, Claude Code v2.1.203 이상이 필요합니다. 이 세션에 대해 [`modelSettings`](/docs/ko/settings-reference#modelsettings) 및 [`effortLevel`](/docs/ko/settings-reference#effortlevel) 설정을 재정의하고 유지되지 않습니다 | `claude --effort high` |

90| `--enable-auto-mode` | v2.1.111에서 제거됨. 자동 모드는 이제 `Shift+Tab` 사이클에 기본적으로 포함됩니다. `--permission-mode auto`를 사용하여 시작합니다 | `claude --permission-mode auto` |90| `--enable-auto-mode` | v2.1.111에서 제거됨. 자동 모드는 이제 `Shift+Tab` 사이클에 기본적으로 있습니다. `--permission-mode auto`를 사용하여 시작합니다 | `claude --permission-mode auto` |

91| `--environment <environment-id>` | 주어진 ID를 가진 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행되는 새 클라우드 세션을 생성합니다. 환경 ID는 `ccpool_`로 시작합니다. 디스패치 동작 및 거부하는 플래그 조합에 대해 [`--environment` 디스패치 동작](/docs/ko/self-hosted-environments-testing#environment-dispatch-behavior)을 참조하세요. Claude Code v2.1.224 이상이 필요합니다 | `claude -p "Fix the login bug" --environment ccpool_abc123` |91| `--environment <environment-id>` | 주어진 ID를 가진 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행되는 새 클라우드 세션을 만듭니다. 환경 ID는 `ccpool_`로 시작합니다. 디스패치 동작 및 거부하는 플래그 조합에 대해 [`--environment` 디스패치 동작](/docs/ko/self-hosted-environments-testing#environment-dispatch-behavior)을 참조하세요. Claude Code v2.1.224 이상이 필요합니다 | `claude -p "Fix the login bug" --environment ccpool_abc123` |

92| `--exclude-dynamic-system-prompt-sections` | 시스템 프롬프트의 머신별 섹션(작업 디렉토리, 환경 정보, 메모리 경로, git 상태)을 첫 번째 사용자 메시지로 이동합니다. 동일한 작업을 실행하는 다양한 사용자 및 머신 간에 프롬프트 캐시 재사용을 개선합니다. 기본 시스템 프롬프트에만 적용됩니다. `--system-prompt` 또는 `--system-prompt-file`이 설정되면 무시됩니다. 스크립트된 다중 사용자 워크로드의 경우 `-p`와 함께 사용합니다 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |92| `--exclude-dynamic-system-prompt-sections` | 시스템 프롬프트의 머신별 섹션(작업 디렉터리, 환경 정보, 메모리 경로, git-repo 플래그)을 첫 번째 사용자 메시지로 이동합니다. 동일한 작업을 실행하는 다양한 사용자 및 머신 간에 프롬프트 캐시 재사용을 개선합니다. 기본 시스템 프롬프트에만 적용됩니다. `--system-prompt` 또는 `--system-prompt-file`이 설정되면 무시됩니다. 스크립트된 다중 사용자 워크로드에 `-p`와 함께 사용합니다 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

93| `--exec` | 셸 명령어를 Claude 세션을 시작하는 대신 PTY 기반 백그라운드 작업으로 실행합니다. `--bg`와 함께 사용하여 셸에서 시작합니다 | `claude --bg --exec 'pytest -x'` |93| `--exec` | Claude 세션을 시작하는 대신 PTY 지원 백그라운드 작업으로 셸 명령을 실행합니다. 셸에서 시작하려면 `--bg`와 함께 사용합니다 | `claude --bg --exec 'pytest -x'` |

94| `--fallback-model` | 기본 모델이 과부하 상태이거나 사용할 수 없을 때(예: 폐기된 모델) 지정된 모델로 자동 폴백을 활성화합니다. 순서대로 시도되는 쉼표로 구분된 목록을 허용합니다. [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains) 참조. 세션 간에 체인을 유지하려면 [`fallbackModel` 설정](/docs/ko/settings-reference#fallbackmodel)을 사용하며, 이 플래그가 이를 재정의합니다 | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | 기본 모델이 과부하되거나 사용할 수 없을 때(예: 폐기된 모델) 지정된 모델로 자동 폴백을 활성화합니다. 순서대로 시도되는 쉼표로 구분된 목록을 허용합니다. [폴백 모델 체인](/docs/ko/model-config#fallback-model-chains)을 참조하세요. 세션 간에 체인을 유지하려면 이 플래그가 재정의하는 [`fallbackModel` 설정](/docs/ko/settings-reference#fallbackmodel)을 사용합니다 | `claude --fallback-model sonnet,haiku` |

95| `--fork-session` | 재개할 때 원본을 재사용하는 대신 새 세션 ID를 생성합니다(`--resume` 또는 `--continue`와 함께 사용) | `claude --resume abc123 --fork-session` |95| `--fork-session` | 재개할 때 원본을 재사용하는 대신 새 세션 ID를 만듭니다(`--resume` 또는 `--continue`와 함께 사용) | `claude --resume abc123 --fork-session` |

96| `--forward-subagent-text` | [subagent](/docs/ko/sub-agents) 텍스트 및 사고 블록을 `parent_tool_use_id` 설정으로 `assistant` 및 `user` 메시지로 출력 스트림에 내보내므로 각 subagent의 트랜스크립트를 재구성할 수 있습니다. 이 플래그 없이 Claude Code는 [포그라운드](/docs/ko/sub-agents#run-subagents-in-foreground-or-background)에서 실행되는 subagent의 텍스트 및 사고 블록을 생략합니다. `--print` 및 `--output-format stream-json`이 필요합니다. Claude Code는 또한 [중첩된 subagents](/docs/ko/sub-agents#let-subagents-spawn-their-own-subagents)의 메시지를 전달하며, `parent_tool_use_id`를 각 subagent를 생성한 Agent 도구 호출의 ID로 설정합니다. 이는 Claude Code v2.1.219 이상이 필요합니다. [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ko/env-vars) 환경 변수는 동일한 동작을 활성화합니다. Claude Code v2.1.211 이상이 필요합니다 | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |96| `--forward-subagent-text` | [서브에이전트](/docs/ko/sub-agents) 텍스트 및 사고 블록을 `parent_tool_use_id` 설정된 `assistant` 및 `user` 메시지로 출력 스트림에 내보내므로 각 서브에이전트의 트랜스크립트를 재구성할 수 있습니다. 이 플래그 없이 Claude Code는 [포그라운드](/docs/ko/sub-agents#run-subagents-in-foreground-or-background)에서 실행되는 서브에이전트의 텍스트 및 사고 블록을 생략합니다. `--print` 및 `--output-format stream-json`이 필요합니다. Claude Code는 또한 [중첩된 서브에이전트](/docs/ko/sub-agents#let-subagents-spawn-their-own-subagents)의 메시지를 전달하며, 각 메시지를 생성한 Agent 도구 호출의 ID로 `parent_tool_use_id`를 설정합니다. 이는 Claude Code v2.1.219 이상이 필요합니다. [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ko/env-vars) 환경 변수는 동일한 동작을 활성화합니다. Claude Code v2.1.211 이상이 필요합니다 | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

97| `--from-pr` | 특정 pull request에 연결된 세션으로 필터링된 세션 선택기를 엽니다. PR 번호, GitHub 또는 GitHub Enterprise PR URL, GitLab merge request URL 또는 Bitbucket pull request URL을 허용합니다. Claude가 pull request를 생성할 때 세션이 자동으로 연결됩니다 | `claude --from-pr 123` |97| `--from-pr` | 특정 풀 요청에 연결된 세션으로 필터링된 세션 선택기를 엽니다. PR 번호, GitHub 또는 GitHub Enterprise PR URL, GitLab 병합 요청 URL 또는 Bitbucket 풀 요청 URL을 허용합니다. Claude가 풀 요청을 만들 때 세션이 자동으로 연결됩니다 | `claude --from-pr 123` |

98| `--ide` | 정확히 하나의 유효한 IDE를 사용할 수 있는 경우 시작 시 IDE에 자동으로 연결합니다 | `claude --ide` |98| `--ide` | 정확히 하나의 유효한 IDE를 사용할 수 있는 경우 시작 시 IDE에 자동으로 연결합니다 | `claude --ide` |

99| `--init` | [Setup hooks](/docs/ko/hooks#setup)를 `init` 매처로 실행한 후 세션을 시작합니다(인쇄 모드만 해당) | `claude -p --init "query"` |99| `--init` | `init` 매처를 사용하여 세션 전에 [Setup 훅](/docs/ko/hooks#setup)을 실행합니다(인쇄 모드만 해당) | `claude -p --init "query"` |

100| `--init-only` | [Setup](/docs/ko/hooks#setup) 및 `SessionStart` hooks를 실행한 후 대화를 시작하지 않고 종료합니다 | `claude --init-only` |100| `--init-only` | [Setup](/docs/ko/hooks#setup) 및 `SessionStart` 훅을 실행한 다음 대화를 시작하지 않고 종료합니다 | `claude --init-only` |

101| `--include-hook-events` | hook 라이프사이클 이벤트를 출력 스트림에 포함합니다. `SessionStart` 및 `Setup` hook 이벤트는 항상 포함되며 이 플래그가 필요하지 않습니다. `Notification`, `SessionEnd`, `PreCompact` 및 `PostCompact`와 같은 일부 hook 이벤트는 이 플래그를 사용해도 `hook_started` 이벤트를 생성하지 않습니다. 이러한 이벤트의 경우 Claude Code는 여전히 명령어 hook이 1초 이상 실행되는 동안 `hook_progress`를 내보내고, [백그라운드에서 실행되는 hook](/docs/ko/hooks#run-hooks-in-the-background)이 완료될 때만 `hook_response`를 내보냅니다. `--output-format stream-json`이 필요합니다 | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |101| `--include-hook-events` | 훅 수명 주기 이벤트를 출력 스트림에 포함합니다. `SessionStart` 및 `Setup` 훅 이벤트는 항상 포함되며 이 플래그가 필요하지 않습니다. `Notification`, `SessionEnd`, `PreCompact` 및 `PostCompact`와 같은 일부 훅 이벤트는 이 플래그를 사용하더라도 `hook_started` 이벤트를 생성하지 않습니다. 이러한 이벤트의 경우 Claude Code는 여전히 `hook_progress`를 내보내며, 1초 이상 실행되는 명령 훅은 출력을 생성하고, [백그라운드에서 실행되는 훅](/docs/ko/hooks#run-hooks-in-the-background)이 완료될 때만 `hook_response`를 내보냅니다. `--output-format stream-json`이 필요합니다 | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

102| `--include-partial-messages` | 부분 스트리밍 이벤트를 출력에 포함합니다. `--print` 및 `--output-format stream-json`이 필요합니다 | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |102| `--include-partial-messages` | 출력에 부분 스트리밍 이벤트를 포함합니다. `--print` 및 `--output-format stream-json`이 필요합니다 | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

103| `--input-format` | 인쇄 모드에 대한 입력 형식을 지정합니다(옵션: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |103| `--input-format` | 인쇄 모드에 대한 입력 형식을 지정합니다(옵션: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

104| `--json-schema` | 에이전트가 워크플로우를 완료한 후 JSON Schema와 일치하는 검증된 JSON 출력을 가져옵니다(인쇄 모드만 해당). [구조화된 출력](/docs/ko/agent-sdk/structured-outputs) 참조. Claude Code는 잘못된 스키마에서 오류로 종료되고 클라이언트 측 검증 없이 주석으로 `format` 키워드를 허용합니다 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |104| `--json-schema` | 에이전트가 워크플로우를 완료한 후 JSON 스키마와 일치하는 검증된 JSON 출력을 가져옵니다(인쇄 모드만 해당). [구조화된 출력](/docs/ko/agent-sdk/structured-outputs)을 참조하세요. Claude Code는 잘못된 스키마에서 오류로 종료되고 클라이언트 측 검증 없이 주석으로 `format` 키워드를 허용합니다 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

105| `--maintenance` | [Setup hooks](/docs/ko/hooks#setup)를 `maintenance` 매처로 실행한 후 세션을 시작합니다(인쇄 모드만 해당) | `claude -p --maintenance "query"` |105| `--maintenance` | `maintenance` 매처를 사용하여 세션 전에 [Setup 훅](/docs/ko/hooks#setup)을 실행합니다(인쇄 모드만 해당) | `claude -p --maintenance "query"` |

106| `--max-budget-usd` | 중지하기 전에 API 호출에 소비할 최대 달러 금액(인쇄 모드만 해당). [subagents](/docs/ko/sub-agents)의 지출이 한도에 포함됩니다. 지출이 한도에 도달하면 다른 subagent를 생성하면 `Budget limit reached`로 실패하고 Claude Code는 여전히 실행 중인 백그라운드 subagents를 중지합니다. 한도 적용 동작에는 Claude Code v2.1.217 이상이 필요합니다 | `claude -p --max-budget-usd 5.00 "query"` |106| `--max-budget-usd` | API 호출에 지출할 최대 달러 금액입니다. 중지하기 전에 지출합니다(인쇄 모드만 해당). [서브에이전트](/docs/ko/sub-agents)의 지출이 한도에 포함됩니다. 지출이 한도에 도달하면 다른 서브에이전트를 생성하면 `Budget limit reached`로 실패하고 Claude Code는 여전히 실행 중인 백그라운드 서브에이전트를 중지합니다. 한도 적용 동작에는 Claude Code v2.1.217 이상이 필요합니다 | `claude -p --max-budget-usd 5.00 "query"` |

107| `--max-turns` | 에이전트 턴의 수를 제한합니다(인쇄 모드만 해당). 제한에 도달하면 오류로 종료됩니다. 기본적으로 제한 없음. `--input-format stream-json`을 사용하면 제한이 턴을 끝낼 때 대기열에 있는 메시지는 대기열에 남아 있고 자신의 제한으로 새 턴을 시작합니다 | `claude -p --max-turns 3 "query"` |107| `--max-turns` | 에이전트 턴의 수를 제한합니다(인쇄 모드만 해당). 한도에 도달하면 오류로 종료됩니다. 기본적으로 제한이 없습니다. `--input-format stream-json`을 사용하면 한도가 턴을 끝낼 때 여전히 대기열에 있는 메시지는 대기열에 남아 있고 자체 한도로 새 턴을 시작합니다 | `claude -p --max-turns 3 "query"` |

108| `--mcp-config` | JSON 파일 또는 문자열에서 MCP 서버를 로드합니다(공백으로 구분). 이 플래그를 `-p`와 함께 전달하면 Claude Code는 여전히 보류 중인 서버가 연결될 때까지 대기합니다. [`MCP_TIMEOUT`](/docs/ko/env-vars) 시작 시간 초과인 30초까지입니다. [캐시된 도구 목록](/docs/ko/mcp#managing-your-servers)이 있는 서버는 대기를 건너뛰고 처음 사용할 때 연결됩니다. 대기에는 Claude Code v2.1.221 이상이 필요합니다 | `claude --mcp-config ./mcp.json` |108| `--mcp-config` | JSON 파일 또는 문자열에서 MCP 서버를 로드합니다(공백으로 구분). 이 플래그를 `-p`와 함께 전달하면 Claude Code는 첫 번째 턴을 실행하기 전에 여전히 보류 중인 서버가 연결될 때까지 기다립니다. [`MCP_TIMEOUT`](/docs/ko/env-vars) 시작 시간 초과(기본값 30초)까지입니다. [캐시된 도구 목록](/docs/ko/mcp#managing-your-servers)이 있는 서버는 대기를 건너뛰고 처음 사용할 때 연결됩니다. 대기에는 Claude Code v2.1.221 이상이 필요합니다 | `claude --mcp-config ./mcp.json` |

109| `--model` | `sonnet`, `opus`, `haiku` 또는 `fable`과 같은 [모델 별칭](/docs/ko/model-config#model-aliases) 또는 모델의 전체 이름으로 현재 세션에 대한 모델을 설정합니다. [`model`](/docs/ko/settings-reference#model) 설정 및 [`ANTHROPIC_MODEL`](/docs/ko/model-config#environment-variables)을 재정의합니다 | `claude --model claude-sonnet-5` |109| `--model` | `sonnet`, `opus`, `haiku` 또는 `fable`과 같은 [모델 별칭](/docs/ko/model-config#model-aliases) 또는 모델의 전체 이름으로 현재 세션에 대한 모델을 설정합니다. [`model`](/docs/ko/settings-reference#model) 설정 및 [`ANTHROPIC_MODEL`](/docs/ko/model-config#environment-variables)을 재정의합니다 | `claude --model claude-sonnet-5` |

110| `--name`, `-n` | 세션의 표시 이름을 설정합니다. `/resume` 및 터미널 제목에 표시됩니다. `claude --resume <name>`으로 명명된 세션을 재개할 수 있습니다. 대화형 세션에서 이 머신의 다른 라이브 세션이 이미 이름을 사용하는 경우 Claude Code는 [이의 변형을 적용합니다](/docs/ko/sessions#name-your-sessions). <br /><br />[`/rename`](/docs/ko/commands)은 세션 중에 이름을 변경하고 프롬프트 표시줄에도 표시합니다 | `claude -n "my-feature-work"` |110| `--name`, `-n` | 세션의 표시 이름을 설정합니다. `/resume` 및 터미널 제목에 표시됩니다. `claude --resume <name>`으로 명명된 세션을 재개할 수 있습니다. 대화형 세션에서 이 머신의 다른 라이브 세션이 이미 이름을 사용하는 경우 Claude Code는 [그 변형을 적용합니다](/docs/ko/sessions#name-your-sessions). <br /><br />[`/rename`](/docs/ko/commands)은 세션 중에 이름을 변경하고 프롬프트 표시줄에도 표시합니다 | `claude -n "my-feature-work"` |

111| `--no-chrome` | 이 세션에 대해 [Chrome 브라우저 통합](/docs/ko/chrome)을 비활성화합니다 | `claude --no-chrome` |111| `--no-chrome` | 이 세션에 대해 [Chrome 브라우저 통합](/docs/ko/chrome)을 비활성화합니다 | `claude --no-chrome` |

112| `--no-session-persistence` | 세션 지속성을 비활성화하여 세션이 디스크에 저장되지 않고 재개할 수 없습니다. 인쇄 모드만 해당. [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ko/env-vars) 환경 변수는 모든 모드에서 동일한 작업을 수행합니다 | `claude -p --no-session-persistence "query"` |112| `--no-session-persistence` | 세션 지속성을 비활성화하므로 세션이 디스크에 저장되지 않고 재개할 수 없습니다. 인쇄 모드만 해당입니다. [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ko/env-vars) 환경 변수는 모든 모드에서 동일한 작업을 수행합니다 | `claude -p --no-session-persistence "query"` |

113| `--output-format` | 인쇄 모드에 대한 출력 형식을 지정합니다(옵션: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |113| `--output-format` | 인쇄 모드에 대한 출력 형식을 지정합니다(옵션: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

114| `--permission-mode` | 지정된 [권한 모드](/docs/ko/permission-modes)에서 시작합니다. `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` 또는 `manual`을 허용합니다. `manual`은 `default`의 별칭이며 UI가 Manual로 표시하는 모드를 선택하고 Claude Code v2.1.200 이상이 필요합니다. `claude --help`는 `default` 대신 이를 나열하며 두 값 모두 작동합니다. 설정 파일의 `defaultMode`를 재정의합니다. 이 플래그 또는 `--dangerously-skip-permissions` 없이 새 세션은 [세션이 시작되는 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)에 설명된 권한 모드에서 시작됩니다. `-p`의 경우 아무것도 구성되지 않으면 `default`입니다 | `claude --permission-mode plan` |114| `--permission-mode` | 지정된 [권한 모드](/docs/ko/permission-modes)에서 시작합니다. `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` 또는 `manual`을 `default`의 별칭으로 허용합니다. `manual` 별칭은 UI가 Manual로 레이블 지정하는 권한 모드를 선택하며 Claude Code v2.1.200 이상이 필요합니다. `claude --help`는 `default` 대신 이를 나열하고 두 값 모두 작동합니다. 설정 파일의 `defaultMode`를 재정의합니다. 이 플래그 또는 `--dangerously-skip-permissions` 없이 새 세션은 [세션이 시작되는 권한 모드](/docs/ko/permission-modes#which-mode-a-session-starts-in)에 설명된 권한 모드에서 시작됩니다. `-p`의 경우 아무것도 구성되지 않으면 `default`입니다 | `claude --permission-mode plan` |

115| `--permission-prompt-tool` | 비대화형 모드에서 권한 프롬프트를 처리할 MCP 도구를 지정합니다. Claude Code는 해당 도구의 MCP 서버가 연결될 때까지 대기합니다. [`MCP_TIMEOUT`](/docs/ko/env-vars) 시작 시간 초과인 30초까지입니다. <br /><br />프롬프트 도구는 [사용자 상호작용이 필요한](/docs/ko/mcp#require-approval-for-a-specific-tool) 것으로 표시된 MCP 도구를 승인할 수 없습니다: Claude Code는 하나에 대한 `allow` 결과를 거부로 변환합니다. 이 제한은 Claude Code v2.1.199 이상이 필요합니다 | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |115| `--permission-prompt-tool` | 비대화형 모드에서 권한 프롬프트를 처리할 MCP 도구를 지정합니다. Claude Code는 첫 번째 턴을 실행하기 전에 해당 도구의 MCP 서버가 연결될 때까지 기다립니다. [`MCP_TIMEOUT`](/docs/ko/env-vars) 시작 시간 초과(기본값 30초)까지입니다. <br /><br />프롬프트 도구는 [사용자 상호 작용이 필요한 것으로 표시된](/docs/ko/mcp#require-approval-for-a-specific-tool) MCP 도구를 승인할 수 없습니다. Claude Code는 하나에 대한 `allow` 결과를 거부로 변환합니다. 이 제한에는 Claude Code v2.1.199 이상이 필요합니다 | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

116| `--permission-prompts` | 인쇄 모드에서 권한 프롬프트에 응답하는 사람을 설정합니다. 기본 `host`를 사용하면 Claude Code는 Agent SDK 호스트 또는 `--permission-prompt-tool` 도구로 보냅니다. 아무도 응답할 수 없을 때 `none`을 전달하면 Claude Code는 대신 거부합니다. [무인 실행에서 권한 프롬프트 끄기](/docs/ko/headless#turn-off-permission-prompts-in-unattended-runs) 참조. Claude Code v2.1.259 이상이 필요합니다 | `claude -p --permission-prompts none "query"` |116| `--permission-prompts` | 인쇄 모드에서 권한 프롬프트에 응답하는 사람을 설정합니다. 기본 `host`를 사용하면 Claude Code는 Agent SDK 호스트 또는 `--permission-prompt-tool` 도구로 보냅니다. 아무도 응답할 수 없을 때 `none`을 전달하면 Claude Code는 대신 거부합니다. [무인 실행에서 권한 프롬프트 끄기](/docs/ko/headless#turn-off-permission-prompts-in-unattended-runs)를 참조하세요. Claude Code v2.1.259 이상이 필요합니다 | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | 이 세션에만 디렉토리 또는 `.zip` 아카이브에서 plugin을 로드합니다. 또는 [plugins의 폴더](/docs/ko/plugins#test-your-plugins-locally)에서 여러 개를 로드합니다. 각 플래그는 하나의 경로를 사용합니다. 여러 경로의 경우 플래그를 반복합니다: `--plugin-dir A --plugin-dir B.zip`. plugins의 폴더를 전달하려면 Claude Code v2.1.265 이상이 필요합니다 | `claude --plugin-dir ./my-plugin` |117| `--plugin-dir` | 이 세션에만 디렉터리 또는 `.zip` 아카이브에서 플러그인을 로드하거나 [플러그인 폴더](/docs/ko/plugins#test-your-plugins-locally)에서 여러 개를 로드합니다. 각 플래그는 하나의 경로를 사용합니다. 더 많은 경로에 대해 플래그를 반복합니다: `--plugin-dir A --plugin-dir B.zip`. 플러그인 폴더를 전달하려면 Claude Code v2.1.265 이상이 필요합니다 | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | 이 세션에만 URL에서 plugin `.zip` 아카이브를 가져옵니다. 여러 plugins의 경우 플래그를 반복하거나 단일 따옴표 값에 공백으로 구분된 URL을 전달합니다 | `claude --plugin-url https://example.com/plugin.zip` |118| `--plugin-url` | 이 세션에만 URL에서 플러그인 `.zip` 아카이브를 가져옵니다. 여러 플러그인에 대해 플래그를 반복하거나 단일 따옴표 값에 공백으로 구분된 URL을 전달합니다 | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | 대화형 모드 없이 응답을 인쇄합니다([Agent SDK 문서](/docs/ko/agent-sdk/overview)에서 프로그래밍 방식 사용 세부 정보 참조) | `claude -p "query"` |119| `--print`, `-p` | 대화형 모드 없이 응답을 인쇄합니다([프로그래밍 방식 사용에 대한 Agent SDK 문서](/docs/ko/agent-sdk/overview) 참조) | `claude -p "query"` |

120| `--prompt-suggestions` | 각 턴 후에 예측된 다음 사용자 프롬프트를 포함하는 `prompt_suggestion` 메시지를 내보냅니다. 매우 짧은 대화는 없을 수 있습니다. `--print`, `--output-format stream-json` 및 `--verbose`가 필요합니다. [프롬프트 제안](/docs/ko/interactive-mode#prompt-suggestions) 참조 | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |120| `--prompt-suggestions` | 각 턴 후에 예측된 다음 사용자 프롬프트를 사용하여 `prompt_suggestion` 메시지를 내보냅니다. 매우 짧은 대화는 없을 수 있습니다. `--print`, `--output-format stream-json` 및 `--verbose`가 필요합니다. [프롬프트 제안](/docs/ko/interactive-mode#prompt-suggestions)을 참조하세요 | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | `--environment`을 사용하여 새 세션의 체크아웃을 로컬 `HEAD` 대신 명명된 ref를 기반으로 합니다 | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |121| `--ref <branch>` | `--environment`를 사용하면 새 세션의 체크아웃을 로컬 `HEAD` 대신 명명된 ref를 기반으로 합니다 | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

122| `--remote` | `--cloud`의 더 이상 사용되지 않는 별칭. 기존 세션 형식 포함 | `claude --remote "Fix the login bug"` |122| `--remote` | `--cloud`의 더 이상 사용되지 않는 별칭. 기존 세션 형식 포함 | `claude --remote "Fix the login bug"` |

123| `--remote-control`, `--rc` | [Remote Control](/docs/ko/remote-control#start-a-remote-control-session)이 활성화된 대화형 세션을 시작하므로 claude.ai 또는 Claude 앱에서도 제어할 수 있습니다. 선택적으로 세션의 이름을 전달할 수 있습니다 | `claude --remote-control "My Project"` |123| `--remote-control`, `--rc` | [Remote Control](/docs/ko/remote-control#start-a-remote-control-session)이 활성화된 대화형 세션을 시작하므로 claude.ai 또는 Claude 앱에서도 제어할 수 있습니다. 선택적으로 세션의 이름을 전달합니다 | `claude --remote-control "My Project"` |

124| `--remote-control-session-name-prefix <prefix>` | 명시적 이름이 설정되지 않은 경우 자동 생성된 [Remote Control](/docs/ko/remote-control) 세션 이름의 접두사입니다. 기본값은 머신의 호스트명이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. 동일한 효과를 위해 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`를 설정합니다 | `claude remote-control --remote-control-session-name-prefix dev-box` |124| `--remote-control-session-name-prefix <prefix>` | 명시적 이름이 설정되지 않은 경우 자동 생성된 [Remote Control](/docs/ko/remote-control) 세션 이름의 접두사입니다. 기본값은 머신의 호스트 이름이며 `myhost-graceful-unicorn`과 같은 이름을 생성합니다. 동일한 효과를 위해 `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`를 설정합니다 | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--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` |125| `--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` |

126| `--restricted` | 제한된 모드에서 시작합니다. 평가 하네스가 공유 머신에서 `claude`를 구동하고 Claude Code가 명령어를 실행하거나 해당 머신의 사용자 및 프로젝트 설정을 읽지 않아야 할 때 사용합니다. Claude Code는 명령어를 실행하거나 코드를 실행하는 기본 제공 도구와 WebFetch를 제거합니다. `--tools`에서 개별적으로 이름을 지으면 제외됩니다. `default` 프리셋을 통하지 않습니다. 또한 기본 제공 파일 도구를 [작업 디렉토리](/docs/ko/permissions#working-directories)로 제한하고, [관리되는 설정](/docs/ko/managed-settings) 및 `--settings`만 로드하며, [`bypassPermissions`](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)를 거부하고, [제한된 세션에서 클라우드 세션을 생성하기를 거부합니다](/docs/ko/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Claude Code v2.1.248 이상이 필요합니다 | `claude --restricted -p "query"` |126| `--restricted` | 제한된 모드에서 시작합니다. 평가 하네스가 공유 머신에서 `claude`를 구동하고 Claude Code가 해당 머신의 명령을 실행하거나 사용자 및 프로젝트 설정을 읽지 않아야 할 때 사용합니다. Claude Code는 명령을 실행하거나 코드를 실행하는 기본 제공 도구와 WebFetch를 제거합니다. `--tools`에서 개별적으로 이름을 지정하지 않는 한 `default` 사전 설정을 통해서는 제거합니다. 또한 기본 제공 파일 도구를 [작업 디렉터리](/docs/ko/permissions#working-directories)로 제한하고, [관리되는 설정](/docs/ko/managed-settings) 및 `--settings`만 로드하며, [`bypassPermissions`](/docs/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode)를 거부하고, [제한된 세션에서 클라우드 세션을 만드는 것을 거부합니다](/docs/ko/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Claude Code v2.1.248 이상이 필요합니다 | `claude --restricted -p "query"` |

127| `--resume`, `-r` | ID 또는 이름으로 특정 세션을 재개하거나 세션을 선택할 수 있는 대화형 선택기를 표시합니다. ID 대신 세션의 `.jsonl` [트랜스크립트 파일](/docs/ko/sessions#where-transcripts-are-stored)의 절대 경로를 전달할 수 있습니다. 선택기 및 이름 검색은 `/add-dir`으로 이 디렉토리를 추가한 세션을 포함합니다. 세션 ID를 전달하면 Claude Code는 현재 프로젝트 디렉토리 및 해당 git worktrees를 검색한 후 이 머신의 다른 모든 프로젝트를 검색합니다. v2.1.223 이전에는 ID 검색이 현재 프로젝트 디렉토리 및 해당 git worktrees만 다루었습니다. [백그라운드 세션](/docs/ko/agent-view)은 선택기에 `bg`로 표시됩니다 | `claude --resume auth-refactor` |127| `--resume`, `-r` | ID 또는 이름으로 특정 세션을 재개하거나 세션을 선택할 대화형 선택기를 표시합니다. ID 대신 세션의 `.jsonl` [트랜스크립트 파일](/docs/ko/sessions#where-transcripts-are-stored)의 절대 경로를 전달할 수 있습니다. 선택기 및 이름 검색에는 이 디렉터리를 `/add-dir`로 추가한 세션이 포함됩니다. 세션 ID를 전달하면 Claude Code는 현재 프로젝트 디렉터리 및 해당 git 워크트리를 검색한 다음 이 머신의 다른 모든 프로젝트를 검색합니다. v2.1.223 이전에는 ID 검색이 현재 프로젝트 디렉터리 및 해당 git 워크트리만 다루었습니다. [백그라운드 세션](/docs/ko/agent-view)은 `bg`로 표시된 선택기에 나타납니다 | `claude --resume auth-refactor` |

128| `--safe-mode` | 손상된 구성을 문제 해결하기 위해 모든 사용자 정의를 비활성화한 상태로 시작합니다: CLAUDE.md, skills, plugins, hooks, MCP 서버, 사용자 정의 명령어 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령어, LSP 서버 및 자동 메모리가 로드되지 않습니다. 인증, 모델 선택, 기본 제공 도구 및 권한은 정상적으로 작동하며, 이는 [`--bare`](/docs/ko/headless#start-faster-with-bare-mode)와 다릅니다. 관리되는 설정 정책은 여전히 적용되며, 정책 구성 hooks, 상태 줄 및 파일 제안 명령어를 포함합니다. 관리되는 plugins, 관리되는 skills, 관리되는 CLAUDE.md 및 정책 구성 MCP 서버는 로드되지 않습니다. [자동 모델 폴백](/docs/ko/model-config#automatic-model-fallback)을 트리거하는 사용자 정의인지 확인하는 데 유용합니다. [`CLAUDE_CODE_SAFE_MODE`](/docs/ko/env-vars)를 설정합니다 | `claude --safe-mode` |128| `--safe-mode` | 손상된 구성을 문제 해결하기 위해 모든 사용자 정의를 비활성화하여 시작합니다: CLAUDE.md, 스킬, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버 및 자동 메모리는 로드되지 않습니다. 인증, 모델 선택, 기본 제공 도구 및 권한은 정상적으로 작동하며, 이는 [`--bare`](/docs/ko/headless#start-faster-with-bare-mode)와 다릅니다. 관리되는 설정 정책은 여전히 적용되며, 정책 구성 훅, 상태 줄 및 파일 제안 명령을 포함합니다. 관리되는 플러그인, 관리되는 스킬, 관리되는 CLAUDE.md 및 정책 구성 MCP 서버는 포함되지 않습니다. [자동 모델 폴백](/docs/ko/model-config#automatic-model-fallback)을 트리거하는 사용자 정의를 확인하는 데 유용합니다. [`CLAUDE_CODE_SAFE_MODE`](/docs/ko/env-vars)를 설정합니다 | `claude --safe-mode` |

129| `--session-id` | 대화에 특정 세션 ID를 사용합니다(유효한 UUID여야 함) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |129| `--session-id` | 대화에 특정 세션 ID를 사용합니다(유효한 UUID여야 함) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | 로드할 설정 소스의 쉼표로 구분된 목록(`user`, `project`, `local`) | `claude --setting-sources user,project` |130| `--setting-sources` | 로드할 설정 소스의 쉼표로 구분된 목록(`user`, `project`, `local`) | `claude --setting-sources user,project` |

131| `--settings` | 설정 JSON 파일 또는 인라인 JSON 문자열의 경로입니다. 여기서 설정한 값은 이 세션에 대해 `settings.json` 파일의 동일한 키를 재정의합니다. 생략한 키는 파일 기반 값을 유지합니다. 파일은 2 MiB 이하의 일반 파일이어야 합니다. [설정 우선순위](/docs/ko/settings#settings-precedence) 참조 | `claude --settings ./settings.json` |131| `--settings` | 설정 JSON 파일 또는 인라인 JSON 문자열의 경로입니다. 여기서 설정한 값은 이 세션에 대해 `settings.json` 파일의 동일한 키를 재정의합니다. 생략한 키는 파일 기반 값을 유지합니다. 파일은 2 MiB 이하의 일반 파일이어야 합니다. [설정 우선 순위](/docs/ko/settings#settings-precedence)를 참조하세요 | `claude --settings ./settings.json` |

132| `--strict-mcp-config` | `--mcp-config`의 MCP 서버만 사용하고 다른 모든 MCP 구성을 무시합니다. 관리되는 MCP 파일에서 플래그가 수행하는 작업에 대해 [관리되는 mcp.json으로 독점 제어](/docs/ko/managed-mcp#exclusive-control-with-managed-mcp-json) 참조 | `claude --strict-mcp-config --mcp-config ./mcp.json` |132| `--strict-mcp-config` | `--mcp-config`의 MCP 서버만 사용하고 다른 모든 MCP 구성을 무시합니다. 관리되는 MCP 파일에서 플래그가 수행하는 작업에 대해 [managed-mcp.json으로 독점 제어](/docs/ko/managed-mcp#exclusive-control-with-managed-mcp-json)를 참조하세요 | `claude --strict-mcp-config --mcp-config ./mcp.json` |

133| `--system-prompt` | 전체 시스템 프롬프트를 사용자 정의 텍스트로 바꿉니다 | `claude --system-prompt "You are a Python expert"` |133| `--system-prompt` | 전체 시스템 프롬프트를 사용자 정의 텍스트로 바꿉니다 | `claude --system-prompt "You are a Python expert"` |

134| `--system-prompt-file` | 파일에서 시스템 프롬프트를 로드하여 기본 프롬프트를 바꿉니다 | `claude --system-prompt-file ./custom-prompt.txt` |134| `--system-prompt-file` | 파일에서 시스템 프롬프트를 로드하여 기본 프롬프트를 바꿉니다 | `claude --system-prompt-file ./custom-prompt.txt` |

135| `--system-prompt-snapshot` | 대화의 [첫 번째 요청에 기록된](#system-prompt-flags-in-resumed-conversations) 프롬프트를 재사용하는 대신 모든 요청에서 시스템 프롬프트를 재구성하려면 `off`를 전달합니다. 예를 들어 `--continue` 실행 간에 `--append-system-prompt` 텍스트를 반복할 때입니다. Claude Code v2.1.257 이상이 필요합니다 | `claude --system-prompt-snapshot off` |135| `--system-prompt-snapshot` | `off`를 전달하여 [대화의 첫 번째 요청에 기록된 프롬프트](#system-prompt-flags-in-resumed-conversations)를 재사용하는 대신 모든 요청에서 시스템 프롬프트를 다시 빌드합니다. 예를 들어 `--continue` 실행 간에 `--append-system-prompt` 텍스트를 반복할 때입니다. Claude Code v2.1.257 이상이 필요합니다 | `claude --system-prompt-snapshot off` |

136| `--teleport` | 로컬 터미널에서 [웹 세션](/docs/ko/claude-code-on-the-web)을 재개합니다 | `claude --teleport` |136| `--teleport` | 로컬 터미널에서 [클라우드 세션](/docs/ko/claude-code-on-the-web)을 재개합니다 | `claude --teleport` |

137| `--teammate-mode` | [에이전트 팀](/docs/ko/agent-teams) 팀원 표시 방식을 설정합니다: `in-process`(기본값), `auto`, `tmux` 또는 `iterm2`(v2.1.186에서 추가됨). [`teammateMode`](/docs/ko/settings-reference#teammatemode) 설정을 이 세션에 대해 재정의합니다. [디스플레이 모드 선택](/docs/ko/agent-teams#choose-a-display-mode) 참조 | `claude --teammate-mode auto` |137| `--teammate-mode` | [에이전트 팀](/docs/ko/agent-teams) 팀원이 표시되는 방식을 설정합니다: `in-process`(기본값), `auto`, `tmux` 또는 `iterm2`(v2.1.186에서 추가됨). 이 세션에 대해 [`teammateMode`](/docs/ko/settings-reference#teammatemode) 설정을 재정의합니다. [디스플레이 모드 선택](/docs/ko/agent-teams#choose-a-display-mode)을 참조하세요 | `claude --teammate-mode auto` |

138| `--tmux` | worktree에 대한 tmux 세션을 생성합니다. `--worktree`가 필요합니다. 사용 가능한 경우 iTerm2 네이티브 창을 사용합니다. 기존 tmux의 경우 `--tmux=classic`을 전달합니다 | `claude -w feature-auth --tmux` |138| `--tmux` | 워크트리에 대한 tmux 세션을 만듭니다. `--worktree`가 필요합니다. 사용 가능할 때 iTerm2 네이티브 창을 사용합니다. 기존 tmux의 경우 `--tmux=classic`을 전달합니다 | `claude -w feature-auth --tmux` |

139| `--tools` | Claude가 사용할 수 있는 기본 제공 도구를 제한합니다. 모두 비활성화하려면 `""`를 사용하고, 기본 세트를 사용하려면 `"default"`를 사용하거나, `"Bash,Edit,Read"`와 같은 도구 이름을 사용합니다. macOS, Linux 및 WSL에서 기본 세트는 [Glob 도구 동작](/docs/ko/tools-reference#glob-tool-behavior)에 설명된 대로 `Glob` 및 `Grep`을 제외합니다. [작업 추적 도구](/docs/ko/tools-reference#task-tool-availability) 중 하나를 여기에 이름 지으면 Claude Code도 세션을 옵트인합니다. 플래그는 MCP 도구에 영향을 주지 않습니다. 이들도 거부하려면 `--disallowedTools "mcp__*"`를 사용합니다. [`EndConversation`](/docs/ko/tools-reference#endconversation-tool-behavior)을 생략하는 목록은 이를 제거하지 않습니다. `""`는 다른 MCP 도구가 남아 있지 않을 때만 이를 제거합니다 | `claude --tools "Bash,Edit,Read"` |139| `--tools` | Claude가 사용할 수 있는 기본 제공 도구를 제한합니다. 모두 비활성화하려면 `""`, 기본 집합의 경우 `"default"` 또는 `"Bash,Edit,Read"`와 같은 도구 이름을 사용합니다. macOS, Linux 및 WSL에서 기본 집합은 [Glob 도구 동작](/docs/ko/tools-reference#glob-tool-behavior)에 설명된 대로 `Glob` 및 `Grep`을 제외합니다. [작업 추적 도구](/docs/ko/tools-reference#task-tool-availability) 중 하나를 여기에 이름 지으면 Claude Code도 세션을 옵트인합니다. 플래그는 MCP 도구에 영향을 주지 않습니다. 이들도 거부하려면 `--disallowedTools "mcp__*"`를 사용합니다. [`EndConversation`](/docs/ko/tools-reference#endconversation-tool-behavior)을 생략하는 목록은 제거하지 않습니다. `""`는 MCP 도구가 남아 있지 않을 때만 제거합니다 | `claude --tools "Bash,Edit,Read"` |

140| `--verbose` | 자세한 로깅을 활성화하고 전체 턴별 출력을 표시합니다. [`viewMode`](/docs/ko/settings-reference#viewmode) 설정을 이 세션에 대해 재정의합니다 | `claude --verbose` |140| `--verbose` | 자세한 로깅을 활성화하고 전체 턴별 출력을 표시합니다. 이 세션에 대해 [`viewMode`](/docs/ko/settings-reference#viewmode) 설정을 재정의합니다 | `claude --verbose` |

141| `--version`, `-v` | 버전 번호를 출력합니다 | `claude -v` |141| `--version`, `-v` | 버전 번호를 출력합니다 | `claude -v` |

142| `--worktree`, `-w` | Claude를 `<repo>/.claude/worktrees/<name>`의 격리된 [git worktree](/docs/ko/worktrees)에서 시작합니다. 이름이 지정되지 않으면 Claude Code가 자동으로 생성합니다. `#<number>`, GitHub pull request URL 또는 GitLab merge request URL을 전달하여 [`origin`에서 해당 PR 또는 MR을 가져오고 worktree를 분기합니다](/docs/ko/worktrees#branch-from-a-pull-request). GitLab merge request에서 분기하려면 Claude Code v2.1.233 이상이 필요합니다 | `claude -w feature-auth` |142| `--worktree`, `-w` | Claude를 `<repo>/.claude/worktrees/<name>`의 격리된 [git 워크트리](/docs/ko/worktrees)에서 시작합니다. 이름을 지정하지 않으면 Claude Code가 생성합니다. `#<number>`, GitHub 풀 요청 URL 또는 GitLab 병합 요청 URL을 전달하여 [해당 PR 또는 MR을 `origin`에서 가져오고 워크트리를 분기합니다](/docs/ko/worktrees#branch-from-a-pull-request). GitLab 병합 요청에서 분기하려면 Claude Code v2.1.233 이상이 필요합니다 | `claude -w feature-auth` |

143 143 

144<h3 id="system-prompt-flags">144<h3 id="system-prompt-flags">

145 시스템 프롬프트 플래그145 시스템 프롬프트 플래그

146</h3>146</h3>

147 147 

148Claude Code는 시스템 프롬프트를 사용자 정의하기 위한 5가지 플래그를 제공합니다. 4가지는 텍스트를 설정하고, `--system-prompt-snapshot`을 사용하면 대화가 시작한 텍스트를 유지할지 제어합니다. 5가지 모두 대화형 및 비대화형 모드에서 작동합니다.148Claude Code는 시스템 프롬프트를 사용자 정의하기 위한 5개의 플래그를 제공합니다. 4개는 텍스트를 설정하고, `--system-prompt-snapshot`을 사용하면 대화가 시작한 텍스트를 유지하는지 여부를 제어합니다. 5개 모두 대화형 및 비대화형 모드에서 작동합니다.

149 149 

150| 플래그 | 동작 | 예시 |150| 플래그 | 동작 | 예시 |

151| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------- |151| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------- |

152| `--system-prompt` | 전체 기본 프롬프트를 바꿉니다 | `claude --system-prompt "You are a Python expert"` |152| `--system-prompt` | 전체 기본 프롬프트를 바꿉니다 | `claude --system-prompt "You are a Python expert"` |

153| `--system-prompt-file` | 파일 내용으로 바꿉니다 | `claude --system-prompt-file ./prompts/review.txt` |153| `--system-prompt-file` | 파일 내용으로 바꿉니다 | `claude --system-prompt-file ./prompts/review.txt` |

154| `--append-system-prompt` | 기본 프롬프트에 추가합니다 | `claude --append-system-prompt "Always use TypeScript"` |154| `--append-system-prompt` | 기본 프롬프트에 추가합니다 | `claude --append-system-prompt "Always use TypeScript"` |

155| `--append-system-prompt-file` | 파일 내용을 기본 프롬프트에 추가합니다 | `claude --append-system-prompt-file ./style-rules.txt` |155| `--append-system-prompt-file` | 파일 내용을 기본 프롬프트에 추가합니다 | `claude --append-system-prompt-file ./style-rules.txt` |

156| `--system-prompt-snapshot` | `off`를 사용하면 모든 요청에서 프롬프트를 재구성합니다. `on`을 사용하면 기본값이며, [기록이 적용되는](#system-prompt-flags-in-resumed-conversations) 곳에서 기록된 프롬프트를 재사용합니다 | `claude --append-system-prompt "Draft rules" --system-prompt-snapshot off` |156| `--system-prompt-snapshot` | `off`를 사용하면 모든 요청에서 프롬프트를 다시 빌드합니다. `on`(기본값)을 사용하면 [기록이 적용되는 경우](#system-prompt-flags-in-resumed-conversations) 기록된 프롬프트를 재사용합니다 | `claude --append-system-prompt "Draft rules" --system-prompt-snapshot off` |

157 157 

158`--system-prompt`와 `--system-prompt-file`은 상호 배타적입니다. 추가 플래그는 바꾸기 플래그 중 하나와 결합할 수 있습니다.158`--system-prompt` 및 `--system-prompt-file`은 상호 배타적입니다. 추가 플래그는 대체 플래그 중 하나와 결합할 수 있습니다.

159 159 

160Claude Code의 기본 정체성이 여전히 작업에 맞는지에 따라 선택합니다. Claude가 코딩 어시스턴트로 남아 있으면서 추가 규칙도 따라야 할 때 추가 플래그를 사용합니다: 호출별 지시사항, 출력 형식 또는 `-p` 스크립트에 대한 도메인 컨텍스트입니다. 추가하면 기본 도구 지침, 안전 지시사항 및 코딩 규칙이 유지되므로 다른 부분만 제공하면 됩니다. Claude Code의 표면, 정체성 또는 권한 모델과 다를 때 바꾸기 플래그를 사용합니다. 예를 들어 사람이 감시하지 않는 파이프라인의 비코딩 에이전트입니다. 바꾸면 도구 지침 및 안전 지시사항을 포함한 전체 기본 프롬프트가 제거되므로 작업에 필요한 모든 것에 대해 책임을 져야 합니다.160Claude Code의 기본 정체성이 여전히 작업에 맞는지 여부에 따라 선택합니다. Claude가 추가 규칙도 따르는 코딩 어시스턴트로 남아 있어야 할 때 추가 플래그를 사용합니다: 호출별 지침, 출력 형식 또는 `-p` 스크립트에 대한 도메인 컨텍스트입니다. 추가하면 기본 도구 지침, 안전 지침 및 코딩 규칙이 유지되므로 다른 것만 제공하면 됩니다. 표면, 정체성 또는 권한 모델이 Claude Code와 다를 때 대체 플래그를 사용합니다. 예를 들어 인간이 감시하지 않는 파이프라인의 비코딩 에이전트입니다. 대체하면 도구 지침 및 안전 지침을 포함한 전체 기본 프롬프트가 삭제되므로 작업에 여전히 필요한 것에 대해 책임을 집니다.

161 161 

162지속적인 페르소나의 경우 프로젝트 간에 전환하고 공유할 수 있으며, [출력 스타일](/docs/ko/output-styles)을 사용합니다. 프로젝트 규칙 Claude가 항상 따라야 할 경우 [CLAUDE.md](/docs/ko/memory)를 사용합니다. [시스템 프롬프트에 대한 Agent SDK 가이드](/docs/ko/agent-sdk/modifying-system-prompts#decide-on-a-starting-point)는 더 깊이 있는 동일한 결정을 다룹니다.162프로젝트 간에 전환하고 공유할 수 있는 영구 페르소나의 경우 [출력 스타일](/docs/ko/output-styles)을 사용합니다. Claude가 항상 따라야 하는 프로젝트 규칙의 경우 [CLAUDE.md](/docs/ko/memory)를 사용합니다. [시스템 프롬프트에 대한 Agent SDK 가이드](/docs/ko/agent-sdk/modifying-system-prompts#decide-on-a-starting-point)는 더 깊이 있는 동일한 결정을 다룹니다.

163 163 

164<h4 id="system-prompt-flags-in-resumed-conversations">164<h4 id="system-prompt-flags-in-resumed-conversations">

165 재개된 대화에서 시스템 프롬프트 플래그165 재개된 대화에서 시스템 프롬프트 플래그

166</h4>166</h4>

167 167 

168기본적으로 Claude Code는 시스템 프롬프트를 한 번 빌드합니다. 대화의 첫 번째 요청에서 적용된 시스템 프롬프트 플래그의 텍스트를 사용하고 세션에 기록합니다. 대화가 압축될 때까지 이후의 모든 요청은 `--resume` 또는 `--continue`로 대화로 돌아온 후를 포함하여 기록된 프롬프트를 사용합니다. 나중에 다른 시스템 프롬프트 플래그 텍스트를 전달하거나 아무것도 전달하지 않으면 대화가 압축되거나 새 대화를 시작할 때 적용됩니다.168기본적으로 Claude Code는 시스템 프롬프트를 한 번 빌드합니다. 대화의 첫 번째 요청에서 적용된 시스템 프롬프트 플래그의 텍스트를 사용하고 세션에 기록합니다. 대화가 압축될 때까지 이후의 모든 요청은 `--resume` 또는 `--continue`로 대화로 돌아온 후를 포함하여 기록된 프롬프트를 사용합니다. 나중에 시작할 때 다른 시스템 프롬프트 플래그 텍스트를 전달하거나 아무것도 전달하지 않으면 대화가 압축되거나 새 대화를 시작할 때 적용됩니다.

169 169 

170`--bare`를 전달하거나 `CLAUDE_CODE_SIMPLE=1`을 설정하여 Claude Code를 [bare 모드](/docs/ko/headless#start-faster-with-bare-mode)에서 시작하면 `--system-prompt-snapshot on`을 전달하지 않는 한 기록이 꺼집니다. v2.1.268 이전에는 [기능 플래그를 가져오지 않는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 세션(Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry의 세션 포함)이 모든 요청에서 프롬프트를 재구성했고 `--system-prompt-snapshot`은 효과가 없었습니다.170[클라우드 세션](/docs/ko/cloud-environments) 외부에서 `--bare`를 전달하거나 `CLAUDE_CODE_SIMPLE=1`을 설정하여 Claude Code를 [베어 모드](/docs/ko/headless#start-faster-with-bare-mode)에서 시작하면 `--system-prompt-snapshot on`을 전달하지 않는 한 기록이 꺼집니다. v2.1.268 이전에는 [기능 플래그를 가져오지 않는](/docs/ko/env-vars#features-that-need-feature-flag-fetching) 세션(Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry의 세션 포함)이 모든 요청에서 프롬프트를 다시 빌드했고 `--system-prompt-snapshot`은 효과가 없었습니다.

171 171 

172대신 모든 요청에서 프롬프트를 재구성하려면, 예를 들어 `--continue` 실행 간에 텍스트 표현을 반복할 때 `--system-prompt-snapshot off`를 전달합니다. v2.1.265 이전에는 시스템 프롬프트 플래그를 전달하면 `--system-prompt-snapshot on`을 전달하지 않는 한 기록이 꺼졌습니다.172대신 모든 요청에서 프롬프트를 다시 빌드하려면(예: `--continue` 실행 간에 해당 단어를 반복할 때) `--system-prompt-snapshot off`를 전달합니다. v2.1.265 이전에는 시스템 프롬프트 플래그 중 하나를 전달하면 `--system-prompt-snapshot on`을 전달하지 않는 한 기록이 꺼졌습니다.

173 173 

174<h2 id="see-also">174<h2 id="see-also">

175 참고 항목175 참고 항목