Claude Code CLI 使用技巧大全

第 0 章 · 三分钟上手

🌱 安装与登录

# 安装（原生构建，推荐）
curl -fsSL https://claude.ai/install.sh | bash
# 或 npm
npm install -g @anthropic-ai/claude-code

claude auth login      # 登录
claude auth status     # 查看登录状态
claude --version       # 确认版本
claude doctor          # 安装体检

🌱 第一次运行

cd ~/my-project
claude                 # 进入交互会话

进去先做这三件事：

/init                  # 让 Claude 扫描仓库，生成 CLAUDE.md 项目说明
/status                # 看当前模型、账号、目录
/help                  # 看本版本支持的全部命令和快捷键（以此为准）

🌱 必须建立的五个心智模型

概念	一句话理解
上下文（Context）	Claude 的"工作记忆"，有上限。塞满了就会压缩或遗忘
权限模式	决定 Claude 动手前问不问你。`Shift+Tab` 切换
CLAUDE.md	项目说明书，每次会话自动加载，写规范和约定
会话（Session）	一次对话。可以 `claude -c` 续、`claude -r` 挑、`/clear` 清
技能 / MCP / 插件	扩展能力的三种方式，都要占 token，按需开

🌱 最小可用工作流

1. cd 到项目 → claude
2. Shift+Tab 切到 plan 模式
3. 描述需求："给用户模块加上邮箱验证，先给我方案"
4. 看方案 → 满意就批准，不满意就补充要求
5. Claude 动手改代码
6. 说"跑一下测试"验证
7. 说"提交这些改动"（Claude 只在你要求时才提交）
8. 任务完成 → /clear 开始下一个任务

🌱 新手最常犯的三个错

一个会话干十件事 —— 上下文糊成一团。一个任务一个会话，做完 /clear

从不用计划模式 —— 大改动直接开干，方向错了全废

不写 CLAUDE.md —— 每次都要重复解释项目约定

第 1 章 · 输入框语法与快捷键

🔥 五个前缀符号

输入	作用	示例
`#`	存入记忆，会弹窗问存到项目还是全局	`# 这个项目用 pnpm 不用 npm`
`!`	Bash 模式，直接执行，输出进上下文	`!git log --oneline -10`
`@`	引用文件/目录，按 Tab 补全	`@src/auth.ts 这里有什么问题`
`/`	斜杠命令或技能	`/context`
`>`	（部分版本）快速任务	—

@ 的进阶用法：

@src/ 引用整个目录
@ 后按 Tab 会模糊匹配，@auth<Tab> 能补出 src/services/auth.service.ts
一条消息可以引用多个文件：对比 @old.ts 和 @new.ts

🔥 快捷键表

✅ 本表已对照官方文档 interactive-mode 逐条核对。

核心操作

键	作用
`Shift+Tab`	循环切换权限模式（最常用的键）。Windows 上 Node/Bun 未启用 VT input 时用 `Alt+M`
`Esc`	中断 Claude 当前回合（已完成的工作会保留）；有弹窗时则关闭弹窗
`Esc Esc`	输入框有内容→清空并存进历史（`↑` 可召回）；输入框为空→打开 rewind 菜单
`Ctrl+C`	中断运行中的操作；空闲时第一次清空输入，第二次退出
`Ctrl+D`	退出会话（需 800ms 内连按两次）。输入框有文字时是删除光标后一个字符
`Ctrl+Z`	挂起进程到 shell（Unix），`fg` 恢复

查看与编辑

键	作用
`Ctrl+O`	🔥 切换 transcript 查看器 —— 看详细工具调用、时间戳、每条消息用的模型
`Ctrl+R`	🔥 反向搜索历史命令（不是看 transcript）。全屏渲染下打开搜索框，`Ctrl+S` 切换搜索范围：本会话／本项目／全部项目
`Ctrl+G` 或 `Ctrl+X Ctrl+E`	用默认编辑器写 prompt
`Ctrl+L`	重绘屏幕。全屏渲染下两秒内连按两次会执行 `/clear`
`Ctrl+T`	显示/隐藏 Claude 的待办清单（不是后台任务视图，那个是 `/tasks`）
`Ctrl+S`	💎 暂存当前输入并清空；空输入时再按一次恢复（含光标位置和粘贴内容）
`Ctrl+V`	粘贴剪贴板图片。iTerm2 用 `Cmd+V`，Windows/WSL 用 `Alt+V`

任务控制

键	作用
`Ctrl+B`	把运行中的 Bash 命令/agent 转入后台。tmux 用户按两次
`Ctrl+X Ctrl+K`	💎 停止本会话所有后台子 agent（3 秒内按两次确认）

模型与模式（macOS 用 Option，Windows/Linux 用 Alt）

键	作用
`Option+P`	💎 切换模型，不清空当前输入
`Option+T`	💎 开关扩展思考（Fable 5 无效，它始终开启）
`Option+O`	💎 开关快速模式

Option+T 在 macOS 上不需要配置 Option as Meta。

换行（官方四种方式）

