Claude Code 命令行界面（CLI）的完整参考手册，覆盖所有顶层命令、40+ 启动 Flag 和系统提示词自定义策略。
CLI 顶层命令
| 命令 | 描述 | 示例 |
|---|---|---|
claude | 启动交互会话 | claude |
claude "query" | 带初始提示词启动交互会话 | claude "explain this project" |
claude -p "query" | 通过 SDK 查询后退出（Print 模式） | 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 auth login | 登录 Anthropic 账号（--email 预填邮箱，--sso 强制 SSO） | claude auth login --sso |
claude auth logout | 退出登录 | claude auth logout |
claude auth status | 显示认证状态（JSON，--text 可读格式；0=已登录，1=未登录） | claude auth status |
claude agents | 列出所有已配置的 Subagent（按来源分组） | claude agents |
claude mcp | 配置 MCP 服务器 | — |
claude remote-control | 启动���程控制会话（从 claude.ai 控制本地 Claude Code） | claude remote-control |
全部 CLI Flags（40+）
会话控制
| Flag | 描述 | 示例 |
|---|---|---|
--continue, -c | 加载当前目录最近的对话 | claude --continue |
--resume, -r | 按 ID/名称恢复会话，或打开选择器 | claude --resume auth-refactor |
--fork-session | 恢复时创建新会话 ID（与 --resume/--continue 配合） | claude --resume abc123 --fork-session |
--from-pr | 恢复与指定 GitHub PR 关联的会话（PR 号或 URL） | claude --from-pr 123 |
--session-id | 指定会话 UUID | claude --session-id "550e..." |
--no-session-persistence | 禁用会话持久化（仅 Print 模式） | claude -p --no-session-persistence "query" |
模型与输出
| Flag | 描述 | 示例 |
|---|---|---|
--model | 设置模型（别名：sonnet/opus，或完整名称） | claude --model claude-sonnet-4-6 |
--print, -p | Print 模式（非交互，输出后退出） | claude -p "query" |
--output-format | 输出格式：text / json / stream-json | claude -p "query" --output-format json |
--input-format | 输入格式：text / stream-json | claude -p --input-format stream-json |
--include-partial-messages | 包含流式事件（需 --print + stream-json） | — |
--json-schema | 验证 Agent 输出匹配 JSON Schema（仅 Print 模式） | claude -p --json-schema '{...}' "query" |
--fallback-model | 默认模型过载时自动降级（仅 Print 模式） | claude -p --fallback-model sonnet "query" |
--max-budget-usd | API 消费上限（美元，仅 Print 模式） | claude -p --max-budget-usd 5.00 "query" |
--max-turns | 限制 Agentic 轮次（仅 Print 模式，超限报错） | claude -p --max-turns 3 "query" |
--verbose | 启用详细日志（逐轮完整输出） | claude --verbose |
--version, -v | 输出版本号 | claude -v |
工具与权限
| Flag | 描述 | 示例 |
|---|---|---|
--tools | 限制可用工具（"" 禁用所有，"default" 全部，或具名工具列表） | claude --tools "Bash,Edit,Read" |
--allowedTools | 无需确认执行的工具（支持模式匹配） | "Bash(git log *)" "Read" |
--disallowedTools | 从上下文中完全移除的工具 | "Edit" "Bash(rm *)" |
--permission-mode | 初始权限模式（如 plan） | claude --permission-mode plan |
--allow-dangerously-skip-permissions | 允许跳过权限（不立即激活，与 --permission-mode 组合） | — |
--dangerously-skip-permissions | 跳过所有权限提示（慎用） | claude --dangerously-skip-permissions |
--permission-prompt-tool | 指定 MCP 工具处理权限提示（非交互模式） | claude -p --permission-prompt-tool mcp_auth "query" |
工作目录与项目
| Flag | 描述 | 示例 |
|---|---|---|
--add-dir | 添加额外工作目录（验证路径存在） | claude --add-dir ../apps ../lib |
--worktree, -w | 在隔离的 git worktree 中启动（<repo>/.claude/worktrees/<name>） | claude -w feature-auth |
--init | 运行初始化 Hook 并进入交互模式 | claude --init |
--init-only | 运行初始化 Hook 后退出 | claude --init-only |
--maintenance | 运行维护 Hook 后退出 | claude --maintenance |
Subagent 与 MCP
| Flag | 描述 | 示例 |
|---|---|---|
--agent | 指定当前会话的 Agent（覆盖 agent 设置） | claude --agent my-custom-agent |
--agents | 通过 JSON 动态定义 Subagent（见下文） | claude --agents '{...}' |
--teammate-mode | Agent 团队展示模式：auto/in-process/tmux | claude --teammate-mode in-process |
--mcp-config | 从 JSON 文件/字符串加载 MCP 服务器 | claude --mcp-config ./mcp.json |
--strict-mcp-config | 仅使用 --mcp-config 的 MCP，忽略其他配置 | claude --strict-mcp-config --mcp-config ./mcp.json |
其他
| Flag | 描述 | 示例 |
|---|---|---|
--chrome | 启用 Chrome 浏览器集成 | claude --chrome |
--no-chrome | 禁用 Chrome 集成（当前会话） | claude --no-chrome |
--ide | 启动时自动连接 IDE（仅有一个可用 IDE 时） | claude --ide |
--plugin-dir | 从目录加载插件（当前会话，可重复） | claude --plugin-dir ./my-plugins |
--setting-sources | 设置来源：user/project/local（逗号分隔） | claude --setting-sources user,project |
--settings | 加载额外设置（JSON 文件路径或 JSON 字符串） | claude --settings ./settings.json |
--betas | 包含在 API 请求中的 Beta Headers（仅 API Key 用户） | claude --betas interleaved-thinking |
--disable-slash-commands | 禁用所有 Skill 和命令 | claude --disable-slash-commands |
--debug | 调试模式（可选分类过滤，如 "api,hooks" 或 "!statsig"） | claude --debug "api,mcp" |
--remote | 在 claude.ai 创建新 Web 会话 | claude --remote "Fix the login bug" |
--teleport | 在本地终端恢复 Web 会话 | claude --teleport |
--agents Flag JSON 格式
--agents 接受一个 JSON 对象，动态定义一个或多个 Subagent：
json
claude --agents '{
"code-reviewer": {
"description": "专家级代码审查员。代码修改后主动调用。",
"prompt": "你是一位资深代码审查员，关注代码质量、安全性和最佳实践。",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "调试专家，处理错误和测试失败。",
"prompt": "你是一位专家级调试员，分析错误、定位根因并提供修复方案。"
}
}'| 字段 | 必填 | 描述 |
|---|---|---|
description | ✅ | 自然语言描述：何时调用此 Subagent |
prompt | ✅ | 指导 Subagent 行为的系统提示词 |
tools | ❌ | 可用工具数组（如 ["Read", "Edit", "Bash"]），省略则继承所有工具 |
disallowedTools | ❌ | 明确拒绝的工具数组 |
model | ❌ | 模型别名：sonnet/opus/haiku/inherit（默认 inherit） |
skills | ❌ | 预加载到 Subagent 上下文的 Skill 名称数组 |
mcpServers | ❌ | 此 Subagent 专用的 MCP 服务器（服务器名字符串或 {name: config} 对象数组） |
maxTurns | ❌ | Subagent 最大 Agentic 轮次 |
系统提示词四种模式
| Flag | 行为 | 适用场景 |
|---|---|---|
--system-prompt | 替换整个默认提示词 | 完全控制 Claude 行为（移除所有 Claude Code 默认指令） |
--system-prompt-file | 用文件内容替换默认提示词 | 团队一致性/版本控制的提示词模板 |
--append-system-prompt | 追加到默认提示词末尾 | 在保留 Claude Code 默认能力的同时添加特定指令（推荐） |
--append-system-prompt-file | 从文件追加到默认提示词末尾 | 版本控制的追加指令 |
bash
# 完全控制（移除默认行为）
claude --system-prompt "你是一位只写类型注解代码的 Python 专家"
# 从文件加载完整提示词
claude --system-prompt-file ./prompts/code-review.txt
# 追加（推荐，保留 Claude Code 默认能力）
claude --append-system-prompt "始终使用 TypeScript 并包含 JSDoc 注释"
# 从文件追加
claude --append-system-prompt-file ./prompts/style-rules.txt⚠️
--system-prompt和--system-prompt-file互斥；追加 Flag 可与替换 Flag 组合使用。大多数场景推荐使用--append-system-prompt，因为它在保留 Claude Code 内置能力的同时添加自定义需求。
常用组合模式
CI/CD 自动化（无交互，结构化输出）：
bash
claude -p "分析这次提交的安全风险" \
--output-format json \
--max-turns 5 \
--max-budget-usd 0.50团队共享 Subagent（自定义 Agent + 工具限制）：
bash
claude --agents '{"reviewer":{"description":"代码审查员","prompt":"...","tools":["Read","Grep"]}}' \
--append-system-prompt "只使用中文回复"隔离 Git Worktree 开发：
bash
claude -w feature-auth
# 自动在 .claude/worktrees/feature-auth 工作继续上次会话 + Print 模式：
bash
claude -c -p "检查类型错误" --output-format json原文：CLI reference - Claude Code Docs | 来源：Anthropic 官方文档