速查手册

版本 3.41.0 · 最后更新：2026 年 5 月 · 来源：claude-code-ultimate-guide

核心命令

命令	功能
`/help`	上下文帮助
`/powerup`	交互动画课程，教授 Claude Code 功能
`/clear`	重置对话
`/compact`	释放上下文空间
`/status`	会话状态 + 上下文用量
`/context`	详细 Token（词元）分解
`/plan`	进入计划模式（不执行变更）
`/ultraplan`	云端计划模式——在云端草拟、在浏览器中审阅（v2.1.91+）
`/execute`	退出计划模式（应用变更）
`/model`	切换模型（sonnet/opus/opusplan）
`/insights`	用量分析 + 优化报告
`/simplify`	检测已改动代码中的过度工程化并自动修复
`/batch`	通过 5–30 个并行工作树智能体执行大规模重构
`/teleport`	从 Web 端传送会话
`/tasks`	监控后台任务
`/remote-env`	配置云端环境
`/remote-control`	启动远程控制会话（研究预览版，Pro/Max）
`/rc`	`/remote-control` 的别名
`/mobile`	获取 Claude 手机 App 下载链接
`/fast`	切换快速模式（速度 2.5 倍，费用 6 倍）
`/voice`	切换语音输入（按住 Space 说话，松开发送）
`/recap`	休息回来后的会话上下文摘要（v2.1.108）
`/effort [级别]`	思考力度：low/medium/high/xhigh/max；无参数 = 交互滑块（v2.1.111）
`/tui [fullscreen]`	全屏无闪烁 TUI 渲染（v2.1.110）
`/focus`	切换极简专注视图，独立于 Ctrl+O（v2.1.110）
`/less-permission-prompts`	扫描记录并提议只读工具白名单（v2.1.111）
`/btw [问题]`	侧边问题浮层——只读临时智能体，不污染历史记录，无工具
`/loop [间隔] [提示]`	循环执行提示词（例：`/loop 5m check the deploy`，默认 10m）
`/stats`	用量图表、常用模型、连续使用天数（v2.1.118 起为 /usage 的别名）
`/usage`	按模型统计 Token（词元）+ 费用用量（v2.1.118）
`/ultrareview`	多智能体云端代码审查（v2.1.114）
`/goal [条件]`	自主多轮模式：Claude 持续工作直至达到条件，实时浮层显示耗时/轮次/Token（词元）（v2.1.139）
`/scroll-speed`	通过交互滑块（实时预览）调节鼠标滚轮速度（v2.1.139）
`/rename [名称]`	命名或重命名当前会话
`/copy`	交互式选取器，复制代码块或完整回复
`/debug`	系统化故障排查
`/exit`	退出（或 Ctrl+D）

键盘快捷键

快捷键	功能
`Shift+Tab`	循环切换权限模式
`Esc` × 2	撤回（Rewind/undo）
`Ctrl+C`	中断
`Ctrl+R`	搜索命令历史
`Ctrl+L`	清屏（保留上下文）
`Tab`	自动补全
`Shift+Enter`	换行
`Ctrl+B`	后台任务
`Ctrl+F`	终止所有后台智能体（双击）
`Alt+T`	切换深度思考
`Space`（按住）	语音输入（需先启用 `/voice`）
`Ctrl+D`	退出

文件引用

Plain

@path/to/file.ts    → 引用文件
@agent-name         → 调用智能体
!shell-command      → 运行 shell 命令

IDE	快捷键
VS Code	`Alt+K`
JetBrains	`Cmd+Option+K`

鲜为人知的功能（但都是官方！）