方式	前提
`\` + `Enter`	所有终端通用
`Ctrl+J`	💎 任何终端零配置可用，比 `\`+Enter 顺手
`Shift+Enter`	原生支持：iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal。VS Code / Cursor / Devin Desktop / Alacritty / Zed 需跑 `/terminal-setup`
`Option+Enter`	macOS 需先开启 Option as Meta（iTerm2：Settings → Profiles → Keys → 左/右 Option 设为 "Esc+"）

readline 行内编辑（与 bash/zsh 一致）

Ctrl+A 行首 · Ctrl+E 行尾 · Ctrl+K 删到行尾 · Ctrl+U 删到行首 · Ctrl+W 删前一个词 · Ctrl+Y 粘回删除的文本 · Ctrl+_ 撤销 · ↑/↓ 或 Ctrl+P/Ctrl+N 移动光标或翻历史

💎 快捷键可自定义：/keybindings 直接打开配置文件，或编辑 ~/.claude/keybindings.json。

⚠️ /vim 已在 v2.1.92 移除。现在通过 /config → Editor mode 切换 Vim 模式。v2.1.208+ 支持 vimInsertModeRemaps 把 jj 映射成 Esc。

🚀 `Esc Esc` 的正确理解

输入框为空时双击 Esc，弹出历史消息列表：

选中某条早期消息 → 该消息之后的对话全部丢弃
⚠️ 只回滚对话上下文，不回滚文件改动
想同时回滚文件，用 /rewind

典型场景：Claude 走偏了三轮，你想回到分岔点重新描述需求 —— 双击 Esc 回到那条消息，重新说一遍。

第 2 章 · 斜杠命令完全手册

✅ 本章已对照官方 commands reference 核对。完整列表见该页，这里挑常用的。

上下文与会话

命令	说明
`/context [all]`	🔥 可视化上下文占用。超出上下文窗口时会警告超了多少。加 `all` 展开明细
`/compact [指令]`	压缩上下文。可带聚焦指令：`/compact 保留架构决策，丢掉调试细节`
`/autocompact [auto\|500k]`	💎 设置自动压缩触发点并存进用户设置（v2.1.221+）
`/clear [名字]`	新开对话。可给旧对话起名，方便在 `/resume` 里找。别名 `/reset` `/new`
`/rewind`	回滚代码和对话到之前某点（= 空输入双击 Esc）
`/resume`	历史会话选择器
`/branch [名字]`	💎 在当前点分叉对话，切进分支试新方向，原对话完好保留
`/fork [prompt]`	💎 把对话复制成后台会话，你继续在这边干（v2.1.212+）
`/subtask <任务>`	💎 派一个继承完整对话的后台子 agent，结果回流到本对话
`/background [prompt]`	把当前会话转为后台 agent，腾出终端。别名 `/bg`
`/tasks`	查看管理本会话的后台工作。别名 `/bashes`
`/diff`	💎 交互式 diff 查看器，左右切换 git diff 和 Claude 每一轮的改动
`/copy [N]`	💎 复制第 N 条最新回复到剪贴板，有代码块时可挑块；按 `w` 写入文件
`/export [文件名]`	导出对话
`/usage`	花费、套餐用量、按技能/子agent/插件/MCP 的用量拆分。别名 `/cost` `/stats`
`/btw [问题]`	💎 问个不进对话的小问题，不污染上下文
`/recap`	生成本会话的一行摘要
`/goal <条件>`	💎 设目标，Claude 跨轮持续工作直到条件满足
`/cd <路径>`	💎 移动会话到新目录，保留 prompt 缓存（v2.1.169+）
`/add-dir <路径>`	加一个可访问目录（不移动会话）

配置

命令	说明
`/config [key=value]`	设置面板。🔥 可直接赋值：`/config theme=dark`、`/config model=sonnet`。`/config --help` 列出全部可设项
`/model`	切模型并存为默认。按 `s` 只对当前会话生效
`/effort [级别]`	🔥 low / medium / high / xhigh / max / ultracode / auto。立即生效，不用等当前回复结束
`/fast [on\|off]`	💎 快速模式（v2.1.205+）
`/advisor [模型]`	💎 开启顾问工具，关键节点咨询第二个模型
`/permissions`	权限规则管理。别名 `/allowed-tools`
`/status`	版本、模型、账号、连通性
`/doctor`	🔥 体检并可自动修复：重复安装、PATH、配置文件语法、闲置技能/MCP/插件的上下文成本、慢 hook、CLAUDE.md 瘦身。别名 `/checkup`
`/theme`	主题，含色盲友好方案和自动跟随终端明暗
`/tui [fullscreen]`	💎 切换渲染器，`fullscreen` 是无闪烁全屏模式
`/focus`	💎 精简视图：只显示你的提问、一行工具摘要、最终回复
`/keybindings`	打开快捷键配置文件
`/terminal-setup`	装 Shift+Enter 绑定（只在需要的终端里可见：VS Code / Cursor / Alacritty / Zed 等）
`/statusline`	状态栏。可以直接描述你想要什么，或无参数从 shell 提示符自动配置
`/color`	💎 设置提示框颜色，多开会话时区分用
`/sandbox`	沙箱模式开关

项目与扩展

命令	说明
`/init`	生成 CLAUDE.md。💎 `CLAUDE_CODE_NEW_INIT=1` 启用交互流程，连技能、hooks、个人记忆一起过一遍
`/memory`	编辑 CLAUDE.md、开关自动记忆、查看自动记忆条目
`/agents`	v2.1.198 起只是提示你直接让 Claude 管理或改 `.claude/agents/`
`/list-agents`	💎 列出可跨会话通信的 agent（v2.1.224+）。别名 `/peers`
`/mcp [reconnect\|enable\|disable]`	MCP 管理。💎 可直接 `/mcp disable all`，不用开面板
`/hooks`	查看 hook 配置
`/plugin [子命令]`	插件管理，可直接 `list` / `install` / `enable`
`/skills`	💎 列出技能，按 `t` 按 token 数排序，空格切换可见性 —— 找上下文杀手的利器
`/reload-skills` `/reload-plugins`	💎 不重启会话就重新加载磁盘上的改动
`/ide`	IDE 集成
`/import [codex\|gemini]`	💎 从 Codex / Gemini CLI 导入配置（v2.1.213+）
`/insights`	💎 分析你的使用记录，输出项目分布、交互模式、卡点报告
`/team-onboarding`	💎 从你 30 天的使用记录生成团队上手指南

内置技能（Bundled Skills）

这些是 prompt 驱动的技能，不是固定逻辑的命令：

命令	说明
`/code-review [级别] [--fix] [--comment]`	🔥 审查当前 diff 或指定 PR/分支/路径。级别 low→max，`ultra` 走云端深度审查。以子 agent 后台运行，不占对话上下文。别名 `/review`
`/security-review`	安全审查当前分支 vs origin 默认分支
`/simplify [目标]`	💎 四个 agent 并行查复用、简化、效率、抽象层级，并直接应用修改
`/verify`	💎 构建并运行你的 app 来确认改动生效，而不是只跑测试
`/run`	启动并驱动你的 app
`/run-skill-generator`	💎 录制项目的启动配方到 `.claude/skills/run-<name>/`，之后所有 agent 都照着做
`/batch <指令>`	🔥 大规模并行改造：拆成 5–30 个独立单元，每个单元一个后台 agent + 独立 worktree，各自跑测试开 PR
`/debug [描述]`	开启调试日志并分析问题
`/loop [间隔] [prompt]`	定时重复执行。`/loop 5m 检查部署好没`。别名 `/proactive`
`/deep-research <问题>`	💎 Workflow：扇出搜索、交叉验证、输出带引用的报告
`/fewer-permission-prompts`	扫描历史，生成权限允许清单
`/dataviz`	图表设计指导，含色盲安全校验
`/doctor`	见上

云端与跨端

命令	说明
`/ultrareview [PR\|分支]`	云端多 agent 深度审查。现在推荐写 `/code-review ultra`
`/autofix-pr [prompt]`	💎 开一个云端会话盯着当前分支的 PR，CI 挂了或有 review 意见就自动推修复
`/schedule [描述]`	💎 创建云端定时任务（routines）。别名 `/routines`
`/teleport`	💎 把云端会话拉回本地终端。别名 `/tp`
`/remote-control`	让本会话可被 claude.ai 远程控制。别名 `/rc`
`/desktop`	转到桌面 App 继续。别名 `/app`
`/workflows`	查看/暂停/恢复/保存运行中的 workflow
`/install-github-app`	安装 GitHub App

其他

/help · /login · /logout · /exit（别名 /quit）· /bug（别名 /share）· /feedback · /release-notes · /privacy-settings · /upgrade · /mobile · /powerup（互动教程）· /voice · /radio · /stickers · /heapdump（诊断内存，不出现在菜单里，要手打全名）

⚠️ 已移除的命令

命令	状况
`/vim`	v2.1.92 移除 → 用 `/config` → Editor mode
`/pr-comments`	v2.1.91 移除 → 直接让 Claude 去看 PR 评论
`/ultraplan`	已移除 → 用计划模式
`/output-style`	不再是独立命令 → 并入 `/config`
`/todos`	从未存在 → 待办清单用 `Ctrl+T` 切换，后台任务用 `/tasks`

💎 技能也是斜杠命令。输入 / 后按 Tab 看全部可用项。用 /skills 按 token 排序，能揪出吃上下文的技能。

第 3 章 · 启动参数完全手册

🌱 会话恢复（最高频）

claude -c                        # 继续当前目录最近一次对话
claude -r                        # 交互式选择历史会话
claude -r <session-id>           # 直接恢复指定会话
claude -r "登录"                 # 带搜索词打开选择器
claude -c --fork-session         # 继续但新建会话 ID，不污染原会话
claude --from-pr 1234            # 恢复与某 PR 关联的会话
claude -n "支付重构"             # 💎 给会话起名，/resume 列表一眼认出
claude --session-id <uuid>       # 指定会话 ID（脚本化有用）

模型与思考

claude --model opus                    # opus / sonnet / fable / haiku
claude --model claude-opus-5           # 也可用完整模型名
claude --effort max                    # low | medium | high | xhigh | max
claude --fallback-model sonnet,haiku   # 主模型过载时依次降级（仅 -p 模式）

权限

claude --permission-mode plan               # 直接进计划模式
claude --permission-mode acceptEdits        # 自动接受文件编辑
claude --permission-mode dontAsk            # 不询问
claude --permission-mode bypassPermissions  # 等同 YOLO
claude --dangerously-skip-permissions       # 🔥 YOLO 模式，仅隔离沙箱用
claude --allow-dangerously-skip-permissions # 💎 只是"允许切换到"YOLO，不默认开
claude --allowedTools "Bash(git *)" Edit Read
claude --disallowedTools "Bash(rm *)" "Bash(sudo *)"
claude --tools "Bash,Edit,Read"             # 只启用这几个工具；"" 全禁用

💎 --allow-dangerously-skip-permissions 比 --dangerously-skip-permissions 安全得多：前者只是解锁这个选项，你还得手动 Shift+Tab 切过去；后者一上来就全放开。

目录与工作区

claude --add-dir ../shared ../docs   # 🔥 允许访问工作目录之外的路径
claude -w feature-x                  # 新建 git worktree 跑本会话
claude -w feature-x --tmux           # worktree + tmux/iTerm2 分屏

系统提示定制

claude --system-prompt "你是只写 Rust 的严格审查者"       # 完全替换
claude --append-system-prompt "回复必须附带复杂度分析"     # 💎 追加（更常用）
claude --system-prompt-file ./prompts/reviewer.md
claude --agents '{"reviewer":{"description":"审查代码","prompt":"你是代码审查专家"}}'

后台与远程

claude --bg "跑完整测试并修复失败"    # 后台 agent，立即返回
claude agents                        # 管理后台 agent 的 TUI
claude agents --json                 # 脚本读取运行中的 agent
claude agents --cwd ~/proj           # 只看某目录下的
claude --remote-control              # 开启远程控制
claude --brief                       # 允许 agent 主动给你发消息

排障与极简

claude --safe-mode        # 🔥 禁用所有自定义配置，排查"配置炸了"
claude --bare             # 💎 极简模式：跳过 hooks/LSP/插件/自动记忆，最快启动
claude -d api,hooks       # debug 带分类过滤，! 前缀排除：-d "!file,!1p"
claude --debug-file /tmp/cc.log
claude --verbose
claude --ax-screen-reader # 无障碍：纯文本输出，无装饰边框和动画

其他

claude --ide                     # 启动时自动连接 IDE
claude --chrome / --no-chrome    # Claude in Chrome 集成
claude --autocompact 200k        # 💎 自定义自动压缩触发点（100k–1M）
claude --plugin-dir ./my-plugin  # 仅本次会话加载本地插件（开发调试）
claude --setting-sources user,project   # 💎 只加载指定来源的设置
claude --settings ./team.json    # 额外加载一份设置
claude --betas <name>            # 启用 beta 特性（API key 用户）

第 4 章 · 上下文管理（最重要的一章）

🔥 90% 的"Claude 变笨了"都是上下文问题。 这一章的收益远大于其他任何技巧。

症状识别

现象	原因
忘记你三轮前说的要求	上下文被自动压缩了
反复读同一个文件	之前读的内容被挤出去了
回答开始泛泛而谈	有效信息被噪音稀释
速度明显变慢、费用飙升	上下文太长，每轮都在重复处理

🔥 核心工具：`/context`

定期跑 /context，你会看到类似：

系统提示     8k
CLAUDE.md    3k
MCP 工具定义 47k   ← 罪魁祸首通常在这
技能定义     12k
对话历史     85k

看到 MCP 占几万 token 就该动手了 —— 卸掉不用的服务器，能瞬间回收 30%+ 空间。

🚀 五个降低上下文压力的招式

1. 一个任务一个会话
做完就 /clear。不要在同一个会话里连着做"修 bug → 加功能 → 写文档"。

2. 带指令的 /compact

/compact 只保留：最终采用的架构方案、修改过的文件列表、未解决的问题。
丢弃：所有调试过程、失败的尝试、文件的原始内容。

比裸 /compact 效果好一个数量级。

3. 让子 Agent 承担搜索

派一个子 agent 去搜索整个仓库里所有调用 legacy API 的地方，只把结论给我

子 agent 读文件的过程不进入你的主上下文，只回结论。大范围搜索必用。

4. 用 ! 而不是让 Claude 跑命令
你自己 !git log --oneline -5 只进来 5 行；让 Claude 去跑，它可能先 git log 再 git show 再 git diff，进来几千行。

5. 精准引用而不是让它自己找
@src/auth/session.ts 的第 40 行有 bug 比 "登录有问题你查一下" 省 90% 的探索成本。

💎 冷门：调整自动压缩阈值

claude --autocompact 300k    # 上下文到 300k 才触发自动压缩
claude --autocompact auto    # 默认自适应

在 1M 上下文的模型上，把阈值调高能减少压缩次数（每次压缩都会丢信息）。

💎 冷门：跨机器提高缓存命中

claude --exclude-dynamic-system-prompt-sections

把 cwd、环境信息、git 状态从系统提示挪到第一条用户消息里。团队成员之间、CI 多次运行之间的 prompt cache 命中率会大幅提升 —— 直接省钱。

第 5 章 · CLAUDE.md 与记忆系统

🔥 四层结构（优先级由低到高）

~/.claude/CLAUDE.md          全局偏好，所有项目生效
项目根/CLAUDE.md             团队共享，提交进 git
项目根/CLAUDE.local.md       个人偏好，写进 .gitignore
子目录/CLAUDE.md             按需加载，进入该目录相关工作时才生效

🌱 怎么写 CLAUDE.md

好的写法（约定、命令、禁忌）：

# 项目约定

## 命令
- 开发：`pnpm dev`（不要用 npm）
- 测试：`pnpm test -- --run`（watch 模式会卡住）
- 类型检查：`pnpm typecheck`

## 代码规范
- 组件用函数式 + TypeScript，禁止 class 组件
- 状态管理只用 zustand，不要引入 redux
- API 层统一走 `src/lib/api-client.ts`，不要直接 fetch

## 禁忌
- 不要修改 `src/generated/` 下的任何文件（自动生成）
- 不要在未跑通 typecheck 前提交

坏的写法：把代码结构、文件列表、git 历史抄进去 —— 这些 Claude 自己能看，纯浪费 token。

🌱 原则：CLAUDE.md 只写"从代码里看不出来的东西"。

🚀 `#` 快捷记忆

