Claude Code CLI 提供丰富的命令和标志用于启动会话、程序化调用、管理认证和自定义行为。本文是完整的 CLI 参考手册。
CLI 命令#
| 命令 | 说明 | 示例 |
|---|
claude | 启动交互式会话 | claude |
claude "query" | 带初始提示词启动交互式会话 | claude "explain this project" |
claude -p "query" | 程序化查询，完成后退出 | claude -p "explain this function" |
cat file | claude -p "query" | 处理管道内容 | cat logs.txt | claude -p "explain" |
claude -c | 续接当前目录最近的对话 | claude -c |
claude -c -p "query" | 程序化续接 | 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 --email user@co.com --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 | 启动 Remote Control 会话（从 claude.ai 或 App 控制本地 Claude Code） | claude remote-control |
CLI 标志完整参考#
会话控制#
| 标志 | 说明 |
|---|
--continue, -c | 加载当前目录最近的对话 |
--resume, -r | 通过 ID 或名称恢复特定会话，或显示选择器 |
--fork-session | 续接时创建新 Session ID 而非复用原 ID（配合 --resume/--continue） |
--from-pr | 恢复与指定 GitHub PR 关联的会话（PR 编号或 URL） |
--remote | 在 claude.ai 创建新 Web 会话 |
--teleport | 在本地终端恢复 Web 会话 |
--worktree, -w | 在独立 git worktree 中启动 Claude（<repo>/.claude/worktrees/<name>） |
输出控制#
| 标志 | 说明 | 示例 |
|---|
--print, -p | 程序化模式，打印响应后退出 | claude -p "query" |
--output-format | 输出格式：text、json、stream-json | --output-format json |
--input-format | 输入格式：text、stream-json | --input-format stream-json |
--include-partial-messages | 包含流式部分消息（需 -p 和 stream-json） | — |
--verbose | 详细日志，显示完整逐轮输出 | — |
--json-schema | 按 JSON Schema 验证输出（仅 -p 模式） | --json-schema '{"type":"object",...}' |
--no-session-persistence | 禁用会话持久化（仅 -p 模式，不保存到磁盘） | — |
工具与权限#
| 标志 | 说明 |
|---|
--allowedTools | 无需提示即可执行的工具（权限规则语法，含通配符） |
--disallowedTools | 从模型上下文中移除的工具（不可使用） |
--tools | 限制可用内置工具（"" 禁用所有；"default" 全部；"Bash,Edit,Read" 指定） |
--permission-mode | 以指定权限模式启动（default/acceptEdits/plan/bypassPermissions） |
--dangerously-skip-permissions | 跳过所有权限提示（谨慎使用） |
--allow-dangerously-skip-permissions | 将跳过权限作为选项启用，但不立即激活（可配合 --permission-mode） |
--permission-prompt-tool | 指定 MCP 工具处理非交互模式的权限提示 |
系统提示词#
| 标志 | 行为 | 适用场景 |
|---|
--system-prompt | 替换整个默认系统提示词 | 完全控制 Claude 行为 |
--system-prompt-file | 替换为文件内容 | 版本控制的提示词模板 |
--append-system-prompt | 追加到默认提示词末尾 | 保留默认行为，添加指令 |
--append-system-prompt-file | 追加文件内容到默认提示词 | 文件版本的附加指令 |
--system-prompt 和 --system-prompt-file 互斥。追加标志可与替换标志组合使用。推荐大多数场景使用 --append-system-prompt，保留 Claude Code 内置��能。
Agent 与 MCP#
| 标志 | 说明 |
|---|
--agent | 指定当前会话的 Agent（覆盖 agent 设置） |
--agents | 动态定义 Subagent（JSON 格式，见下文） |
--mcp-config | 从 JSON 文件或字符串加载 MCP 服务器（空格分隔） |
--strict-mcp-config | 仅使用 --mcp-config 中的 MCP 服务器，忽略其他配置 |
模型与成本#
| 标志 | 说明 |
|---|
--model | 设置当前会话模型（别名或完整名称） |
--max-budget-usd | API 调用最大美元金额（仅 -p 模式） |
--max-turns | 限制 Agent 轮次（仅 -p 模式；达到上限时退出并报错） |
--fallback-model | 默认模型过载时自动回退（仅 -p 模式） |
--betas | 包含在 API 请求中的 Beta 头���仅 API Key 用户） |
其他标志#
| 标志 | 说明 |
|---|
--add-dir | 添加额外工作目录（验证路径存在） |
--chrome | 启用 Chrome 浏览器集成 |
--no-chrome | 禁用 Chrome 浏览器集成 |
--debug | 调试模式（可过滤分类，如 "api,mcp" 或 "!statsig") |
--disable-slash-commands | 禁用所有 Skills 和命令 |
--ide | 启动时自动连接 IDE（仅一个可用时） |
--init | 运行初始化 Hooks 并启动交互模式 |
--init-only | 运行初始化 Hooks 后退出（不启动会话） |
--maintenance | 运行维护 Hooks 后退出 |
--plugin-dir | 从目录加载插件（仅本次会话，可重复使用） |
--session-id | 指定会话 UUID |
--setting-sources | 逗号分隔的设置来源（user、project、local） |
--settings | 加载额外设置的 JSON 文件路径或 JSON 字符串 |
--teammate-mode | Agent 团队显示方式（auto/in-process/tmux） |
--version, -v | 输出版本号 |
--agents 标志 JSON 格式#
动态定义 Subagent：
claude --agents '{
"code-reviewer": {
"description": "代码审查专家，代码修改后主动使用",
"prompt": "你是高级代码审查员，专注代码质量、安全性和最佳实践",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "错误和测试失败的调试专家",
"prompt": "你是调试专家，分析错误、确定根因、提供修复方案"
}
}'
| 字段 | 必填 | 说明 |
|---|
description | 是 | 何时调用该 Subagent 的自然语言描述 |
prompt | 是 | 引导 Subagent 行为的系统提示词 |
tools | 否 | 可用工具数组（省略则继承所有） |
disallowedTools | 否 | 明确禁止的工具数组 |
model | 否 | 模型别名（sonnet/opus/haiku/inherit，默认 inherit） |
skills | 否 | 预加载到 Subagent 上下文的 Skill 名称数组 |
mcpServers | 否 | Subagent 的 MCP 服务器配置 |
maxTurns | 否 | 最大 Agent 轮次 |
原文：CLI reference - Claude Code Docs | 来源：Anthropic 官方文档