CLI 命令大全

CLI 命令大全

claude 不只是个交互 REPL，它背后站着一整套子命令：管理会话、更新版本、配置认证、操控后台 agent、连接 MCP、跑插件、做深度审查。这一页把官方 cli-reference 里的命令全部摊开，按用途分桶，每条配示例。

会话控制

最常用的一组，决定「这次怎么开」。

命令	作用	示例
claude	启动交互会话	claude
claude "query"	带初始提问启动	claude "解释这个项目的架构"
claude -p "query"	Headless 一次性查询，跑完就退	claude -p "这个函数做什么"
cat file | claude -p	从 stdin 喂内容	cat error.log | claude -p "分析这个报错"
claude -c	继续最近一次会话	claude -c
claude -r <session-id>	按 ID 恢复会话	claude -r 3b1f9a2c
claude -r <name>	按名字恢复会话	claude -r feature-refactor
claude --name <name>	给当前会话起名，方便后续 -r	claude --name feature-refactor

# 典型场景：起一个带名字的会话，方便后续接续
claude --name feature-refactor "帮我重构 src/auth 模块"

# 几天后接着干
claude -r feature-refactor

更新与安装

命令	作用
claude update	把 Claude Code 更新到最新版
claude install [version]	安装指定版本，便于回滚或锁版本

# 升级到最新
claude update

# 锁定到某个版本（比如团队暂时统一版本）
claude install 1.0.30

认证

命令	作用
claude auth login	登录，默认用浏览器 OAuth
claude auth login --console	用 Console API key 登录（适合 headless 环境）
claude auth logout	登出当前账号
claude auth status	查看当前登录状态、账号、配额
claude setup-token	配置 token，常用于 CI 环境

# CI 环境用 Console key 登录
claude auth login --console

# 查看当前账号
claude auth status

后台会话（Agents）

Claude Code 可以同时在后台跑多个会话，称为 agents（不要和 Subagents 子代理混淆，这是不同概念）。这组命令管理它们的生命周期。

命令	作用
claude agents	列出所有后台会话
claude attach <id>	接入某个后台会话，把它拉回前台
claude logs <id>	查看某会话的输出日志
claude respawn <id>	重启某个会话（保留配置）
claude rm <id>	删除某个会话记录
claude stop <id>	停止某个正在跑的会话

# 起一个后台会话
claude --bg "跑全量测试并报告失败项"

# 查看所有后台会话
claude agents

# 接进去看进度
claude attach abc123

工具配置

命令	作用
claude mcp	MCP（Model Context Protocol）服务器管理：add / remove / list
claude plugin	插件管理：安装、列出、卸载来自 marketplace 的插件

# 添加一个 HTTP 类型的 MCP 服务器
claude mcp add --transport http github https://api.github.com/mcp \
  --header "Authorization: Bearer YOUR-TOKEN"

# 查看所有已配置的 MCP
claude mcp list

# 安装一个插件
claude plugin install some-plugin

高级命令

这组命令面向更深的工作流：深度审查、远程控制、自动模式调参。

命令	作用
claude ultrareview [target]	深度代码审查，比 /review 更彻底，常用于发版前
claude remote-control	启动远程控制模式，允许从外部触发会话动作
claude auto-mode defaults	查看/配置 Auto Mode 的默认行为（分类器阈值等）

# 对某个分支做深度审查
claude ultrareview src/auth/

# 配置 Auto Mode 的默认参数
claude auto-mode defaults

其他常用

命令	作用
claude project purge	清除当前项目的 Claude Code 缓存与历史
claude --version / -v	查看版本号
claude --help / -h	查看帮助

一张图理清

把上面所有命令按「日常使用频率」排个序，大概是这样的金字塔：

1. 每天都敲：claude、claude -c、claude -p
2. 每周几次：claude auth status、claude update、claude mcp
3. 偶尔用：claude -r、claude agents、claude plugin
4. 特殊场景：claude ultrareview、claude remote-control、claude auto-mode defaults

心法：把第一层练到不用想，第二层混个脸熟，第三四层知道有这东西就行——用到时再来查这一页。

一句话总结

命令是 Claude Code 的方向盘。claude 是点火，-c/-r 是挂挡，agents 是多任务挂车，mcp/plugin 是加装配件，ultrareview 是上线前的最后一次点检。

下一步去 CLI Flags 速查 看每个命令可以挂哪些参数。🎛️