输入框打 # 开头的内容，Claude 会问你存到哪：

# 这个项目的 CI 很慢，本地改完先跑 pnpm test:unit，别直接推

比手动编辑文件快得多。用 /memory 可以随时查看和编辑。

💎 冷门：子目录 CLAUDE.md

大型 monorepo 里，在 packages/api/CLAUDE.md 写后端约定，packages/web/CLAUDE.md 写前端约定。Claude 只在处理对应目录时加载 —— 上下文不会被无关规范占满。

第 6 章 · 权限系统

🔥 五种模式（`Shift+Tab` 循环）

模式	行为	适用场景
`manual`	每个动作都问	生产代码、不熟悉的仓库
`acceptEdits`	文件编辑自动过，命令仍要问	🔥 日常最常用
`plan`	只读探索，不改任何东西	大改动前先出方案
`auto`	智能判断风险	中等信任场景
`bypassPermissions`	全放开（YOLO）	一次性沙箱、容器

🚀 精细化权限规则

在 .claude/settings.json 里配：

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(pnpm test:*)",
      "Read(**)",
      "Edit(src/**)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Read(.env)",
      "Read(**/*.pem)",
      "Edit(src/generated/**)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared"]
  }
}

规则语法：

Bash(命令) 精确匹配
Bash(命令:*) 前缀匹配
Read(路径glob) / Edit(路径glob)
deny 优先级最高，永远覆盖 allow

