CLI 参考

Claude Code 命令行界面的完整参考，包括命令和标志。

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 auth login	登录 Anthropic 账户	claude auth login --email [email protected]
claude auth logout	登出	claude auth logout
claude auth status	显示身份验证状态	claude auth status
claude agents	列出所有已配置的 subagents	claude agents
claude mcp	配置 MCP 服务器	请参阅 MCP 文档
claude remote-control	启动 Remote Control 会话	claude remote-control

CLI 标志

常用标志

标志	描述	示例
--add-dir	添加其他工作目录	claude --add-dir ../apps ../lib
--agent	为当前会话指定代理	claude --agent my-custom-agent
--agents	动态定义自定义 subagents	claude --agents '{"reviewer":{...}}'
--allowedTools	无需提示权限即可执行的工具	"Bash(git log *)" "Read"
--append-system-prompt	附加到默认系统提示	claude --append-system-prompt "Always use TypeScript"
--chrome	启用 Chrome 浏览器集成	claude --chrome
--continue, -c	继续最近的对话	claude --continue
--dangerously-skip-permissions	跳过所有权限提示	claude --dangerously-skip-permissions
--debug	启用调试模式	claude --debug "api,mcp"
--disable-slash-commands	禁用所有 skills 和命令	claude --disable-slash-commands
--disallowedTools	从模型上下文中删除工具	"Bash(git log *)" "Edit"
--fork-session	创建新的会话 ID	claude --resume abc123 --fork-session
--from-pr	恢复链接到 GitHub PR 的会话	claude --from-pr 123
--ide	自动连接到 IDE	claude --ide
--init	运行初始化 hooks	claude --init
--model	设置模型	claude --model claude-sonnet-4-6
--output-format	指定输出格式	claude -p "query" --output-format json
--permission-mode	设置权限模式	claude --permission-mode plan
--print, -p	打印响应而不进入交互模式	claude -p "query"
--remote	创建网络会话	claude --remote "Fix the login bug"
--resume, -r	恢复特定会话	claude --resume auth-refactor
--session-id	使用特定的会话 ID	claude --session-id "uuid"
--tools	限制可用的内置工具	claude --tools "Bash,Edit,Read"
--verbose	启用详细日志记录	claude --verbose
--version, -v	输出版本号	claude -v
--worktree, -w	在隔离的 worktree 中启动	claude -w feature-auth

Agents 标志格式

--agents 标志接受 JSON 对象定义 subagents：

{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors.",
    "prompt": "You are an expert debugger."
  }
}

支持字段

字段	必需	描述
description	是	何时应调用 subagent 的描述
prompt	是	指导 subagent 行为的系统提示
tools	否	subagent 可以使用的工具数组
disallowedTools	否	明确拒绝的工具名称数组
model	否	要使用的模型：sonnet、opus、haiku 或 inherit
skills	否	预加载的 skill 名称数组
mcpServers	否	MCP servers 数组
maxTurns	否	subagent 停止前的最大代理转数

系统提示标志

标志	行为	模式
--system-prompt	替换整个默认提示	交互 + 打印
--system-prompt-file	替换为文件内容	仅打印
--append-system-prompt	附加到默认提示	交互 + 打印
--append-system-prompt-file	附加文件内容到默认提示	仅打印

何时使用每个：

• --system-prompt：完全控制 Claude 的系统提示

  claude --system-prompt "You are a Python expert who only writes type-annotated code"

• --system-prompt-file：从文件加载自定义提示

  claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"

• --append-system-prompt：添加特定指令同时保持默认功能

  claude --append-system-prompt "Always use TypeScript and include JSDoc comments"

• --append-system-prompt-file：从文件附加指令

  claude -p --append-system-prompt-file ./prompts/style-rules.txt "Review this PR"

输出格式

JSON 格式

claude -p "query" --output-format json

输出包含元数据（包括成本和持续时间）的消息的 JSON 数组。

流式 JSON 格式

claude -p "query" --output-format stream-json

在 Claude 处理请求时实时输出一系列 JSON 对象。

示例

基本查询

claude -p "Explain what this project does"

结构化输出

claude -p "List all API endpoints" --output-format json

管道数据

cat error.log | claude -p "Analyze this error" > analysis.txt

恢复会话

claude --resume auth-refactor "Continue with the tests"

并行 worktree

claude --worktree feature-auth
claude --worktree bugfix-login

---

本文档来自 Claude Code 官方文档