跳到正文

Claude Code CLI · 常用命令

v2.1.2202026-07-25ProprietaryGitHub
适用场景
快速查启动参数、slash 命令、自动化脚本写法
面向读者
已装好 Claude Code,想熟悉日常用法的开发者
TL;DR
claude 启动 → /help 查当前命令 → --continue 接上次 → 保留默认权限确认

启动方式

命令
效果
claude
进入交互式对话(最常用)
claude "帮我写一个 README"
带初始 prompt 启动,直接进入对话
claude --print "帮我写一个 README"
非交互模式,结果输出到 stdout,适合脚本
claude --continue
继续上一次对话(加载最近的会话历史)
claude --resume <session-id>
继续指定会话

继续上次对话

# 接着上次中断的对话继续工作
claude --continue
 
# 查看所有后台会话,找到 session-id
claude agents
 
# 继续指定会话
claude --resume abc123

权限控制

Claude Code 会根据权限设置决定哪些工具需要确认。对不熟悉的仓库、外部提示或 CI 输入,保留默认确认和最小权限最安全。

--dangerously-skip-permissions

claude --dangerously-skip-permissions

该参数会关闭工具确认,可能允许模型直接删除文件、执行外部命令或访问超出预期的资源。它不应作为日常推荐,也不应仅为减少提示而启用。

细粒度权限规则(推荐替代方案)

如果只想跳过特定工具的确认,在 ~/.claude/settings.json 里用 permissions.allow 白名单更安全:

{
  "permissions": {
    "allow": ["Bash(git status)", "Read(src/**)", "Write(src/**)"],
    "deny": ["Read(.env)", "Read(.env.*)", "Bash(git push --force:*)"]
  }
}

常用启动参数

命令
说明
--continue
继续上一次会话
--resume <id>
继续指定会话
--print
非交互模式,结果输出 stdout
--output-format json
输出 JSON(含 token 用量,适合脚本解析)
--model <model-id>
指定当前账户或网关实际可用的模型 ID
--dangerously-skip-permissions
高风险:关闭所有工具确认,仅限外部已隔离环境
--safe-mode
禁用所有自定义(CLAUDE.md、Hooks、MCP、Settings),用于排障
--bare
最小系统提示与工具集;不加载常规自定义和凭据存储
--verbose
详细日志
--debug
调试模式,输出更多内部信息
--add-dir <path>
把额外目录加入上下文
--mcp-config <path>
指定 MCP 配置文件
--system-prompt <text>
自定义系统提示词(替换默认)
--append-system-prompt <text>
追加到系统提示词末尾
--allowedTools <tools>
逗号分隔,只允许指定工具

会话内 Slash 命令

进入交互界面后,以 / 开头输入以下命令:

Slash 命令
说明
/help
查看所有可用命令
/clear
清空当前对话,重新开始
/compact
压缩历史对话,节省 Token
/status
查看当前会话状态(Token 用量、模型)
/cost
显示本次会话 Token 费用
/config
查看或修改当前版本公开的配置项;先用 /help 核对
/memory
查看或编辑 CLAUDE.md 记忆文件
/mcp
查看 MCP 服务器状态
/ide
管理 IDE 集成连接(VS Code / JetBrains 等)
/review
审查当前改动
/init
在当前目录生成 CLAUDE.md 上下文文件

非交互模式(脚本场景)

# 一次性执行,结果输出到终端
claude --print "用中文总结一下这个 PR 的改动" 
 
# 输出 JSON(包含 token 用量)
claude --print --output-format json "列出 src/ 下所有函数名" 
 
# CI 中也应保留最小权限,并在隔离环境中运行
claude --print --output-format json \
  "检查 src/api.ts 里有没有 SQL 注入风险,输出报告"
 
# 把结果传给其他命令
claude --print "生成 .gitignore for Node.js 项目" > .gitignore.generated

先检查生成文件,再决定是否合并到现有 .gitignore,避免直接覆盖用户内容。


指定模型

# 启动时指定
claude --model sonnet
 
# 或在 settings.json 里固定
# "model": "sonnet"

常用模型 ID:

模型
特点
sonnet
使用当前 Sonnet 别名;具体解析结果以官方 /model 为准
opus
使用当前 Opus 别名;适合复杂任务
haiku
使用当前 Haiku 别名;适合轻量任务

子代理 / 后台任务(v2.x)

# 查看所有正在运行的后台会话
claude agents
 
# 检查鉴权状态
claude auth status
claude auth status --text   # 人可读格式
 

认证命令和 Token 保存方式会影响账户安全;以当前 claude auth --help 和 Anthropic 官方文档为准,不在脚本或仓库中保存真实 Token。


版本与更新

# 查看版本
claude --version
 
# 更新到最新版(原生安装方式)
claude update

如需关闭后台自动更新,按官方文档在 settings.jsonenv 段设置 "DISABLE_AUTOUPDATER": "1";手动 claude update 仍然可用。

相关

资料来源:Claude Code 官方文档 · Claude Code 官方 GitHub(2026-07-26 核对)