功能	引入版本	说明
Tasks API	v2.1.16	带依赖关系的持久化任务列表
后台智能体	v2.0.60	子智能体在你编码时后台工作
智能体团队	v2.1.32	多智能体协调（TeamCreate/SendMessage）
自动记忆	v2.1.32	跨会话自动捕获上下文
会话分叉	v2.1.19	撤回并创建并行时间线
LSP 工具	v2.0.74	IDE 级导航：符号、类型、引用。响应约 50ms（grep 需 45s），支持 11 种语言
语音模式	v2.1.x	原生语音输入，免费转录，不占 API 速率限制
远程控制	v2.1.51	从手机/浏览器控制本地会话（研究预览版，Pro/Max）
/loop	v2.1.71	会话级循环调度器：`/loop 5m check the deploy`（会话结束时停止）。最短 1 分钟，最多 50 个任务/会话
/goal	v2.1.139	自主完成循环：设定条件，Claude 跨轮次工作直至单独评估器（Haiku）验证达成。实时浮层显示耗时、轮次和 Token（词元）。三要素公式：可量化终态 + 验证机制 + 约束条件。
云端定时任务	2026	关机后调度，通过 `/schedule` 或 `claude.ai/code/scheduled` 配置。在 Anthropic 基础设施上运行，每次重新克隆仓库，最短间隔 1 小时。Pro/Max/Team/Enterprise
桌面定时任务	2026	本地机器调度，通过桌面 App 配置。最短 1 分钟，完整本地文件访问，无需会话
技能评估	2026 年 3 月	两种技能类型：能力补全（填补模型差距，会随模型升级淡出）/ 偏好编码（编码工作流，长期保留）。基准测试模式、A/B 测试、触发调优。
输出风格	v2.1.108	`/config` → "首选输出风格"：默认（简洁）、解释型（附设计理由）、学习型（结对编程，带 `TODO(human)` 标记）。通过 `.claude/styles/` 自定义风格。

启用 LSP 工具：添加到 ~/.claude/settings.json → { "env": { "ENABLE_LSP_TOOL": "1" } }（需为对应语言安装 LSP 服务器：tsserver、pylsp、gopls、rust-analyzer、sourcekit-lsp...）

小贴士：这些都不是"秘密"——都在 Claude Code CHANGELOG 里。去读吧！

权限模式

模式	编辑	执行
默认（Default）	询问	询问
acceptEdits	自动	询问
计划模式（Plan Mode）	❌	❌
auto	分类器决定	分类器决定
dontAsk	仅限允许规则内	仅限允许规则内
绕过权限模式（bypassPermissions）	自动	自动（仅限 CI/CD）

Shift+Tab 切换模式

记忆与设置（2 个层级）

层级	macOS/Linux	Windows	范围	Git
项目级	`.claude/`	`.claude`	团队	✅
个人级	`~/.claude/`	`%USERPROFILE%.claude`	你（所有项目）	❌

优先级：项目级覆盖个人级

文件	位置	用途
`CLAUDE.md`	项目根目录	团队记忆（指令）
`settings.json`	`.claude/`	团队设置（Hooks）
`settings.local.json`	`.claude/`	个人设置覆盖
`CLAUDE.md`	`~/.claude/`（Win：`%USERPROFILE%.claude`）	个人记忆

.claude/ 文件夹结构

Plain

.claude/
├── CLAUDE.md           # 本地记忆（gitignored）
├── settings.json       # Hooks（已提交）
├── settings.local.json # 权限（未提交）
├── agents/             # 自定义智能体
├── hooks/              # 事件脚本
├── rules/              # 自动加载规则
└── skills/             # 斜杠命令 + 知识模块（统一）

典型工作流

Plain

1. 启动会话      → claude
2. 检查上下文    → /status
3. 计划模式      → Shift+Tab × 2（复杂任务）
4. 描述任务      → 清晰、具体的提示词
5. 审阅变更      → 务必读 diff！
6. 接受/拒绝     → y/n
7. 验证          → 跑测试
8. 提交          → 任务完成后
9. /compact      → 上下文 >70% 时

上下文管理（关键）

状态栏

Plain

Model: Sonnet | Ctx: 89.5k | Cost: $2.11 | Ctx(u): 56.0%

盯住 Ctx(u): → >70% 用 /compact，>85% 用 /clear

增强状态栏（ccstatusline）： 添加到 ~/.claude/settings.json：

JSON

{ "statusLine": { "type": "command", "command": "npx -y ccstatusline@latest", "padding": 0 } }

上下文阈值

上下文占比	状态	操作
0-50%	绿色	自由工作
50-70%	黄色	有选择地使用
70-90%	橙色	立即 `/compact`
90%+	红色	必须 `/clear`

按症状处理

征兆	操作
回复变短	`/compact`
频繁遗忘	`/clear`
上下文 >70%	`/compact`
任务完成	`/clear`

上下文恢复命令