💎 deny 保护敏感文件：把 .env、*.pem、credentials.json 加进 deny，Claude 永远读不到，避免密钥意外进入上下文或日志。

🔥 懒人法：跟 Claude 说"帮我允许所有 git 只读命令"，它会调用内置技能自动写进 settings.json。或者用 /fewer-permission-prompts 技能，它会扫描你的历史，自动生成一份合理的允许清单。

🚀 YOLO 模式的正确用法

# ❌ 危险：在真实项目里全放开
claude --dangerously-skip-permissions

# ✅ 更好：在 Docker / 断网沙箱里跑
docker run --rm -it -v $(pwd):/work myimage \
  claude --dangerously-skip-permissions

# ✅ 折中：解锁但不默认开启，需要时手动 Shift+Tab
claude --allow-dangerously-skip-permissions

第 7 章 · 计划模式与高效工作流

🔥 计划模式（Plan Mode）

三种进入方式：

Shift+Tab 循环切到 plan
💎 /plan <描述> —— 直接进计划模式并立刻开始该任务，如 /plan 修复登录 bug
claude --permission-mode plan 启动时就进

Claude 会只读探索，不改任何文件，最后给你一份实施方案。你批准后才动手。

什么时候必须用：

改动涉及 3 个以上文件
不熟悉的代码库
有多种实现路径的需求
涉及数据库迁移、API 契约变更

怎么让方案更好：

先进入计划模式。我要给评论系统加上嵌套回复。
要求：
- 先读现有 comment 相关代码，告诉我当前数据结构
- 给出至少两种方案，说明各自的取舍
- 指出会影响到的 API 和前端组件
- 估算改动规模

🔥 思考强度控制

方式一：正文关键词（逐级提升）

think            低
think hard       中
think harder     高
ultrathink       最高

方式二：/effort（推荐）

/effort low        简单任务，快
/effort medium     默认
/effort high       复杂重构
/effort xhigh      架构设计
/effort max        最难的问题（仅当前会话）
/effort ultracode  💎 最高档，会默认用多 agent workflow 编排（仅当前会话）
/effort auto       回到模型默认

方式三：Option+T 直接开关扩展思考。

🚀 高 effort 更慢更贵，但在"想清楚"类任务上收益巨大。日常改 bug 用 medium，架构设计用 xhigh/max。
💡 /effort 立即生效，不用等当前回复跑完 —— 发现 Claude 想得太浅可以中途加档。

🚀 高效 Prompt 模板

【背景】这个项目用 Next.js 15 + Prisma，评论表已有 3000 万行
【目标】给评论加嵌套回复，最多 3 层
【约束】
- 不能停机迁移
- 查询性能不能退化（现在 p99 是 80ms）
- 前端改动尽量小
【验收】
- 跑通 pnpm test
- 新增至少 3 个测试用例
【先做】先给我方案，不要直接改代码

💎 冷门：让 Claude 自我批判

你刚才的方案，站在一个反对者的角度找出三个最大的问题

如果这个改动上线后出事故，最可能是哪里出的问题？

比你自己 review 更快发现漏洞。

💎 冷门：`/goal` 让 Claude 跨轮死磕

/goal 所有测试通过且 typecheck 无报错

设定目标后，Claude 会跨多个回合持续工作直到条件满足，不用你一轮轮催。/goal clear 提前取消。

💎 冷门：`/btw` 问不进上下文的小问题

/btw 这个项目的 pnpm 版本要求是多少

答案不进入主对话，不污染上下文。查个小事实特别合适。

第 8 章 · 子 Agent 与后台任务

🚀 子 Agent 的核心价值：上下文隔离

子 agent 干活时读的文件、跑的命令不进入你的主上下文，只把结论带回来。

内置 agent 类型：

Explore — 只读搜索，大范围找代码
Plan — 架构设计，出实施方案
general-purpose — 通用多步任务

触发方式：直接说

派一个 Explore agent 找出所有用到旧版认证中间件的地方

同时派三个 agent 分别审查：安全性、性能、可维护性

🚀 并行派多个 agent 时它们同时跑，比串行快得多。

🚀 自定义 Agent

~/.claude/agents/reviewer.md（全局）或 .claude/agents/reviewer.md（项目）：

---
name: security-reviewer
description: 审查代码的安全问题。当涉及认证、加密、用户输入处理时使用。
tools: Read, Grep, Bash
model: opus
---

你是一名安全审查专家。重点检查：
1. 注入类漏洞（SQL、命令、XSS）
2. 认证与授权缺陷
3. 敏感信息泄露
4. 不安全的依赖

对每个发现，给出：文件:行号、危害说明、可复现场景、修复建议。
不要报告理论上可能但实际无法触发的问题。

之后可以 claude --agent security-reviewer 启动，或在会话里说"用 security-reviewer 审一下"。

