Claude Code 命令行手册中文版
来源：
claude --help输出完整转录
更新日期：2026-09-11
基本用法
claude [选项] [命令] [提示词]
默认行为：启动交互式会话
非交互式输出：使用 -p/--print
参数
| 参数 | 说明 |
|---|---|
prompt |
您的提示词 |
选项表
目录与权限
| 选项 | 简写 | 说明 |
|---|---|---|
--add-dir <directories...> |
允许工具访问的额外目录 | |
--allowedTools, --allowed-tools <tools...> |
允许的工具列表（逗号或空格分隔），如 "Bash(git *) Edit" |
|
--disallowedTools, --disallowed-tools <tools...> |
禁止的工具列表，如 "Bash(git *) Edit" |
|
--tools <tools...> |
指定可用的内置工具列表。"" 禁用所有，"default" 使用所有，或指定工具名（如 "Bash,Edit,Read"） |
|
--dangerously-skip-permissions |
绕过所有权限检查。仅推荐用于无互联网访问的沙箱 | |
--allow-dangerously-skip-permissions |
启用绕过所有权限检查的选项，但不默认开启。仅推荐用于无互联网访问的沙箱 | |
--permission-mode <mode> |
会话使用的权限模式（可选：acceptEdits, auto, bypassPermissions, manual, dontAsk, plan） |
会话管理
| 选项 | 简写 | 说明 |
|---|---|---|
-c, --continue |
-c |
在当前目录继续最近的对话 |
-r, --resume [value] |
-r |
通过会话 ID 恢复对话，或打开交互式选择器（可选搜索词） |
--fork-session |
恢复时创建新的会话 ID 而非复用原始 ID（配合 --resume 或 --continue 使用） |
|
--session-id <uuid> |
使用指定的会话 ID（必须是有效的 UUID） | |
--name <name> |
-n |
设置会话显示名称（显示在提示框、/resume 选择器和终端标题中） |
--no-session-persistence |
禁用会话持久化 - 会话不会保存到磁盘且无法恢复（仅配合 --print） |
模型与系统提示词
| 选项 | 简写 | 说明 |
|---|---|---|
--model <model> |
当前会话使用的模型。提供别名（如 fable, opus, sonnet）或完整模型名（如 claude-fable-5） |
|
--system-prompt <prompt> |
会话使用的系统提示词 | |
--append-system-prompt <prompt> |
向默认系统提示词追加内容 | |
--effort <level> |
当前会话的推理深度等级（low, medium, high, xhigh, max） |
|
--exclude-dynamic-system-prompt-sections |
将每机器动态段（cwd、环境信息、内存路径、git 状态）从系统提示词移至首条用户消息。提升跨用户提示词缓存复用。仅适用于默认系统提示词（配合 --system-prompt 时忽略）。默认：false |
|
--fallback-model <model> |
当默认模型过载或不可用时自动回退到指定模型。接受逗号分隔列表按顺序尝试。每个用户回合开始时重试主模型。（仅配合 --print） |
认证与配置
| 选项 | 简写 | 说明 |
|---|---|---|
--settings <file-or-json> |
设置 JSON 文件路径或 JSON 字符串，加载额外设置 | |
--setting-sources <sources> |
要加载的设置来源列表（user, project, local），逗号分隔 | |
--betas <betas...> |
API 请求中包含的 Beta 头（仅限 API key 用户） | |
--mcp-config <configs...> |
从 JSON 文件或字符串加载 MCP 服务器（空格分隔） | |
--strict-mcp-config |
仅使用 --mcp-config 指定的 MCP 服务器，忽略所有其他 MCP 配置 |
|
--plugin-dir <path> |
为此会话加载插件目录或 .zip（可重复：--plugin-dir A --plugin-dir B.zip）。默认：[] |
|
--plugin-url <url> |
为此会话从 URL 获取插件 .zip（可重复）。默认：[] | |
--agents <json> |
定义自定义 Agent 的 JSON 对象（如 '{"reviewer": {"description": "Reviews code", "prompt": "You are a code reviewer"}}'） |
|
--agent <agent> |
当前会话的 Agent。覆盖 agent 设置 |
输出格式
| 选项 | 简写 | 说明 |
|---|---|---|
-p, --print |
-p |
打印响应并退出（适合管道）。注意：非交互模式下（通过 -p 或 stdout 非 TTY 时）跳过工作区信任对话框。此模式下设置文件验证失败会被静默忽略（不显示错误对话框） |
--output-format <format> |
输出格式（仅配合 --print）：text（默认）、json（单结果）、stream-json（实时流式） |
|
--input-format <format> |
输入格式（仅配合 --print）：text（默认）、stream-json（实时流式输入） |
|
--include-partial-messages |
包含到达的部分消息块（仅配合 --print 和 --output-format=stream-json） |
|
--include-hook-events |
在输出流中包含所有钩子生命周期事件（仅配合 --output-format=stream-json） |
|
--forward-subagent-text |
将子 agent 文本和思维块作为带有 parent_tool_use_id 的助手/用户消息转发（仅配合 --print 和 --output-format=stream-json） |
|
--replay-user-messages |
将来自 stdin 的用户消息重新发送到 stdout 以确认（仅配合 --input-format=stream-json 和 --output-format=stream-json） |
|
--prompt-suggestions [value] |
启用提示建议。在 print/SDK 模式下，每轮后发送 prompt_suggestion 消息并预测下一个用户提示词（可选：true, false, 1, 0, yes, no, on, off，预设：true） |
|
--verbose |
覆盖配置中的详细模式设置 | |
--ax-screen-reader |
渲染屏幕阅读器友好的输出（纯文本，无装饰边框或动画） | |
--json-schema <schema> |
结构化输出验证的 JSON Schema。示例：{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]} |
调试与诊断
| 选项 | 简写 | 说明 |
|---|---|---|
-d, --debug [filter] |
-d |
启用调试模式，可选类别过滤（如 "api,hooks" 或 "!1p,!file"） |
--debug-file <path> |
将调试日志写入指定文件路径（隐式启用调试模式） | |
--autocompact <auto|tokens> |
自动压缩窗口大小（auto 或 100k–1M tokens） |
|
--max-budget-usd <amount> |
API 调用的最大美元预算（仅配合 --print） |
远程与云
| 选项 | 简写 | 说明 |
|---|---|---|
--cloud [description|session_id|url] |
使用给定描述创建云会话，或通过会话 ID 或 claude.ai/code URL 附加到现有会话 | |
--environment <environment_id> |
创建在指定自托管环境上运行的新云会话（ccpool_...） |
|
--remote-control [name] |
启用远程控制的交互式会话（可选命名） | |
--remote-control-session-name-prefix <prefix> |
自动生成的远程控制会话名称前缀（默认：主机名） | |
--ide |
启动时若仅有一个有效 IDE 可用则自动连接 | |
--no-chrome |
禁用 Claude in Chrome 集成 | |
--chrome |
启用 Claude in Chrome 集成 |
Git 与工作树
| 选项 | 简写 | 说明 |
|---|---|---|
-w, --worktree [name] |
-w |
为此会话创建新的 git worktree（可选指定名称） |
--tmux |
为此 worktree 创建 tmux 会话（需要 --worktree）。有 iTerm2 原生面板时使用；--tmux=classic 使用传统 tmux |
|
--from-pr [value] |
恢复与 PR 关联的会话（通过 PR 号/URL），或打开交互式选择器（可选搜索词） | |
--teleport [session] |
恢复 teleport 会话，可选指定会话 ID |
文件资源
| 选项 | 简写 | 说明 |
|---|---|---|
--file <specs...> |
启动时下载的文件资源。格式：file_id:relative_path（如 --file file_abc:doc.txt file_def:img.png） |
安全与兼容模式
| 选项 | 简写 | 说明 |
|---|---|---|
--safe-mode |
禁用所有自定义配置（CLAUDE.md、skills、plugins、hooks、MCP 服务器、自定义命令和 agents、输出样式、工作流、自定义主题、按键绑定等）——适合排查损坏的配置。管理员管理的策略设置仍生效。认证、模型选择、内置工具和权限正常工作。设置 CLAUDE_CODE_SAFE_MODE=1 |
|
--bare |
最小模式：跳过钩子、LSP、插件同步、归因、自动内存、后台预取、钥匙串读取和 CLAUDE.md 自动发现。设置 CLAUDE_CODE_SIMPLE=1。Anthropic 认证严格限于 ANTHROPIC_API_KEY 或通过 --settings 的 apiKeyHelper（OAuth 和钥匙串从不读取）。第三方提供商使用其自身凭据。Skills 仍通过 /skill-name 解析。需通过以下方式显式提供上下文：--system-prompt[-file]、--append-system-prompt[-file]、--add-dir（CLAUDE.md 目录）、--mcp-config、--settings、--agents、--plugin-dir |
其他
| 选项 | 简写 | 说明 |
|---|---|---|
-h, --help |
-h |
显示命令帮助 |
-v, --version |
-v |
输出版本号 |
--background, --bg |
--bg |
以后台 agent 方式启动会话并立即返回（通过 claude agents 管理） |
--brief |
启用 SendUserMessage 工具用于 agent 与用户通信 |
命令表
| 命令 | 说明 |
|---|---|
agents [options] |
管理后台 agents |
auth |
管理认证 |
auto-mode |
检查或重置自动模式分类器配置 |
doctor |
检查 Claude Code 安装健康状况。读取当前目录设置文件且无信任提示。完整检查（可修复问题）请在会话中运行 /doctor |
gateway [options] |
运行企业认证/遥测网关 |
import [options] [source] |
从另一个 AI 编码助手导入配置到 Claude Code |
install [options] [target] |
安装 Claude Code 原生构建。用 [target] 指定版本（stable、latest 或具体版本） |
mcp |
配置和管理 MCP 服务器 |
plugin / plugins |
管理 Claude Code 插件 |
project |
管理 Claude Code 项目状态 |
setup-token |
设置长期认证令牌（需要 Claude 订阅） |
ultrareview [options] [target] |
对当前分支（或 PR 号/基础分支）运行云端多 agent 代码审查并打印发现 |
update / upgrade |
检查更新并在可用时安装 |
常用组合示例
交互式开发
# 基础启动
claude
# 指定模型和权限模式
claude --model sonnet --permission-mode acceptEdits
# 继续上次对话
claude --continue
# 恢复特定会话
claude --resume abc-123-def
非交互式 / 管道模式
# 单次提问并退出
claude -p "解释这个函数的作用"
# JSON 输出便于程序解析
claude -p --output-format json "列出所有 TODO 注释"
# 流式 JSON 输出
claude -p --output-format stream-json "重构这段代码"
后台任务
# 启动后台 agent
claude --background -p "整理项目文档"
# 查看后台 agents
claude agents list
自定义配置
# 加载自定义设置
claude --settings ./my-settings.json
# 加载 MCP 服务器配置
claude --mcp-config ./mcp-servers.json
# 指定允许/禁止的工具
claude --allowed-tools "Bash,Read,Edit" --disallowed-tools "Bash(rm *)"
调试与诊断
# 启用调试模式
claude --debug api,hooks
# 健康检查
claude doctor
环境变量
| 变量 | 说明 |
|---|---|
ANTHROPIC_API_KEY |
API 密钥（优先级高于 OAuth 配置文件） |
ANTHROPIC_AUTH_TOKEN |
OAuth 访问令牌 |
ANTHROPIC_BASE_URL |
自定义 API 基础 URL |
CLAUDE_CODE_SAFE_MODE=1 |
启用安全模式（等同 --safe-mode） |
CLAUDE_CODE_SIMPLE=1 |
启用简化模式（等同 --bare） |
相关文件位置
| 文件/目录 | 用途 |
|---|---|
~/.claude/settings.json |
用户级配置 |
.claude/settings.json |
项目级配置 |
.claude/settings.local.json |
本地配置（不提交版控） |
~/.config/anthropic/ |
OAuth 配置文件目录 |
CLAUDE.md |
项目上下文文件（自动发现） |
本文档由 claude --help 输出完整转录并翻译而成。如有遗漏或错误，请以官方最新版本为准。