命令	用途
`/compact`	摘要并释放上下文
`/clear`	全新开始
`/rewind`	撤销最近变更
`claude -c`	恢复上次会话（CLI 标志）
`claude -r <id>`	恢复指定会话（CLI 标志）

底层机制（速览）

概念	要点
主循环（Master Loop）	简单的 `while(tool_call)` — 无 DAG，无分类器
工具集	8 个核心工具：Bash、Read、Edit、Write、Grep、Glob、Task、TodoWrite
上下文	约 200K Token（词元），在 75-92% 时自动压缩
子智能体	独立上下文，最大深度=1
设计哲学	"减少脚手架，信任模型"——相信 Claude 的推理能力

深入了解：「架构与内部机制」

计划模式与深度思考

功能	启用方式	用途
计划模式	`Shift+Tab × 2` 或 `/plan`	探索而不修改
OpusPlan	`/model opusplan`	Opus 规划，Sonnet 执行
Ultraplan	`/ultraplan <提示>`	云端规划，浏览器审阅，终端保持空闲（v2.1.91+，需要 GitHub）

Opus 4.7（v2.1.114+）：Claude Code 中默认思考力度 = xhigh（所有计划）。新增 xhigh 级别介于 high 与 max 之间——更精细的推理/延迟控制。使用 ultrathink 强制下一轮使用最大力度。

控制方式	操作	持久性
Alt+T	切换深度思考开/关	会话级
/config	全局启用/禁用	永久
/model 滑块	左/右方向键：`low	medium
CLAUDE_CODE_EFFORT_LEVEL	环境变量：`low	medium
effortLevel 设置	在 settings.json 中：`low	medium
技能前置元数据中的 effort（v2.1.80+）	每个技能单独覆盖：`low	medium

成本技巧：简单任务用 Alt+T 关闭深度思考 → 更快更省钱。

按技能设置思考力度 — 机械性技能（commit、sync、scaffold）设 effort: low，分析性技能（security-audit、architecture-review）设 effort: high。自动覆盖会话设置。

OpusPlan 工作流：/model opusplan → Shift+Tab × 2（Opus 规划）→ Shift+Tab（Sonnet 执行）

Ultraplan 工作流：/ultraplan <任务> → 终端空闲，云端草拟 → 在浏览器中审阅 → 批准 → 在 Web 端执行（PR）或传送回终端

适用场景：超过 3 个文件的功能、架构设计、复杂调试

快速模型选择

任务	模型	思考力度
重命名、样板代码、测试生成	Haiku	low
功能开发、调试、重构	Sonnet	medium–high
架构设计、安全审计	Opus	high–max

含成本估算的完整决策表：详见「模型选择与深度思考指南」

动态模型切换（会话中途）

模式：从 Sonnet（速度）开始 → 切 Opus（复杂度）→ 切回 Sonnet

工作流：

Bash

# 会话开始（默认 Sonnet）
claude

# 遇到复杂功能
> "Implement OAuth2 flow with PKCE"
/model opus                    # 切换到深度推理

# 功能完成，回到日常
/model sonnet                  # 速度 + 成本优化

最佳实践：

✅ 在任务边界切换，不要在任务中途切
✅ 用 Opus 的场景：架构决策、复杂调试、安全关键代码
✅ 用 Sonnet 的场景：日常编辑、重构、写测试
✅ 用 Haiku 的场景：简单修复、错别字、验证检查
❌ 不要在实现中途切换（会有上下文损失）

费用影响：

模型	输入	输出	适用场景
Opus 4.7	$5/MTok	$25/MTok	复杂推理（10-20% 的任务）
Sonnet 4.6	$3/MTok	$15/MTok	大多数开发（70-80% 的任务）
Haiku 4.5	$0.80/MTok	$4/MTok	简单验证（5-10% 的任务）

动态切换在保证复杂任务质量的同时优化成本。

来源：Gur Sannikov（嵌入式工程工作流）

MCP 服务器

服务器	用途
Serena	代码索引 + 会话记忆 + 符号搜索
grepai	语义搜索 + 调用图分析
Context7	库文档
Sequential	结构化推理
Playwright	浏览器自动化
Postgres	数据库查询
doobidoo	语义记忆 + 多客户端 + 知识图谱

Serena 记忆操作：write_memory() / read_memory() / list_memories()

Serena 索引：

Bash

