Files
Obsidian/Claude/CLI 参考.md
T
2026-07-21 14:53:24 +08:00

151 lines
27 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "CLI 参考"
source: "https://code.claude.com/docs/zh-CN/cli-reference"
author:
published:
created: 2026-06-30
description: "Claude Code 命令行界面的完整参考,包括命令和标志。"
tags:
- "clippings"
---
## CLI 命令
您可以使用这些命令启动会话、管道内容、恢复对话和管理更新:
| 命令 | 描述 | 示例 |
| --- | --- | --- |
| `claude` | 启动交互式会话 | `claude` |
| `claude "query"` | 使用初始提示启动交互式会话 | `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>" "query"` | 按 ID 或名称恢复会话 | `claude -r "auth-refactor" "Finish this PR"` |
| `claude update` | 更新到最新版本 | `claude update` |
| `claude install [version]` | 安装或重新安装本机二进制文件。接受版本号如 `2.1.118` 、 `stable` 或 `latest` 。请参阅 [安装特定版本](https://code.claude.com/docs/zh-CN/setup#install-a-specific-version) | `claude install stable` |
| `claude auth login` | 登录您的 Anthropic 账户。使用 `--email` 预填充您的电子邮件地址,使用 `--sso` 强制 SSO 身份验证,使用 `--console` 使用 Anthropic Console 登录以进行 API 使用计费而不是 Claude 订阅 | `claude auth login --console` |
| `claude auth logout` | 从您的 Anthropic 账户登出 | `claude auth logout` |
| `claude auth status` | 以 JSON 格式显示身份验证状态。使用 `--text` 获取人类可读的输出。如果已登录,则以代码 0 退出,如果未登录,则以代码 1 退出 | `claude auth status` |
| `claude agents` | 打开 [agent view](https://code.claude.com/docs/zh-CN/agent-view) 以监控和分派并行后台会话。使用 `--cwd <path>` 仅显示在该目录下启动的会话,或使用 `--json` 将实时会话打印为 JSON 数组以供脚本使用( `--json --all` 也包括已完成的后台会话)。传递 `--permission-mode` 、 `--model` 、 `--effort` 或 `--agent` 以设置 [分派会话的默认值](https://code.claude.com/docs/zh-CN/agent-view#permission-mode-model-and-effort) 。接受 `--settings` 、 `--add-dir` 、 `--plugin-dir` 和 `--mcp-config` ,如顶级 `claude` 命令。打开 agent view 需要交互式终端 | `claude agents --json` |
| `claude attach <id>` | 在此终端中附加到 [后台会话](https://code.claude.com/docs/zh-CN/agent-view#manage-sessions-from-the-shell) | `claude attach 7c5dcf5d` |
| `claude auto-mode defaults` | 以 JSON 格式打印内置 [auto mode](https://code.claude.com/docs/zh-CN/permission-modes#eliminate-prompts-with-auto-mode) 分类器规则。使用 `claude auto-mode config` 查看应用了设置的有效配置 | `claude auto-mode defaults > rules.json` |
| `claude daemon status` | 打印后台会话 [supervisor](https://code.claude.com/docs/zh-CN/agent-view#the-supervisor-process) 的状态、版本、套接字目录和工作进程数以进行诊断。如果 supervisor 未运行,则退出代码 1 | `claude daemon status` |
| `claude daemon stop --any` | 停止后台会话 [supervisor](https://code.claude.com/docs/zh-CN/agent-view#the-supervisor-process) 及其托管的会话。传递 `--keep-workers` 以保持后台会话运行,以便下一个 supervisor 重新连接到它们。 `--any` 确认停止按需 supervisor,这是默认值。使用此命令从 [无响应的 supervisor](https://code.claude.com/docs/zh-CN/agent-view#agent-view-says-the-background-service-did-not-respond) 恢复 | `claude daemon stop --any --keep-workers` |
| `claude logs <id>` | 从 [后台会话](https://code.claude.com/docs/zh-CN/agent-view#manage-sessions-from-the-shell) 打印最近的输出 | `claude logs 7c5dcf5d` |
| `claude mcp` | 配置 Model Context Protocol (MCP) 服务器 | 请参阅 [Claude Code MCP 文档](https://code.claude.com/docs/zh-CN/mcp) 。 |
| `claude mcp login <name>` | 运行配置的 MCP 服务器的 OAuth 流程而不打开交互式 `/mcp` 面板。适用于 HTTP、SSE 和 claude.ai 连接器服务器。在 SSH 上添加 `--no-browser` 以打印授权 URL 而不是打开浏览器,然后在提示处粘贴重定向 URL。需要 Claude Code v2.1.186 或更高版本。请参阅 [从命令行进行身份验证](https://code.claude.com/docs/zh-CN/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |
| `claude mcp logout <name>` | 清除 MCP 服务器的存储 OAuth 凭据。需要 Claude Code v2.1.186 或更高版本 | `claude mcp logout sentry` |
| `claude plugin` | 管理 Claude Code [plugins](https://code.claude.com/docs/zh-CN/plugins) 。别名: `claude plugins` 。请参阅 [plugin 参考](https://code.claude.com/docs/zh-CN/plugins-reference#cli-commands-reference) 了解子命令 | `claude plugin install code-review@claude-plugins-official` |
| `claude project purge [path]` | 删除项目的所有本地 Claude Code 状态:记录、任务列表、调试日志、文件编辑历史、提示历史行和项目在 `~/.claude.json` 中的条目。省略 `[path]` 以从交互式列表中选择。标志: `--dry-run` 预览, `-y` / `--yes` 跳过确认, `-i` / `--interactive` 确认每一项, `--all` 用于每个项目。请参阅 [清除本地数据](https://code.claude.com/docs/zh-CN/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |
| `claude remote-control` | 启动 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control) 服务器以从 Claude.ai 或 Claude 应用控制 Claude Code。在服务器模式下运行(无本地交互式会话)。请参阅 [服务器模式标志](https://code.claude.com/docs/zh-CN/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |
| `claude respawn <id>` | 重启 [后台会话](https://code.claude.com/docs/zh-CN/agent-view#manage-sessions-from-the-shell) ,运行或已停止,保持其对话完整。使用 `--all` 重启每个运行中的会话,例如以获取更新的 Claude Code 二进制文件 | `claude respawn 7c5dcf5d` |
| `claude rm <id>` | 从列表中删除 [后台会话](https://code.claude.com/docs/zh-CN/agent-view#manage-sessions-from-the-shell) 。对话记录保留在您的本地计算机上,可通过 `claude --resume` 访问 | `claude rm 7c5dcf5d` |
| `claude setup-token` | 为 CI 和脚本生成长期 OAuth 令牌。将令牌打印到终端而不保存。需要 Claude 订阅。请参阅 [生成长期令牌](https://code.claude.com/docs/zh-CN/authentication#generate-a-long-lived-token) | `claude setup-token` |
| `claude stop <id>` | 停止 [后台会话](https://code.claude.com/docs/zh-CN/agent-view#manage-sessions-from-the-shell) 。也接受 `claude kill` | `claude stop 7c5dcf5d` |
| `claude ultrareview [target]` | 非交互式运行 [ultrareview](https://code.claude.com/docs/zh-CN/ultrareview#run-ultrareview-non-interactively) 。将发现结果打印到标准输出,成功时退出代码 0,失败时退出代码 1。使用 `--json` 获取原始有效负载,使用 `--timeout <minutes>` 覆盖 30 分钟的默认值 | `claude ultrareview 1234 --json` |
如果您输入错误的子命令,Claude Code 会建议最接近的匹配项并退出而不启动会话。例如, `claude udpate` 会打印 `Did you mean claude update?`。
## CLI 标志
使用这些命令行标志自定义 Claude Code 的行为。 `claude --help` 不会列出每个标志,因此标志在 `--help` 中的缺失并不意味着它不可用。
| 标志 | 描述 | 示例 |
| --- | --- | --- |
| `--add-dir` | 为 Claude 添加额外的工作目录以读取和编辑文件。授予文件访问权限;大多数 `.claude/` 配置 [不会从这些目录中发现](https://code.claude.com/docs/zh-CN/permissions#additional-directories-grant-file-access-not-configuration) 。验证每个路径是否存在为目录。要在会话间持久化这些目录,请在设置中设置 [`permissions.additionalDirectories`](https://code.claude.com/docs/zh-CN/settings#permission-settings) | `claude --add-dir ../apps ../lib` |
| `--advisor <model>` | 为此会话启用服务器端 [advisor tool](https://code.claude.com/docs/zh-CN/advisor) ,使用模型别名: `opus` 、 `sonnet` 或 `fable` (v2.1.170+),或完整模型 ID。优先于会话的 `advisorModel` 设置。需要 Claude Code v2.1.98 或更高版本 | `claude --advisor opus` |
| `--agent` | 为当前会话指定代理(覆盖 `agent` 设置) | `claude --agent my-custom-agent` |
| `--agents` | 通过 JSON 动态定义自定义 subagents。使用与 subagent [frontmatter](https://code.claude.com/docs/zh-CN/sub-agents#supported-frontmatter-fields) 相同的字段名称,加上代理指令的 `prompt` 字段 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |
| `--allow-dangerously-skip-permissions` | 将 `bypassPermissions` 添加到 `Shift+Tab` 模式循环中而不启动它。允许您以不同的模式(如 `plan` )开始,稍后切换到 `bypassPermissions` 。请参阅 [权限模式](https://code.claude.com/docs/zh-CN/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |
| `--allowedTools`, `--allowed-tools` | 无需提示权限即可执行的工具。请参阅 [权限规则语法](https://code.claude.com/docs/zh-CN/settings#permission-rule-syntax) 了解模式匹配。要限制哪些工具可用,请改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |
| `--append-system-prompt` | 将自定义文本附加到默认系统提示的末尾 | `claude --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | 从文件加载额外的系统提示文本并附加到默认提示 | `claude --append-system-prompt-file ./extra-rules.txt` |
| `--ax-screen-reader` | 渲染屏幕阅读器友好的输出:没有装饰性边框或动画的平面文本。强制使用经典渲染器,因此 [`tui`](https://code.claude.com/docs/zh-CN/settings#available-settings) 设置在会话期间无效。优先于 [`CLAUDE_AX_SCREEN_READER`](https://code.claude.com/docs/zh-CN/env-vars) 和 [`axScreenReader`](https://code.claude.com/docs/zh-CN/settings#available-settings) 设置。需要 Claude Code v2.1.181 或更高版本 | `claude --ax-screen-reader` |
| `--bare` | 最小模式:跳过 hooks、skills、plugins、MCP 服务器、自动内存和 CLAUDE.md 的自动发现,以便脚本化调用启动更快。Claude 可以访问 Bash、文件读取和文件编辑工具。设置 [`CLAUDE_CODE_SIMPLE`](https://code.claude.com/docs/zh-CN/env-vars) 。请参阅 [bare mode](https://code.claude.com/docs/zh-CN/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |
| `--betas` | 要包含在 API 请求中的 Beta 标头(仅限 API 密钥用户) | `claude --betas interleaved-thinking` |
| `--bg`, `--background` | 启动会话作为 [后台代理](https://code.claude.com/docs/zh-CN/agent-view) 并立即返回。打印会话 ID 和管理命令。与 `--exec` 结合以作为后台作业运行 shell 命令而不是 Claude 会话,或与 `--agent` 结合以运行特定的 subagent | `claude --bg "investigate the flaky test"` |
| `--channels` | (研究预览)MCP 服务器,其 [channel](https://code.claude.com/docs/zh-CN/channels) 通知 Claude 应在此会话中侦听。以空格分隔的 `plugin:<name>@<marketplace>` 条目列表。需要 Claude.ai 身份验证 | `claude --channels plugin:my-notifier@my-marketplace` |
| `--chrome` | 启用 [Chrome 浏览器集成](https://code.claude.com/docs/zh-CN/chrome) 以进行网络自动化和测试 | `claude --chrome` |
| `--continue`, `-c` | 加载当前目录中最近的对话。包括使用 `/add-dir` 添加此目录的会话 | `claude --continue` |
| `--dangerously-load-development-channels` | 启用不在批准的允许列表中的 [channels](https://code.claude.com/docs/zh-CN/channels-reference#test-during-the-research-preview) ,用于本地开发。接受 `plugin:<name>@<marketplace>` 和 `server:<name>` 条目。提示确认 | `claude --dangerously-load-development-channels server:webhook` |
| `--dangerously-skip-permissions` | 跳过权限提示。等同于 `--permission-mode bypassPermissions` 。请参阅 [权限模式](https://code.claude.com/docs/zh-CN/permission-modes#skip-all-checks-with-bypasspermissions-mode) 了解此操作跳过和不跳过的内容 | `claude --dangerously-skip-permissions` |
| `--debug` | 启用调试模式,可选类别过滤(例如, `"api,hooks"` 或 `"!statsig,!file"` ) | `claude --debug "api,mcp"` |
| `--debug-file <path>` | 将调试日志写入特定文件路径。隐式启用调试模式。优先于 `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |
| `--disable-slash-commands` | 为此会话禁用所有 skills 和命令 | `claude --disable-slash-commands` |
| `--disallowedTools`, `--disallowed-tools` | 拒绝规则。裸工具名称从模型的上下文中删除匹配的工具: `"Edit"` 删除 Edit, `"*"` 删除每个工具, `"mcp__*"` 删除每个 MCP 工具。作用域规则(如 `Bash(rm *)` )使工具保持可用,仅拒绝匹配的调用 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |
| `--effort` | 为当前会话设置 [工作量级别](https://code.claude.com/docs/zh-CN/model-config#adjust-effort-level) 。选项: `low` 、 `medium` 、 `high` 、 `xhigh` 、 `max` ;可用级别取决于模型。覆盖此会话的 [`effortLevel`](https://code.claude.com/docs/zh-CN/settings#available-settings) 设置,不会持久化 | `claude --effort high` |
| `--enable-auto-mode` | 在 v2.1.111 中移除。Auto mode 现在默认在 `Shift+Tab` 循环中;使用 `--permission-mode auto` 以它开始 | `claude --permission-mode auto` |
| `--exclude-dynamic-system-prompt-sections` | 将每台机器的部分从系统提示(工作目录、环境信息、内存路径、git 状态)移到第一条用户消息中。改进在运行相同任务的不同用户和机器之间的提示缓存重用。仅适用于默认系统提示;当设置 `--system-prompt` 或 `--system-prompt-file` 时忽略。与 `-p` 一起用于脚本化的多用户工作负载 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |
| `--exec` | 运行 shell 命令作为 PTY 支持的后台作业而不是启动 Claude 会话。与 `--bg` 一起使用以从 shell 启动 | `claude --bg --exec 'pytest -x'` |
| `--fallback-model` | 当主模型过载或不可用时启用自动回退到指定的模型,例如已停用的模型。接受逗号分隔的列表,按顺序尝试。请参阅 [Fallback model chains](https://code.claude.com/docs/zh-CN/model-config#fallback-model-chains) 。要在会话间持久化链,请使用 [`fallbackModel` 设置](https://code.claude.com/docs/zh-CN/settings#available-settings) ,此标志会覆盖它 | `claude --fallback-model sonnet,haiku` |
| `--fork-session` | 恢复时,创建新的会话 ID 而不是重用原始 ID(与 `--resume` 或 `--continue` 一起使用) | `claude --resume abc123 --fork-session` |
| `--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 hooks](https://code.claude.com/docs/zh-CN/hooks#setup) (仅打印模式) | `claude -p --init "query"` |
| `--init-only` | 运行 [Setup](https://code.claude.com/docs/zh-CN/hooks#setup) 和 `SessionStart` hooks,然后退出而不启动对话 | `claude --init-only` |
| `--include-hook-events` | 在输出流中包含所有 hook 生命周期事件。需要 `--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 Schema 匹配的验证 JSON 输出(仅打印模式,请参阅 [结构化输出](https://code.claude.com/docs/zh-CN/agent-sdk/structured-outputs) ) | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |
| `--maintenance` | 在会话前运行带有 `maintenance` 匹配器的 [Setup hooks](https://code.claude.com/docs/zh-CN/hooks#setup) (仅打印模式) | `claude -p --maintenance "query"` |
| `--max-budget-usd` | API 调用前停止的最大美元金额(仅打印模式) | `claude -p --max-budget-usd 5.00 "query"` |
| `--max-turns` | 限制代理转数(仅打印模式)。达到限制时以错误退出。默认无限制 | `claude -p --max-turns 3 "query"` |
| `--mcp-config` | 从 JSON 文件或字符串加载 MCP 服务器(以空格分隔) | `claude --mcp-config ./mcp.json` |
| `--model` | 为当前会话设置模型,使用最新模型的别名( `sonnet` 、 `opus` 、 `haiku` 或 `fable` )或模型的完整名称。覆盖 [`model`](https://code.claude.com/docs/zh-CN/settings#available-settings) 设置和 [`ANTHROPIC_MODEL`](https://code.claude.com/docs/zh-CN/model-config#environment-variables) | `claude --model claude-sonnet-4-6` |
| `--name`, `-n` | 为会话设置显示名称,显示在 `/resume` 和终端标题中。您可以使用 `claude --resume <name>` 恢复命名会话。 [`/rename`](https://code.claude.com/docs/zh-CN/commands) 在会话中更改名称,也会在提示栏中显示 | `claude -n "my-feature-work"` |
| `--no-chrome` | 为此会话禁用 [Chrome 浏览器集成](https://code.claude.com/docs/zh-CN/chrome) | `claude --no-chrome` |
| `--no-session-persistence` | 禁用会话持久化,以便会话不会保存到磁盘且无法恢复。仅打印模式。 [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/zh-CN/env-vars) 环境变量在任何模式下都做同样的事情 | `claude -p --no-session-persistence "query"` |
| `--output-format` | 为打印模式指定输出格式(选项: `text` 、 `json` 、 `stream-json` ) | `claude -p "query" --output-format json` |
| `--permission-mode` | 以指定的 [权限模式](https://code.claude.com/docs/zh-CN/permission-modes) 开始。接受 `default` 、 `acceptEdits` 、 `plan` 、 `auto` 、 `dontAsk` 或 `bypassPermissions` 。覆盖设置文件中的 `defaultMode` | `claude --permission-mode plan` |
| `--permission-prompt-tool` | 指定 MCP 工具以在非交互模式下处理权限提示 | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |
| `--plugin-dir` | 仅为此会话从目录或 `.zip` 存档加载插件。每个标志采用一个路径。重复该标志以获取多个插件: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |
| `--plugin-url` | 仅为此会话从 URL 获取插件 `.zip` 存档。重复该标志以获取多个插件,或在单个引用值中传递以空格分隔的 URL | `claude --plugin-url https://example.com/plugin.zip` |
| `--print`, `-p` | 打印响应而不进入交互模式(请参阅 [Agent SDK 文档](https://code.claude.com/docs/zh-CN/agent-sdk/overview) 了解编程使用详情) | `claude -p "query"` |
| `--prompt-suggestions` | 在每轮后发出 `prompt_suggestion` 消息,带有预测的下一个用户提示。需要 `--print` 、 `--output-format stream-json` 和 `--verbose` 。请参阅 [提示建议](https://code.claude.com/docs/zh-CN/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |
| `--remote` | 在 claude.ai 上创建新的 [网络会话](https://code.claude.com/docs/zh-CN/claude-code-on-the-web) ,提供任务描述 | `claude --remote "Fix the login bug"` |
| `--remote-control`, `--rc` | 启动启用了 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control#start-a-remote-control-session) 的交互式会话,以便您也可以从 claude.ai 或 Claude 应用控制它。可选地为会话传递名称 | `claude --remote-control "My Project"` |
| `--remote-control-session-name-prefix <prefix>` | 当未设置显式名称时, [Remote Control](https://code.claude.com/docs/zh-CN/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` |
| `--resume`, `-r` | 按 ID 或名称恢复特定会话,或显示交互式选择器以选择会话。选择器和名称搜索包括使用 `/add-dir` 添加此目录的会话;传递会话 ID 仅搜索当前项目目录及其 git worktrees。截至 v2.1.144, [后台会话](https://code.claude.com/docs/zh-CN/agent-view) 在选择器中显示,标记为 `bg` | `claude --resume auth-refactor` |
| `--safe-mode` | 以所有自定义禁用的状态启动以排查损坏的配置:CLAUDE.md、skills、plugins、hooks、MCP 服务器、自定义命令和代理、输出样式、工作流、自定义主题、自定义快捷键、状态行和文件建议命令、LSP 服务器和自动内存不加载。身份验证、模型选择、内置工具和权限正常工作,这与 [`--bare`](https://code.claude.com/docs/zh-CN/headless#start-faster-with-bare-mode) 不同。托管设置策略仍然适用,包括策略配置的 hooks、状态行和文件建议命令;托管插件、托管 skills、托管 CLAUDE.md 和策略配置的 MCP 服务器不适用。用于检查自定义是否触发 [从 Fable 5 自动回退](https://code.claude.com/docs/zh-CN/model-config#automatic-model-fallback) 。设置 [`CLAUDE_CODE_SAFE_MODE`](https://code.claude.com/docs/zh-CN/env-vars) | `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` 文件中的相同键。您省略的键保留其基于文件的值。请参阅 [设置优先级](https://code.claude.com/docs/zh-CN/settings#settings-precedence) | `claude --settings ./settings.json` |
| `--strict-mcp-config` | 仅使用来自 `--mcp-config` 的 MCP 服务器,忽略所有其他 MCP 配置 | `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` |
| `--teleport` | 在本地终端中恢复 [网络会话](https://code.claude.com/docs/zh-CN/claude-code-on-the-web) | `claude --teleport` |
| `--teammate-mode` | 设置 [agent team](https://code.claude.com/docs/zh-CN/agent-teams) 队友的显示方式: `in-process` (默认)、 `auto` 、 `tmux` 或 } `iterm2` (在 v2.1.186 中添加)。默认值在 v2.1.179 中从 `auto` 更改。覆盖此会话的 [`teammateMode`](https://code.claude.com/docs/zh-CN/settings#available-settings) 设置。请参阅 [选择显示模式](https://code.claude.com/docs/zh-CN/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |
| `--tmux` | 为 worktree 创建 tmux 会话。需要 `--worktree` 。在可用时使用 iTerm2 原生窗格;传递 `--tmux=classic` 以使用传统 tmux | `claude -w feature-auth --tmux` |
| `--tools` | 限制 Claude 可以使用的内置工具。使用 `""` 禁用所有, `"default"` 表示全部,或工具名称如 `"Bash,Edit,Read"` 。MCP 工具不受影响;要拒绝这些工具,请改用 `--disallowedTools "mcp__*"` ,或传递 `--strict-mcp-config` 而不带 `--mcp-config` 以便不加载 MCP 服务器 | `claude --tools "Bash,Edit,Read"` |
| `--verbose` | 启用详细日志记录,显示完整的逐轮输出。覆盖此会话的 [`viewMode`](https://code.claude.com/docs/zh-CN/settings#available-settings) 设置 | `claude --verbose` |
| `--version`, `-v` | 输出版本号 | `claude -v` |
| `--worktree`, `-w` | 在隔离的 [git worktree](https://code.claude.com/docs/zh-CN/worktrees) 中启动 Claude,位于 `<repo>/.claude/worktrees/<name>` 。如果未给出名称,则自动生成一个。传递 `#<number>` 或 GitHub 拉取请求 URL 以从 `origin` 获取该 PR 并从其分支 worktree | `claude -w feature-auth` |
### 系统提示标志
Claude Code 提供四个标志用于自定义系统提示。所有四个都在交互和非交互模式下工作。
| 标志 | 行为 | 示例 |
| --- | --- | --- |
| `--system-prompt` | 替换整个默认提示 | `claude --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | 用文件内容替换 | `claude --system-prompt-file ./prompts/review.txt` |
| `--append-system-prompt` | 附加到默认提示 | `claude --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | 将文件内容附加到默认提示 | `claude --append-system-prompt-file ./style-rules.txt` |
`--system-prompt` 和 `--system-prompt-file` 互斥。附加标志可以与任一替换标志组合。
根据 Claude Code 的默认身份是否仍然适合您的任务来选择。当 Claude 应该保持编码助手身份同时遵循您的额外规则时,使用附加标志:每次调用的指令、输出格式或 `-p` 脚本的域上下文。附加保留默认工具指导、安全指令和编码约定,因此您只需提供不同的部分。当表面、身份或权限模型与 Claude Code 的不同时,使用替换标志,例如管道中没有人监视的非编码代理。替换会删除整个默认提示,包括工具指导和安全指令,因此您需要对任务仍然需要的任何内容负责。
这些标志仅适用于当前调用。对于可以在项目中切换和共享的持久化角色,请使用 [输出样式](https://code.claude.com/docs/zh-CN/output-styles) 。对于 Claude 应该始终遵循的项目约定,请使用 [CLAUDE.md](https://code.claude.com/docs/zh-CN/memory) 。 [Agent SDK 系统提示指南](https://code.claude.com/docs/zh-CN/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) 更深入地涵盖了相同的决策。
## 另请参阅
- [Chrome 扩展](https://code.claude.com/docs/zh-CN/chrome) - 浏览器自动化和网络测试
- [交互模式](https://code.claude.com/docs/zh-CN/interactive-mode) - 快捷键、输入模式和交互功能
- [快速入门指南](https://code.claude.com/docs/zh-CN/quickstart) - Claude Code 入门
- [常见工作流](https://code.claude.com/docs/zh-CN/common-workflows) - 高级工作流和模式
- [设置](https://code.claude.com/docs/zh-CN/settings) - 配置选项
- [Agent SDK 文档](https://code.claude.com/docs/zh-CN/agent-sdk/overview) - 编程使用和集成
[命令](https://code.claude.com/docs/zh-CN/commands)