🔥 后台 Agent

claude --bg "跑完整测试套件，修复所有失败的用例"
claude agents          # TUI 查看和管理
claude agents --json   # 脚本读取
claude agents --all    # 包含已完成的

会话内也可以直接说"后台跑一下完整测试"，跑完会通知你。

💎 配合 hooks 做完成提醒：在 Stop 或 Notification 事件上挂个 osascript -e 'display notification ...'，长任务跑完 macOS 会弹通知。

💎 冷门：`claude ultrareview`

claude ultrareview              # 云端多 agent 审查当前分支
claude ultrareview 1234         # 审查指定 PR
claude ultrareview main         # 相对 main 分支审查
claude ultrareview --json
claude ultrareview --timeout 45

不占本地上下文，云端跑一堆 agent 交叉验证，找出的问题质量比单次审查高不少。

第 9 章 · MCP 服务器

🌱 什么是 MCP

给 Claude 接外部能力的标准协议 —— 查文档、连数据库、操作浏览器、读 Figma 等。

🔥 添加服务器

# HTTP 服务器（最常见）
claude mcp add --transport http -s user context7 https://mcp.context7.com/mcp

# 带认证头
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp \
  --header "Authorization: Bearer xxx"

# 本地 stdio 服务器
claude mcp add my-server -e API_KEY=xxx -- npx -y my-mcp-server

# 带子进程参数
claude mcp add my-server -- my-command --flag arg1

# JSON 一把梭
claude mcp add-json myserver '{"command":"npx","args":["-y","pkg"]}'

# 从 Claude Desktop 导入（Mac / WSL）
claude mcp add-from-claude-desktop

🔥 作用域 `-s`

值	存储位置	适用
`local`（默认）	仅本机本项目	个人实验
`user`	`~/.claude/` 全局	所有项目都要用的（如 context7）
`project`	项目 `.mcp.json`	团队共享，提交进 git

管理

claude mcp list              # 列表 + 健康检查
claude mcp get context7      # 详情
claude mcp login <name>      # OAuth 登录
claude mcp logout <name>
claude mcp remove <name>

会话内用 /mcp 查看状态和登录。

🚀 隔离测试

# 只用指定配置，忽略全部其他 MCP —— 干净环境调试
claude --mcp-config ./test.json --strict-mcp-config

🔥 值得装的 MCP

服务器	用途
context7	查开源库最新文档，避免 Claude 用过时 API
playwright / puppeteer	驱动浏览器，前端调试神器
postgres / sqlite	直接查库看真实数据结构
github	管 issue、PR
filesystem	访问指定目录外的文件

⚠️ MCP 的代价

每个 MCP 服务器的工具定义都常驻上下文，一个大服务器能吃掉 20k+ token。

/context     # 定期检查，发现哪个最贵

💎 策略：只保留天天用的（如 context7）在 -s user，项目专用的用 -s project，实验性的用完就 claude mcp remove。

第 10 章 · 插件、技能与自定义命令

三种扩展方式对比

方式	位置	特点
自定义命令	`.claude/commands/*.md`	最简单，就是 prompt 模板
技能（Skill）	`.claude/skills/<name>/SKILL.md`	有触发描述，可带脚本和资源
插件（Plugin）	通过市场安装	打包了技能+agent+hooks+MCP

🌱 自定义命令（五分钟上手）

.claude/commands/fix-issue.md：

---
description: 根据 GitHub issue 编号修复问题
---

请修复 issue #$ARGUMENTS：
1. 用 gh issue view $ARGUMENTS 读取详情
2. 定位相关代码
3. 写修复 + 测试
4. 跑测试确认通过

之后在会话里 /fix-issue 123 即可。

$ARGUMENTS 接收全部参数，$1 $2 接收位置参数。

🚀 技能（Skill）

.claude/skills/deploy/SKILL.md：

---
name: deploy
description: 部署到生产环境。当用户说"部署"、"上线"、"发布"时使用。
---

# 部署流程

1. 确认在 main 分支且工作区干净
2. 跑 `pnpm build && pnpm test`
3. 跑 `./scripts/deploy.sh production`
4. 检查 https://status.example.com 确认健康
5. 在 #deploys Slack 频道发通知

关键：description 决定 Claude 什么时候自动想起用它。写清楚触发场景。

也可以手动 /deploy 调用。

🔥 插件管理

claude plugin marketplace add <github-repo-or-url>
claude plugin marketplace list
claude plugin marketplace update

claude plugin install <name>@<marketplace>
claude plugin list
claude plugin details <name>      # 💎 看组件清单和预计 token 成本
claude plugin enable/disable <name>
claude plugin prune               # 清理不再需要的自动依赖
claude plugin init my-plugin      # 脚手架
claude plugin eval <target>       # 💎 跑评测用例，量化技能效果

💎 claude plugin details 是个宝：安装前先看它要占多少 token。有些插件光工具定义就 30k，装上你的上下文直接少三成。

💎 本地插件开发

claude --plugin-dir ./my-plugin        # 仅本次会话加载，改完重启即可看效果
claude --plugin-url https://.../x.zip

第 11 章 · Hooks 自动化

🔥 这是唯一能实现"每次 X 就自动 Y"的机制。 写进 CLAUDE.md 只是"请求 Claude 自觉"，hooks 是 harness 强制执行 —— 100% 触发。

事件类型

事件	触发时机	能否阻止
`PreToolUse`	工具调用前	✅ 可否决
`PostToolUse`	工具调用后	❌
`UserPromptSubmit`	你提交消息时	✅ 可注入上下文
`PermissionRequest`	请求权限时	✅
`Notification`	发通知时	❌
`Stop`	Claude 回合结束	❌
`SubagentStop`	子 agent 结束	❌
`PreCompact`	压缩上下文前	❌
`SessionStart`	会话开始	❌ 可注入上下文
`SessionEnd`	会话结束	❌

配置结构

写在 ~/.claude/settings.json（全局）或 .claude/settings.json（项目）：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "sh -c 'cd \"$CLAUDE_PROJECT_DIR\" && pnpm prettier --write $(jq -r \".tool_input.file_path\") 2>/dev/null; exit 0'"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"任务完成\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

要点：

matcher 用正则匹配工具名，"*" 匹配全部
hook 通过 stdin 收到 JSON（含 tool_name、tool_input、session_id 等），用 jq 解析
timeout 可选，单位秒
退出码非 0 且是 PreToolUse 时会阻止该工具调用

🔥 实用 hook 配方

1. 改完自动格式化

"PostToolUse": [{
  "matcher": "Edit|Write",
  "hooks": [{"type": "command",
    "command": "sh -c 'f=$(jq -r .tool_input.file_path); case \"$f\" in *.ts|*.tsx) npx prettier --write \"$f\";; *.go) gofmt -w \"$f\";; esac; exit 0'"}]
}]

2. 禁止碰敏感文件