# 初始索引
uvx --from git+https://github.com/oraios/serena serena project index

# 强制重建
serena project index --force-full

# 增量更新（更快）
serena project index --incremental --parallel 4

查看状态：/mcp

创建自定义组件

智能体（`.claude/agents/my-agent.md`）

YAML

---
name: my-agent
description: Use when [trigger]
model: sonnet
tools: Read, Write, Edit, Bash
---
# Instructions here

Skills（技能模块）—— 用户可调用（`.claude/skills/my-command/SKILL.md`）

Markdown

---
description: Brief description
argument-hint: "<required_arg> [--flag]"
disable-model-invocation: true
---
# Command Name
Instructions for what to do...
$ARGUMENTS[0] $ARGUMENTS[1] (or $0 $1) - user args

Hooks（钩子）（macOS/Linux：`.sh` | Windows：`.ps1`）

Bash（macOS/Linux）：

Bash

#!/bin/bash
INPUT=$(cat)
# Process JSON input
exit 0  # 0=continue, 2=block

PowerShell（Windows）：

PowerShell

$input = [Console]::In.ReadToEnd() | ConvertFrom-Json
# Process JSON input
exit 0  # 0=continue, 2=block

反模式

❌ 不要这样做	✅ 应该这样做
模糊提示	用 @引用指定文件 + 行号
不读就接受	每次都读差异对比（diff）
忽略警告	上下文 70% 时用 `/compact`
跳过权限	生产环境绝不跳过
只给负向约束	同时提供备选方案

快速提示词公式

Plain

WHAT：[具体交付物]
WHERE：[文件路径]
HOW：[约束条件、实现方式]
VERIFY：[成功标准]

示例：

Plain

Add input validation to the login form.
WHERE: src/components/LoginForm.tsx
HOW: Use Zod schema, show inline errors
VERIFY: Empty email shows error, invalid format shows error

CLI 标志快速参考

标志	用途
`-p "query"`	非交互模式（CI/CD）
`-c` / `--continue`	继续上次会话
`-r` / `--resume <id>`	恢复指定会话
`--teleport`	从 Web 端传送会话
`remote-control`	子命令：启动远程控制会话
`--model sonnet`	更改模型
`--add-dir ../lib`	允许访问当前工作目录以外的目录
`--permission-mode plan`	计划模式
`--tools "Tool1,Tool2"`	为本次会话启用指定工具
`--max-budget-usd 5.00`	最大 API 费用限额（打印模式）
`--system-prompt "..."`	追加自定义系统提示词
`--worktree` / `-w`	在隔离的 Git 工作树中运行
`--dangerously-skip-permissions`	自动接受（谨慎使用）
`--debug`	调试输出
`--allowedTools "Edit,Read"`	工具白名单

完整 CLI 参考（约 45 个标志）：见 code.claude.com 上的 cli-reference

关键 CLI 子命令

命令	说明
`claude project purge [path]`	删除项目的所有 Claude Code 状态（记录、任务、配置）。`--dry-run` 预览。（v2.1.126）
`claude ultrareview [target]`	非交互式云端代码审查，用于 CI。`--json` 输出。退出码 0/1。（v2.1.120）
`claude plugin prune`	删除孤立的自动安装插件依赖。（v2.1.121）
`claude plugin details <name>`	显示插件清单和 Token（词元）成本估算。（v2.1.139）
`claude --plugin-url <url>`	从 URL 加载插件 `.zip` 用于本次会话。（v2.1.129）

调试命令

Bash

claude --version     # 版本
claude update        # 检查/安装更新
claude doctor        # 诊断
claude --debug       # 详细模式
claude --mcp-debug   # 调试 MCP
/mcp                 # MCP 状态（在 Claude 内部）

CI/CD 模式（无头模式）

Bash

# 非交互式执行
claude -p "analyze this file" src/api.ts

# JSON 输出
claude -p "review" --output-format json

# 经济模型
claude -p "lint" --model haiku

# 自动接受
claude -p "fix typos" --dangerously-skip-permissions

远程控制 — 移动端访问（v2.1.51+，研究预览版）

仅限 Pro/Max — Team、Enterprise 和 API Key 不可用

Bash

# 从终端启动（新会话）
claude remote-control

# 或在活跃会话中：
/rc        # （或 /remote-control）

