Claude code常用命令 - 兰皋-我的笔记

基于官方文档及 2026 年最新版本整理
官方文档：https://code.claude.com/docs/en/cli-reference

CLI 启动标志

在终端启动 claude 时使用

# ── 会话启动 ──────────────────────────────────────────────
claude                                      # 交互模式
claude "重构 auth 模块"                      # 带初始 prompt 启动
claude -p "总结这个文件" < README.md         # 非交互（print）模式，输出后退出

# ── 会话恢复 ──────────────────────────────────────────────
claude -c                                   # 继续当前目录的最近一次会话
claude -r "auth-refactor"                   # 按名称恢复指定会话
claude -r <session-id>                      # 按 session ID 恢复
claude -n "feature-payments"                # 新建并命名会话
claude --from-pr 42                         # 恢复与 GitHub PR #42 关联的会话
claude -c --fork-session                    # Fork 当前会话（新 ID，保留上下文）

# ── 模型选择 ──────────────────────────────────────────────
claude --model opus                         # Opus（复杂推理，最强）
claude --model sonnet                       # Sonnet（通用，默认）
claude --model haiku                        # Haiku（快速探索，最省）

# ── 权限控制 ──────────────────────────────────────────────
claude --permission-mode acceptEdits        # 自动接受所有文件编辑
claude --permission-mode auto               # Auto 模式，AI 自行决定权限
claude --dangerously-skip-permissions       # 跳过所有权限确认（仅受信容器内使用）

# ── 系统提示词 ────────────────────────────────────────────
claude --system-prompt "你是一名 Java 专家"  # 替换系统提示（慎用，会丢失内置能力）
claude --system-prompt-file ./prompt.md     # 从文件加载（与上互斥）
claude --append-system-prompt "始终用中文回答" # 追加到系统提示（推荐）

# ── 工作区隔离 ────────────────────────────────────────────
claude -w feature-auth                      # 在隔离 git worktree 中启动（-w 同 --worktree）
claude -w feature-auth --tmux               # worktree + tmux 多面板

# ── 输出与预算控制 ────────────────────────────────────────
claude -p "fix failing tests" --output-format json   # 输出 JSON（适合 CI/CD）
claude -p "fix failing tests" --max-budget-usd 2.00  # 限制最大花费
claude -p "review this file" --max-turns 3           # 限制 agent 最大轮次

# ── Agent ─────────────────────────────────────────────────
claude --agent code-reviewer                         # 使用指定 agent
claude --agents '{"qa":{"description":"QA","prompt":"You are a QA engineer"}}'

# ── 调试与特殊模式 ────────────────────────────────────────
claude --debug                              # 输出完整 debug 信息
claude --debug "api,hooks"                  # 过滤指定类别的 debug
claude --debug-file /tmp/claude-debug.log   # 写入 debug 日志文件
claude --bare                               # 裸模式：跳过 hooks/LSP/plugin（适合脚本）
claude --effort low|medium|high             # 设置推理努力程度

# ── MCP 管理 ──────────────────────────────────────────────
claude mcp add --transport http github https://mcp.github.com
claude mcp serve                            # 将 Claude Code 本身暴露为 MCP server
claude --debug "mcp"                        # MCP 调试

# ── 其他 ──────────────────────────────────────────────────
claude --version                            # 查看当前版本
claude --help                               # 查看所有 CLI 标志

Slash 命令

在交互会话中输入，以 / 开头；输入 / 可弹出补全列表

会话管理

命令	说明
`/help`	列出所有可用 slash 命令（含自定义）
`/exit`	结束会话（同 `Ctrl+D`）
`/clear`	清空上下文，切换任务时使用
`/compact [保留内容]`	压缩上下文（建议 context > 80% 时执行）
`/resume`	恢复上一个会话
`/rewind`	撤回操作（支持仅撤回代码 / 仅撤回对话）

模型与性能