"PreToolUse": [{
  "matcher": "Edit|Write",
  "hooks": [{"type": "command",
    "command": "sh -c 'f=$(jq -r .tool_input.file_path); case \"$f\" in *.env*|*secrets*) echo \"禁止修改敏感文件\" >&2; exit 2;; esac; exit 0'"}]
}]

3. 长任务完成提醒（macOS）

"Stop": [{
  "hooks": [{"type": "command",
    "command": "afplay /System/Library/Sounds/Glass.aiff"}]
}]

4. 每次提问自动注入当前分支

"UserPromptSubmit": [{
  "hooks": [{"type": "command",
    "command": "sh -c 'echo \"当前分支: $(git branch --show-current)\"'"}]
}]

🌱 不想手写 JSON：直接跟 Claude 说"每次改完 .ts 文件自动跑 prettier"，它会调用内置的 update-config 技能帮你写好。

🚀 紧急关闭所有 hooks：claude --safe-mode 或在 settings 里设 "disableAllHooks": true。

💎 状态栏定制

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/your-script.sh"
  }
}

脚本通过 stdin 收到会话信息 JSON，输出一行文本显示在状态栏。可以显示当前分支、token 用量、天气、番茄钟…… 用 /statusline 命令交互式配置更简单。

第 12 章 · 脚本化与 CI 集成

🚀 这是被最严重低估的能力 —— 把 Claude 当成命令行里的一个函数。

基础

claude -p "总结这个仓库的架构"                  # 打印结果就退出
git diff | claude -p "审查这些改动，只报严重问题"  # 管道输入
cat error.log | claude -p "分析这个报错的根因"

结构化输出

claude -p "列出所有 TODO 注释" --output-format json
claude -p "..." --output-format stream-json      # 流式
claude -p "..." --output-format stream-json --include-partial-messages

🔥 JSON Schema 强制结构

claude -p "找出这个文件的所有 bug" \
  --json-schema '{
    "type":"object",
    "properties":{
      "bugs":{"type":"array","items":{
        "type":"object",
        "properties":{"file":{"type":"string"},"line":{"type":"number"},"desc":{"type":"string"}},
        "required":["file","line","desc"]
      }}
    },
    "required":["bugs"]
  }'

输出保证符合 schema，可以直接喂给下游程序。

成本控制

claude -p "..." --max-budget-usd 2          # 花费上限
claude -p "..." --fallback-model sonnet     # 主模型过载自动降级
claude -p "..." --no-session-persistence    # 不落盘

🔥 实战配方

Git pre-commit hook

#!/bin/sh
result=$(git diff --cached | claude -p \
  "审查这些改动。只有发现会导致生产事故的问题才输出，否则输出 OK。" \
  --model sonnet)
if [ "$result" != "OK" ]; then
  echo "$result"
  exit 1
fi

批量处理文件

for f in src/**/*.ts; do
  claude -p "给 $f 里所有导出函数补上 JSDoc 注释，直接修改文件" \
    --permission-mode acceptEdits
done

生成 PR 描述

git diff main...HEAD | claude -p "写一份 PR 描述，中文，包含变更摘要和测试要点" \
  | gh pr create --title "$(git branch --show-current)" --body-file -

CI 里跑审查

- name: Claude Review
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  run: |
    git diff origin/main...HEAD | \
    claude -p "审查改动，输出 markdown" --max-budget-usd 1 > review.md

💎 CI 用 claude setup-token 生成长效 token，比直接放 API key 更好管理。

💎 --bare 加速脚本：跳过 hooks、LSP、插件同步、自动记忆，启动快一大截，脚本场景很值。

第 13 章 · Git / GitHub 工作流

🔥 常用说法

提交这些改动                      # Claude 会自己写 commit message
提交并推送
开一个 PR，描述写详细点
看一下 main 和当前分支的差异
把最近三个 commit 压成一个
帮我 rebase 到 main
这行代码是谁改的，为什么改（git blame + log）

⚠️ Claude 只在你明确要求时才提交/推送，不会自作主张。

PR 相关

claude --from-pr 1234       # 恢复与该 PR 关联的会话
claude --from-pr            # 交互式选择

会话内：

/review                     # 审查 GitHub PR
/security-review            # 安全审查当前分支改动

💎 冷门：让 Claude 处理 CI 失败

gh 上这个 PR 的 CI 挂了，看一下日志找出原因并修复

Claude 会用 gh run view 拉日志、定位、修改、推送。

💎 冷门：babysit 模式

如果装了相关插件，可以让 Claude 持续盯着一个 PR，直到 review 意见全部解决、CI 全绿。配合 /loop 技能可以定时轮询。

第 14 章 · Worktree 并行开发

🚀 同时开三个 Claude 干三件事，各自独立分支互不干扰。

claude -w feature-auth       # 自动创建 worktree + 分支
claude -w hotfix-payment
claude -w refactor-api --tmux    # iTerm2 原生分屏 / tmux
claude --tmux=classic            # 强制传统 tmux

典型用法：

窗口 A：claude -w feature-a 开发新功能
窗口 B：claude -w hotfix 修紧急 bug
窗口 C：主目录跑测试 / review

每个 worktree 是独立的工作目录，改动完全隔离，不会互相污染。

会话内也可以用 /worktree 相关命令切换。

💎 结合 claude --bg：把耗时的重构丢后台 worktree 跑，你继续在主分支干活。

第 15 章 · 配置文件与环境变量

配置文件位置与优先级

企业策略配置（管理员）            最高
~/.claude/settings.json          用户全局
项目/.claude/settings.json       项目共享（进 git）
项目/.claude/settings.local.json 项目本地（进 .gitignore）
命令行参数                        最高（覆盖上面全部）

🔥 settings.json 常用键

{
  "model": "opus",
  "permissions": {
    "allow": ["Bash(git status)"],
    "deny": ["Read(.env)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared"]
  },
  "env": {
    "NODE_ENV": "development",
    "ANTHROPIC_MODEL": "claude-opus-5"
  },
  "hooks": { },
  "statusLine": {"type": "command", "command": "/path/to/script.sh"},
  "enabledPlugins": {"plugin-name@marketplace": true},
  "extraKnownMarketplaces": { },
  "includeCoAuthoredBy": false,
  "cleanupPeriodDays": 30,
  "outputStyle": "default",
  "enableAllProjectMcpServers": false,
  "disabledMcpjsonServers": ["heavy-server"],
  "enabledMcpjsonServers": ["github"],
  "alwaysThinkingEnabled": false,
  "apiKeyHelper": "/path/to/get-key.sh",
  "forceLoginMethod": "console",
  "autoUpdates": true,
  "spinnerTipsEnabled": false,
  "disableAllHooks": false
}

💎 disabledMcpjsonServers —— 项目 .mcp.json 里有个巨占 token 的服务器但你不想改团队配置？在本地 settings.local.json 里把它单独关掉。

💎 "includeCoAuthoredBy": false —— 关掉 commit message 里的 "Co-Authored-By: Claude" 署名。很多人找这个找半天。

🚀 常用环境变量

写在 shell 配置里，或 settings.json 的 env 块：