从手机/平板/浏览器连接：

扫描 二维码（启动后按空格键显示）
或在浏览器 / Claude 手机 App 中打开会话 URL
或：/mobile → 显示 App Store + Play Store 链接

⚠️ 已知限制	详情
同一时间仅 1 个会话	只能有一个远程会话处于活跃状态
斜杠命令异常	`/new`、`/compact` 在远程端以纯文本显示 → 请从本地终端使用
终端必须保持开启	关闭本地终端会结束会话
网络超时	约 10 分钟断连 → 会话过期

进阶：tmux 多会话（绕过单会话限制）

Bash

tmux new-session -s dev
# 每个窗格 = 独立的 claude 会话
# 在想要远程控制的窗格中运行 /rc

自动启用： /config → 切换"远程控制：自动启用"

完整文档：详见「§9.22 远程控制」与「安全说明」

任务管理（v2.1.16+）

两套系统可用：

系统	适用场景	持久性
Tasks API（v2.1.16+）	多会话项目、依赖管理	✅ 磁盘（`~/.claude/tasks/`）
TodoWrite（旧版）	简单单会话	❌ 仅限会话内

Tasks API 命令

Bash

# 跨会话启用持久化
export CLAUDE_CODE_TASK_LIST_ID="project-name"
claude

# 在 Claude 内部：创建任务层级
> "Create tasks for auth system with dependencies"

# 稍后恢复（新会话）
export CLAUDE_CODE_TASK_LIST_ID="project-name"
claude
> "TaskList to see current state"

核心能力：

📁 持久化：会话结束、上下文压缩后仍然保留
🔗 依赖关系：任务 A 阻塞任务 B
🔄 多会话：向多个终端广播状态
📊 状态：pending → in_progress → completed/failed

⚠️ 限制：TaskList 仅显示 id、subject、status、blockedBy。查看 description/metadata → 对每个任务使用 TaskGet(taskId)。

小贴士：将关键信息存入 subject 方便快速扫描。

迁移标志（v2.1.19+）：

Bash

# 回退到旧版 TodoWrite 系统
CLAUDE_CODE_ENABLE_TASKS=false claude

→ 完整工作流：详见「任务管理工作流」

黄金法则

永远在接受前审阅差异对比（diff）
上下文快满（>70%）前用 /compact
具体描述请求（WHAT、WHERE、HOW、VERIFY）
复杂/高风险任务先进计划模式
每个项目都创建 CLAUDE.md
每完成一个任务就提交
了解发送了什么 — 提示词、文件、MCP 结果 → Anthropic（可在 claude.ai/settings/data-privacy-controls 退出训练数据使用）

快速决策树

Plain

简单任务       → 直接问 Claude
复杂任务       → 先用 Tasks API 规划
高风险变更     → 先进计划模式
重复性任务     → 创建智能体或命令
上下文已满     → /compact 或 /clear
需要文档       → 使用 Context7 MCP
深度分析       → 使用 Opus（默认开启深度思考）

常见问题快速修复