命令	说明
`/model opus\\|sonnet\\|haiku`	会话中切换模型
`/fast`	开关 Fast Mode（Opus 高速模式，成本更高）
`/effort low\\|medium\\|high`	设置推理努力程度
`/plan`	进入 Plan Mode，先规划再执行（复杂任务推荐）

工作流

命令	说明
`/simplify`	PR 前 3-agent 代码质量审查（架构/重复/性能）
`/batch`	批量并行处理（跨多个 worktree 自动建 PR）
`/tasks` / `/bashes`	查看后台任务列表
`/kill <task-id>`	终止指定后台任务
`/permissions`	查看 / 修改当前权限配置

分析与洞察

命令	说明
`/cost`	查看当前会话 token 消耗及费用
`/status`	查看会话状态（模型、上下文用量等）
`/insights`	生成过去一个月使用报告（HTML 格式）

键盘快捷键

在交互模式下生效

快捷键	说明
`Ctrl+C`	中断当前响应，保留会话
`Ctrl+D`	结束整个会话
`Ctrl+T`	切换任务列表显示
`Esc + Esc`	打开 Rewind 菜单（选择撤回代码 / 撤回对话）
`Shift+Tab`	循环切换模式：普通 → 自动接受编辑 → Plan Mode
`Option+T` / `Alt+T`	开关 Extended Thinking（扩展推理）
`Option+P` / `Alt+P`	快速切换模型（Sonnet / Opus / Haiku）
`/`	输入时弹出 slash 命令列表并实时过滤

Shell 命令直通

在会话内直接执行 shell 命令，绕过 Claude 对话层，节省 token

# 前缀 ! 立即执行
! ls -la
! git status
! git log --oneline -10
! mvn test
! ./gradlew build

# 前缀 & 后台运行
& npm run dev
& ./gradlew bootRun
& pytest --watch

配置文件

文件路径	作用范围
`~/.claude/CLAUDE.md`	全局系统提示，所有项目生效
`.claude/CLAUDE.md`	项目级系统提示
`~/.claude/settings.json`	全局配置（模型、权限、环境变量等）
`.claude/settings.json`	项目级配置
`.claude/skills/`	自定义 Skills（推荐方式）
`.claude/commands/`	旧版自定义命令（仍兼容）

settings.json 示例

{
  "model": "claude-sonnet-4-6",
  "fastMode": false,
  "env": {
    "CLAUDE_CODE_EFFORT_LEVEL": "medium"
  }
}

自定义 Skill

保存到 .claude/skills/<name>/SKILL.md，通过 /<name> 调用

---
name: review
description: 对当前代码进行安全与性能审查
model: opus
---
你是一名高级 Java 工程师，请对以下代码进行 Code Review，
重点关注：
1. 安全漏洞（SQL 注入、XSS、敏感信息泄露）
2. 性能瓶颈（N+1 查询、不必要的锁、内存泄漏）
3. 异常处理是否完善
4. 代码可读性与命名规范

---
name: deep-research
description: 深度研究一个主题
context: fork
agent: Explore
---
Research $ARGUMENTS thoroughly:
1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references

常用场景速查

# 启动并指定模型 + 自动接受编辑
claude --model opus --permission-mode acceptEdits

# 非交互批处理（CI/CD 中使用）
claude -p "检查所有 TODO 注释并生成报告" > report.md

# 并行任务隔离（开新 worktree）
claude --worktree feature-payment

# 会话内后台跑测试，同时继续开发
& mvn test -pl core

💡 使用建议

复杂任务：先 /plan，再执行

上下文满时：/compact 压缩而非 /clear 重置

并行任务：--worktree 隔离，避免代码冲突

长期项目：在 .claude/CLAUDE.md 中维护项目背景和规范

本站文章除注明转载/出处外，均为本站原创或翻译，转载前请务必署名,转载请标明出处
最后编辑时间为: 2026/04/02 10:17