变量	作用
`ANTHROPIC_API_KEY`	API key
`ANTHROPIC_MODEL`	默认模型
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	单次输出上限
`MAX_THINKING_TOKENS`	思考 token 上限
`BASH_DEFAULT_TIMEOUT_MS`	Bash 默认超时
`BASH_MAX_TIMEOUT_MS`	Bash 最大超时
`BASH_MAX_OUTPUT_LENGTH`	💎 Bash 输出截断长度（默认会截，日志类任务可调大）
`MCP_TIMEOUT`	MCP 启动超时
`MCP_TOOL_TIMEOUT`	MCP 工具调用超时
`DISABLE_TELEMETRY`	关遥测
`DISABLE_ERROR_REPORTING`	关错误上报
`DISABLE_AUTOUPDATER`	关自动更新
`CLAUDE_CODE_USE_BEDROCK`	走 AWS Bedrock
`CLAUDE_CODE_USE_VERTEX`	走 Google Vertex
`HTTPS_PROXY` / `HTTP_PROXY`	代理
`CLAUDE_CODE_SUBAGENT_MODEL`	💎 给子 agent 单独指定模型
`CLAUDE_PROJECT_DIR`	hook 脚本里可用，指向项目根目录
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	关闭所有非必要网络请求

✅ 上表全部在 v2.1.222 二进制中核验存在。

💎 省钱组合技：CLAUDE_CODE_SUBAGENT_MODEL=claude-haiku-4-5-20251001 —— 主会话用 Opus 思考，子 agent 用 Haiku 干搜索这种脏活。搜索类任务本来就不需要强模型，成本能降一大截。

💎 设置来源控制

claude --setting-sources user            # 只加载用户设置，忽略项目设置
claude --setting-sources user,project    # 忽略 local
claude --settings ./team-preset.json     # 额外加载一份

调试"是哪层配置导致的问题"时非常有用。

第 16 章 · 冷门技巧集锦

💎 1. `--bare` 极速启动

跳过 hooks、LSP、插件同步、attribution、自动记忆、CLAUDE.md 自动发现。脚本和快速问答场景启动快得多。

claude --bare -p "把这段 JSON 转成 TypeScript 接口" < data.json

💎 2. `--fork-session` 分叉实验

claude -c --fork-session

基于当前上下文开一个新分支，随便折腾，原会话完好无损。

💎 3. `-n` 给会话命名

claude -n "支付重构-第2天"

名字显示在提示框、/resume 列表、终端标题栏。一周后回来一眼找到。

💎 4. `claude project purge`

claude project purge ~/old-project

彻底删除某项目的全部 Claude 状态（transcripts、tasks、file history、配置项）。清理磁盘或交接项目时用。

💎 5. `claude import`

claude import cursor
claude import ./other-agent-config

从其他 AI 编码工具导入配置，迁移时省事。

💎 6. `--tools ""` 纯对话模式

claude --tools ""

禁用所有工具，纯聊天。当作一个不会乱动你文件的技术顾问用。

💎 7. 图片直接粘贴

截图后在输入框 Ctrl+V（macOS 也是 Ctrl+V）。

[粘贴设计稿] 按这个稿子实现组件
[粘贴报错截图] 这是什么问题
[粘贴架构图] 按这个图重构模块划分

💎 8. `Ctrl+B` 命令转后台

Claude 跑了个巨慢的命令，Ctrl+B 丢后台，继续干别的。

💎 9. `!` 前缀省上下文

!git log --oneline -5

只进来 5 行。让 Claude 自己探索可能进来几千行。

💎 10. `--append-system-prompt` 固化人格

alias claude-strict='claude --append-system-prompt "每次回复必须指出至少一个你的方案的潜在风险。不要说套话。"'

💎 11. `/compact` 带指令

/compact 只保留最终方案和未解决问题，丢弃所有调试过程

💎 12. `claude plugin eval`

claude plugin eval my-skill

跑评测用例，量化你写的技能到底有没有效果，还带无插件的基线对照组。

💎 13. `--exclude-dynamic-system-prompt-sections`

提高团队/CI 之间的 prompt cache 命中率，直接省钱。

💎 14. `claude agents --json`

claude agents --json | jq '.[] | select(.status=="running") | .name'

脚本化监控后台 agent。

💎 15. 让 Claude 自己找答案

用 context7 查一下 Next.js 15 的 App Router 缓存策略最新文档

比它凭记忆答准确得多 —— 训练数据总有滞后。

💎 16. 多 agent 交叉验证

派三个独立 agent 分别从"正确性""安全性""性能"角度审查这个改动，
然后综合它们的结论，只保留至少两个 agent 都认同的问题

💎 17. `--add-dir` 跨仓库工作

claude --add-dir ../design-system ../api-types

前端项目里同时能读 design system 和 API 类型定义仓库。

💎 18. `/fewer-permission-prompts`

扫描你的历史记录，自动生成一份合理的权限允许清单，从此少弹一半确认框。

💎 19. `claude --remote-control`

开启远程控制会话，可以从手机/别的设备接管。

💎 20. `/loop` 定时轮询

/loop 5m 检查 CI 状态，绿了就通知我

让 Claude 按间隔重复执行某个任务。

第 17 章 · 排障手册

排障三板斧

# 1. 先确认是不是自定义配置炸了
claude --safe-mode

# 2. 如果 safe-mode 正常 → 是你的配置问题，逐层排查
claude --setting-sources user      # 只用用户配置试试
claude --plugin-dir ""             # 不加载插件
claude --strict-mcp-config --mcp-config '{}'   # 不加载 MCP

# 3. 体检并修复
claude doctor          # 终端里跑，只读检查
/doctor                # 会话里跑，可自动修复

常见问题

症状	排查
启动很慢	MCP 服务器超时。`claude mcp list` 看谁挂了，或 `--bare` 试试
Claude "变笨"	`/context` 看上下文，多半该 `/clear` 或精细 `/compact` 了
权限框弹不停	`/permissions` 加规则，或用 `/fewer-permission-prompts`
找不到某个技能	`claude plugin list` 确认已启用；`/` + Tab 看可用列表
MCP 连不上	`claude mcp get <name>` 看详情；`claude mcp login <name>` 重新授权
Shift+Enter 不换行	iTerm2 / Ghostty / Kitty / WezTerm / Warp / Apple Terminal / Windows Terminal 原生支持；VS Code / Cursor / Alacritty / Zed 跑 `/terminal-setup`。兜底用 `Ctrl+J`
改了 settings.json 没生效	JSON 语法错误会被静默忽略。用 `jq . settings.json` 验证
hooks 不触发	`claude -d hooks` 看调试日志；确认 `matcher` 正则匹配到了
中文乱码	检查终端 locale：`echo $LANG` 应含 `UTF-8`

调试日志

claude -d                        # 全部
claude -d api,hooks              # 只看这两类
claude -d "!file,!1p"            # 排除这两类
claude --debug-file /tmp/cc.log  # 写到文件