问题	解决方案
"Command not found"	检查 PATH，重新安装：`curl -fsSL https://claude.ai/install.sh
上下文过高（>70%）	立即 `/compact`
响应慢	`/compact` 或 `/clear`
MCP 不工作	`claude mcp list`，检查配置
权限被拒绝	检查 `settings.local.json`
Hooks 阻塞	检查 hook 退出码，审查逻辑

健康检查脚本（保存后运行）：

Bash

# macOS/Linux
which claude && claude doctor && claude mcp list

# Windows PowerShell
where.exe claude; claude doctor; claude mcp list

成本优化

模型	适用场景	费用
Haiku	简单修复、审查	$
Sonnet	大多数开发
Opus	架构设计、复杂 bug	$
OpusPlan	Opus 规划 + Sonnet 执行	$$

小贴士：使用 --add-dir 允许工具访问当前工作目录以外的目录

社区工具

工具	用途	安装方式
ccusage	费用追踪与报告	`bunx ccusage daily`
RTK	Token（词元）缩减（60-90%）	`brew install rtk-ai/tap/rtk` 或 `cargo install rtk` · 官网
claude-code-viewer	会话历史 UI	`npx @kimuson/claude-code-viewer`
Entire CLI	会话检查点 + 治理	entire.io（2026 年 2 月）

Entire CLI：由前 GitHub CEO 创建的智能体原生平台，具备可回溯检查点、审批关卡、审计跟踪。适用于合规场景（SOC2、HIPAA）或多智能体工作流。

搜索工具快速参考

5 秒决策法：精确文本 → rg | 精确名称 → rg/Serena | 概念 → grepai | 结构 → ast-grep

任务	工具	命令
"查找 TODO 注释"	`rg`	`rg "TODO"`
"查找认证代码"	`grepai`	`grepai search "authentication"`
"谁调用了 login？"	`grepai`	`grepai trace callers "login"`
"获取文件结构"	`Serena`	`serena get_symbols_overview`
"没有 try/catch 的 async"	`ast-grep`	`ast-grep "async function $F"`

速度：rg（约 20ms）→ Serena（约 100ms）→ ast-grep（约 200ms）→ grepai（约 500ms）

完整工作流：详见「搜索工具精通」

资源

官方文档：docs.anthropic.com/claude-code
进阶指南：Claudelog.com - 技巧与模式
完整指南：ultimate-guide.md（本仓库）
白皮书（中英文）：通过 PDF 生成工作流导出（共 10 份专题）
项目记忆：在项目根目录创建 CLAUDE.md
DeepSeek（经济实惠）：通过 ANTHROPIC_BASE_URL 配置

来源：claude-code-ultimate-guide v3.41.0 · Florian BRUNIAUX · 最后更新：2026 年 5 月

来源：飞书 · AI Spark 知识库｜原文（最新版）：https://lcnniolukk80.feishu.cn/wiki/JTcswthzfiKGvgkagT6cYNX9nke ｜归档：2026-06-04

自媒体人 AI 入门路径：从选题到复盘的完整工作流

Claude Code 深度全解

底层原理精讲

可视化图解

零到精通：七步上手路径

企业级安全与治理

生态与工具链全景

实战工作流手册

速查手册 ​

核心命令 ​

键盘快捷键 ​

文件引用 ​

鲜为人知的功能（但都是官方！） ​

权限模式 ​

记忆与设置（2 个层级） ​

.claude/ 文件夹结构 ​

典型工作流 ​

上下文管理（关键） ​

状态栏 ​

上下文阈值 ​

按症状处理 ​

上下文恢复命令 ​

底层机制（速览） ​

计划模式与深度思考 ​

快速模型选择 ​

动态模型切换（会话中途） ​

MCP 服务器 ​

创建自定义组件 ​

智能体（.claude/agents/my-agent.md） ​

Skills（技能模块）—— 用户可调用（.claude/skills/my-command/SKILL.md） ​

Hooks（钩子）（macOS/Linux：.sh | Windows：.ps1） ​

反模式 ​

快速提示词公式 ​

CLI 标志快速参考 ​

关键 CLI 子命令 ​

调试命令 ​

CI/CD 模式（无头模式） ​

远程控制 — 移动端访问（v2.1.51+，研究预览版） ​

任务管理（v2.1.16+） ​

Tasks API 命令 ​

黄金法则 ​

快速决策树 ​

常见问题快速修复 ​

成本优化 ​

社区工具 ​

搜索工具快速参考 ​

资源 ​

速查手册

核心命令

键盘快捷键

文件引用

鲜为人知的功能（但都是官方！）

权限模式

记忆与设置（2 个层级）

.claude/ 文件夹结构

典型工作流

上下文管理（关键）

状态栏

上下文阈值

按症状处理

上下文恢复命令

底层机制（速览）

计划模式与深度思考

快速模型选择

动态模型切换（会话中途）

MCP 服务器

创建自定义组件

智能体（`.claude/agents/my-agent.md`）

Skills（技能模块）—— 用户可调用（`.claude/skills/my-command/SKILL.md`）

Hooks（钩子）（macOS/Linux：`.sh` | Windows：`.ps1`）

反模式

快速提示词公式

CLI 标志快速参考

关键 CLI 子命令

调试命令

CI/CD 模式（无头模式）

远程控制 — 移动端访问（v2.1.51+，研究预览版）

任务管理（v2.1.16+）

Tasks API 命令

黄金法则

快速决策树

常见问题快速修复

成本优化

社区工具

搜索工具快速参考

资源