Claude Code CLI · 常用命令
v2.1.220GitHub
适用场景
快速查启动参数、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.json 的 env 段设置 "DISABLE_AUTOUPDATER": "1";手动 claude update 仍然可用。
资料来源:Claude Code 官方文档 · Claude Code 官方 GitHub(2026-07-26 核对)