第 18 章 · 省钱与省 Token

🔥 按收益排序

1. 一个任务一个会话（收益最大）
长会话的每一轮都在重复处理全部历史。做完就 /clear。

2. 卸掉不用的 MCP
/context 看谁最贵。一个大 MCP 常驻 20k+ token，每轮都在付费。

3. 用对模型

claude --model haiku    # 简单批量任务
claude --model sonnet   # 日常开发
claude --model opus     # 复杂重构、架构设计

4. 用对 effort

/effort low     # 格式化、改文案、简单 bug
/effort medium  # 日常开发（默认）
/effort max     # 只在真难的问题上用

5. 精准引用
@src/auth/session.ts:40 比 "登录有问题" 省 90% 探索成本。

6. 子 agent 承担搜索
搜索过程不进主上下文。

7. --exclude-dynamic-system-prompt-sections
提高 prompt cache 命中率。

8. --max-budget-usd 兜底
脚本化场景设上限，防止失控。

监控

/cost              # 会话内查看当前花费
claude -p "..." --max-budget-usd 2

附录 · 速查卡

每天都会用的 10 个

claude -c                # 继续上次
claude -r                # 挑一个历史会话
Shift+Tab                # 切权限模式
/context                 # 看上下文占用
/clear                   # 清空重开
/compact <指令>          # 带指令压缩
@文件 + Tab              # 引用文件
!命令                    # 直接跑 shell
#内容                    # 存记忆
/effort                  # 调思考强度

遇到问题时的 5 个

claude --safe-mode       # 禁用所有自定义
claude doctor            # 体检
/doctor                  # 体检并修复
claude -d hooks          # 看调试日志
/status                  # 看当前状态

提效的 5 个

claude -w <name>         # worktree 并行
claude --bg "<任务>"     # 后台跑
claude -p "..." | jq     # 脚本化
/code-review ultra       # 云端多 agent 审查
claude --add-dir ../x    # 跨仓库

少有人知但值得记的 8 个

Ctrl+O                   # transcript 查看器（看详细工具调用）
Ctrl+S                   # 暂存当前输入，再按恢复
Option+P                 # 切模型，不清空输入
Ctrl+J                   # 换行，任何终端零配置
/skills                  # 按 t 排序，揪出吃 token 的技能
/btw <问题>              # 问不进上下文的小问题
/branch                  # 对话分叉，原路保留
/diff                    # 交互式看 Claude 每轮改了什么

学习路径建议

第一周：/init + CLAUDE.md + Shift+Tab + /clear
只掌握这四个，效率就能上一个台阶。

第二周：计划模式 + @ 引用 + /context + /compact
开始有意识地管理上下文。

第三周：权限规则 + 自定义命令 + 一个 MCP（推荐 context7）
把重复性的东西固化下来。

第四周：Hooks + 子 agent + -p 脚本化
让 Claude 融进你的自动化流水线。

之后：worktree 并行、自定义 agent、插件开发、CI 集成。

Claude Code 迭代很快，命令和参数可能变化 ——
以 claude --help、会话内 /help 和官方文档 https://docs.claude.com/claude-code 为准。

有疑问时最快的办法：直接问 Claude "这个参数是干什么的"，它能读到自己的帮助信息。

posted @ 2026-08-08 22:58 少说点话阅读(38) 评论(0) 收藏举报

刷新页面返回顶部

Sue

Claude Code CLI 使用技巧大全

Claude Code CLI 使用技巧大全

第 0 章 · 三分钟上手

🌱 安装与登录

🌱 第一次运行

🌱 必须建立的五个心智模型

🌱 最小可用工作流

第 1 章 · 输入框语法与快捷键

🔥 五个前缀符号

🔥 快捷键表

🚀 Esc Esc 的正确理解

第 2 章 · 斜杠命令完全手册

上下文与会话

配置

项目与扩展

内置技能（Bundled Skills）

云端与跨端

其他

⚠️ 已移除的命令

第 3 章 · 启动参数完全手册

🌱 会话恢复（最高频）

模型与思考

权限

目录与工作区

系统提示定制

后台与远程

排障与极简

其他

第 4 章 · 上下文管理（最重要的一章）

症状识别

🔥 核心工具：/context

🚀 五个降低上下文压力的招式

💎 冷门：调整自动压缩阈值

💎 冷门：跨机器提高缓存命中

第 5 章 · CLAUDE.md 与记忆系统

🔥 四层结构（优先级由低到高）

🌱 怎么写 CLAUDE.md

🚀 # 快捷记忆

💎 冷门：子目录 CLAUDE.md

第 6 章 · 权限系统

🔥 五种模式（Shift+Tab 循环）

🚀 精细化权限规则

🚀 YOLO 模式的正确用法

第 7 章 · 计划模式与高效工作流

🔥 计划模式（Plan Mode）

🔥 思考强度控制

🚀 高效 Prompt 模板

💎 冷门：让 Claude 自我批判

💎 冷门：/goal 让 Claude 跨轮死磕

💎 冷门：/btw 问不进上下文的小问题

第 8 章 · 子 Agent 与后台任务

🚀 子 Agent 的核心价值：上下文隔离

🚀 自定义 Agent

🔥 后台 Agent

💎 冷门：claude ultrareview

第 9 章 · MCP 服务器

🌱 什么是 MCP

🔥 添加服务器

🔥 作用域 -s

管理

🚀 隔离测试

🔥 值得装的 MCP

⚠️ MCP 的代价

第 10 章 · 插件、技能与自定义命令

三种扩展方式对比

🌱 自定义命令（五分钟上手）

🚀 技能（Skill）

🔥 插件管理

💎 本地插件开发

第 11 章 · Hooks 自动化

事件类型

配置结构

🔥 实用 hook 配方

💎 状态栏定制

第 12 章 · 脚本化与 CI 集成

基础

结构化输出

🔥 JSON Schema 强制结构

成本控制

🚀 `Esc Esc` 的正确理解

🔥 核心工具：`/context`

🚀 `#` 快捷记忆

🔥 五种模式（`Shift+Tab` 循环）

💎 冷门：`/goal` 让 Claude 跨轮死磕

💎 冷门：`/btw` 问不进上下文的小问题

💎 冷门：`claude ultrareview`

🔥 作用域 `-s`

💎 1. `--bare` 极速启动

💎 2. `--fork-session` 分叉实验

💎 3. `-n` 给会话命名

💎 4. `claude project purge`

💎 5. `claude import`

💎 6. `--tools ""` 纯对话模式

💎 8. `Ctrl+B` 命令转后台

💎 9. `!` 前缀省上下文

💎 10. `--append-system-prompt` 固化人格

💎 11. `/compact` 带指令

💎 12. `claude plugin eval`

💎 13. `--exclude-dynamic-system-prompt-sections`

💎 14. `claude agents --json`

💎 17. `--add-dir` 跨仓库工作

💎 18. `/fewer-permission-prompts`

💎 19. `claude --remote-control`

💎 20. `/loop` 定时轮询