Claude Code 高级使用指南: Claude Code 31 天技巧集合 从入门到精通
Anthropic 开发者社区主管 Ado 在 2025 年 12 月每天发一条技巧,最后汇总成 31 条。从让它读懂项目开始,到快捷键、上下文管理逐级往上。
- 入门第一步是让它先读懂你的项目,这一步不做后面全是白费。
- /init 自动生成项目说明,相当于给它一份地图。
- 记忆更新不用手动改文件,让它自己维护。
- @ 提及一键打包上下文,是最高频的操作之一。
- 快捷键部分挑了最值得记的几个:! 前缀直接跑命令、双击 Esc 时间回溯。
Anthropic 开发者社区主管 Ado 在 2025 年 12 月每天发一条 Claude Code 小技巧,最后在这篇《Advent of Claude: 31 Days of Claude Code》里,把 31 个技巧 汇总成一篇系统教程,来介绍Claude Code的详细使用技巧。
涵盖从入门到专家级特性、命令、快捷键与自动化功能。
文章不是按“Day 1、Day 2”来排,而是按功能层级分类:
从 最基础的入门 / 快捷键 → 会话管理 → 提效功能 → 思考模式 → 权限与安全 → 自动化与 CI/CD → 浏览器 → Agents & SDK → 快速速查 → 方法论。
你可以把它理解成:Claude Code 的“完整使用说明 + 实战手册”,而且是给已经写代码/做项目的人看的,不是科普文。
本文将这些零散的提示 汇编为一份连贯的指南,并补充了更多上下文说明。
内容涉及从基础命令、会话技巧到自动化、并发、代理模式等各类主题。
入门:让 Claude 先“读懂你的项目”
1. /init——自动给自己写“项目 README”
许多人用 Claude Code 是一上来就开始问:“帮我改这个函数”。 但正确的第一步应该是:让 Claude 先“熟悉环境”。
启动后,先让 Claude:
- 扫描代码结构
- 理解核心模块
- 记录构建与运行方式
- 知道你团队的开发习惯与约定
关键收益:
- 你的 AI 不再是“瞎猜”
- 它记得你的偏好
- 后续沟通会快很多
使用命令:
/init让 Claude 读取整个代码库并生成一个名为 CLAUDE.md 的项目文档。
- Claude 会扫你的代码库,生成一个 CLAUDE.md,里面写清楚:
- 项目的 构建 / 测试命令
- 关键目录是干什么的
- 代码规范、常见模式
- 一些重要架构决策
- 作者的建议:任何新项目进 Claude,第一步就是跑 /init。
.claude/rules/ 模块化规则
- 对于大项目,可以建立:
``text
.claude/rules/
api-rules.md
security.md
testing.md
...
``
- 每个 .md 都会作为“项目记忆”自动加载。
- 支持 YAML frontmatter 控制“这份规则对哪些路径生效”,例子:
```yaml paths: src/api/**/*.ts # API Development Rules
- All API endpoints must include input validation
```
- 可以理解为:
- CLAUDE.md = 项目总说明
- .claude/rules/*.md = 某个子领域的“专项规范”(API、安全、测试等)
2. Memory Updates——不用再手动改 CLAUDE.md
- 以前的旧版本,是在 prompt 前加 #,就会自动追加到 Claude.md。
- 从 Claude Code 2.0.70 开始,这个机制取消了,改成更直白:
你直接在对话里说:
> Update Claude.md: always use bun instead of npm in this project
- Claude 会自己去编辑 Claude.md。
- 好处:
- 不用打断手头思路去打开文件
- 不会忘记更新规范,想到就说一句。
3. @ Mentions——一键给上下文“打包喂料”
@ 是给 Claude 塞上下文的 最快方式:
- @src/auth.ts → 加载某个文件
- @src/components/ → 加载整个目录
- @mcp:github → 启用/关闭某个 MCP server
特点:
- 在 git 仓库里,@ 文件/目录提示会更快,并且支持模糊匹配。
- 实际用法比如:
- “帮我重构 @src/auth.ts 登陆逻辑”
- “请检查 @src/api/ 目录下所有路由有没有认证”
Essential Shortcuts:最值得记住的快捷操作
这一段就是“每天都要用几十次”的操作。
1. ! 前缀——直接跑 Bash 命令
- 不要浪费token再问模型:“能帮我跑下 git status 吗?”
- 直接在 Claude Code 里敲:
``bash
!git status
!npm test
!ls -la src/
``
- 行为:
- Bash 在本地立刻执行
- 输出直接注入 Claude 上下文
- 不占模型 tokens,没有推理时延
- 注意:Bash 命令执行之后无法通过“回滚”撤销,要当真正的终端用。
2. Double Esc——一键“时间回溯”
- 想大胆试试 “What if we…” 的 refactor,又怕改崩?
- 玩完以后,如果你觉得不对劲:
- 连按两次 Esc → 回到最近一个干净的 checkpoint。
- 可以回滚:
- 对话
- 代码修改
- 不能回滚:
- 刚才用 ! 执行的 Bash 命令
3. Ctrl + R——反向搜索历史 Prompt
- 像 shell 里的 reverse search:
- Ctrl + R → 进入搜索
- 再按 Ctrl + R → 在匹配结果之间切换
- Enter → 原样执行
- Tab → 先进入编辑,再发送
- 用途:
- 常用 prompt(例如某个 code review 模板)可以直接搜出来复用
- 和 slash commands 组合效果更好
4. Prompt Stashing——Prompt 的 git stash
- 快捷键:Ctrl + S。
- 行为:
- 当前未发出的草稿被“存起来”
- 你可以去发其他消息、做别的任务
- 回来时,这个草稿会自动恢复
- 实际意义:不用再新开记事本复制那一大段提示词。
5. Prompt Suggestions——Claude 自动补全你的下一步
- 完成一个任务后,Claude 有时会在输入框里显示 灰色的“下一步建议”:
- Tab → 接受并可编辑
- Enter → 直接接受并执行
- 这已经不是代码补全,而是工作流补全:
- 比如刚重构完 code,Claude 提示“要不要顺便写测试”之类
- 功能可以通过 /config 开关。
Session Management:把 Claude 当成一个长期开发环境用
1. --continue / --resume——断线不中断
- 场景:你关掉了终端、电脑死机、出门了。
- 重新打开时:
``bash
claude --continue # 直接恢复最后一次会话
claude --resume # 弹出选择器,挑某个历史会话恢复
``
- 会话保存时间由 cleanupPeriodDays 控制:
- 默认 30 天
- 你可以改成更长,或者改成 0(完全不保存会话)
2. Named Sessions——像管理 git 分支那样管理会话
- 给当前会话起名:
``bash
/rename api-migration
``
- 再次恢复:
``bash
/resume api-migration
claude --resume api-migration
``
- /resume 界面还支持键盘操作:
- P → 预览
- R → 重命名
3. Claude Code Remote / --teleport——Web / Mobile / Desktop 之间接力
- 场景:你在 claude.ai/code 网页上启动了 Claude Code 会话,然后要回到本地终端继续。
- 终端里:
``bash
claude --teleport session_abc123
``
- 这个 session 可以来自:
- 网页版 Claude Code
- Claude 手机 App(iOS / Android)
- Claude Desktop App
- 相当于把“云端跑着的会话”拉回本地继续。
4. /export——整个会话导出为 Markdown
- 命令:
``bash
/export
``
- 导出的内容包括:
- 你发出的每一条 prompt
- Claude 的每一次回复
- 所有工具调用及其输出
- 用途:
- 作为文档、培训材料
- 做复盘(证明自己“之前真的试过这个方案”)
五、Productivity Features:各种“提效小机关”
1. /vim——把 prompt 编辑当成写代码
- 输入 /vim 打开 Vim 模式,再输入 /vim 退出。
- 操作示例:
- h j k l → 移动
- ciw → 改写一个单词
- dd → 删一整行
- w / b → 以单词为单位跳转
- A → 光标跳到行末并进入插入
- 本质:把“编辑提示词”变成一件高频、顺手的事情,而不是只能用鼠标和方向键慢慢挪。
2. /statusline——自定义终端底部状态栏
- /statusline 用来配置底部状态栏显示什么:
- 当前 git 分支及状态
- 正在用的模型
- token 使用情况
- 上下文窗口使用百分比
- 自定义脚本输出
- 价值在于:不用频繁切窗口去看 Git / 配额,用一条状态栏统一展示。
3. /context——上下文的“X 光片”
- 命令:
``bash
/context
``
- 它可以告诉你当前有哪些东西在占用 context:
- 系统 prompt 大小
- MCP servers 的 prompt
- CLAUDE.md 等记忆文件
- 加载的 skills、agents
- 对话历史
- 当你发现“怎么老是 context 爆掉”,就用它来查“谁在吃 tokens”。
4. /stats——你的 Claude 使用仪表盘
- 通过:
``bash
/stats
``
- 内容包括:
- 使用频率、使用模式
- 常用模型
- 使用“打卡连胜记录”等
- 作者的玩笑:
- 以前炫耀的是 GitHub contribution graph
- 现在可以炫耀 Claude Code stats —— “Orange is the new green”。
5. /usage / /extra-usage——清楚自己的额度情况
- 查看当前配额/用量:
``bash
/usage
``
会有进度条形式的可视化。
- 如果要加额外容量:
``bash
/extra-usage
``
- 简单理解:用这俩命令管理自己的“模型水位线”。
Thinking & Planning:掌控 Claude 的思考方式
1. Ultrathink——按需开启“深度思考”
- 用法:在 prompt 里加关键字 ultrathink:
``text
ultrathink: design a caching layer for our API
``
- 效果:
- Claude 会最多分配 32k tokens 的内部推理
- 然后再输出结果
- 适合场景:
- 复杂架构设计
- 比较棘手的调试
- 细节:
- 以前有 think / think harder / ultrathink 三档,现在统一成一个思考预算
- 如果你在配置里设置了 MAX_THINKING_TOKENS,这个配置会覆盖 ultrathink 关键字的控制。
2. Plan Mode——先摸清地形,再动代码
- 进入方式:连按两次 Shift + Tab。
- 在 Plan 模式下,Claude 会:
- 阅读 / 搜索你的代码库
- 分析架构
- 研究依赖
- 输出一套实施计划
- 它不会立刻改任何代码,要你确认后才执行。
- 作者说自己:有 90% 的时间默认用 Plan 模式。
最新版本还支持你在“拒绝某个 plan”时给反馈,使下一次规划更贴近你的预期。3. Extended Thinking(API)——在 API 层看思维链
- 如果你直接调用 Claude API,可以这样写:
``ts
thinking: { type: "enabled", budget_tokens: 5000 }
``
- 效果:
- Claude 会在正式回答前输出一段 thinking blocks,展示中间推理过程
- 应用场景:
- 调试复杂逻辑
- 想看它到底是如何做权衡、做决策的
Permissions & Safety:给 AI 画边界
1. /sandbox——“一次设边界,多次高速运行”
- 没有 /sandbox 的世界是这样的:
- “我能跑 npm install 吗?” → 你点允许
- “我能跑 npm test 吗?” → 再点
- “我能 cat 这个文件吗?” → 再点
- 重复很多遍
- /sandbox 的思路是:
- 一次性定义好边界
- 在这个沙盒范围内,Claude 无需每一步都征求你同意
- 支持通配符:
- 比如允许整个 MCP server:mcp__server__*
- 这是在速度与安全之间找平衡。
2. YOLO Mode——--dangerously-skip-permissions
- 命令:
``bash
claude --dangerously-skip-permissions
``
- 行为:
- 对所有权限请求都“默认允许”
- 本质上是全自动模式
- 名字里已经写着“dangerously”,作者也明确提醒:
- 适合在隔离环境 / 可信场景使用
- 不建议在生产环境乱用
3. Hooks——在关键节点运行你自己的脚本
- Hooks 是在特定生命周期事件触发的 shell 命令,常见事件有:
- PreToolUse / PostToolUse:工具调用前 / 后
- PermissionRequest:有权限请求时
- Notification:Claude 发通知时
- SubagentStart / SubagentStop:子 agent 启动 / 结束
- 配置方式:
- 通过 /hooks
- 或直接写 .claude/settings.json
- 应用例子:
- 拦截危险命令(比如自动拒绝 rm -rf / 这种)
- 把 Claude 的关键操作发到通知系统
- 把工具使用日志写到内部审计系统
- 这相当于用“确定性的脚本”来包住“概率性的 AI 行为”。
Automation & CI/CD:让 Claude 走进你的脚本和流水线
1. Headless Mode——把 Claude 当作 CLI 工具用
- 通过 -p 参数让 Claude 在 非交互模式 下运行:
``bash
claude -p "Fix the lint errors"
claude -p "List all the functions" | grep "async"
git diff | claude -p "Explain these changes"
echo "Review this PR" | claude -p --json
``
- 特点:
- 输出直接写到 stdout
- 非常适合集成到 CI/CD、脚本、别名命令里
- 典型场景:
- 给 PR 自动生成“改动解释”
- 在 CI 里用 Claude 协助做简单代码检查
2. Commands——把好 prompt 变成“可复用命令”
- 你可以建一个 markdown 文件,把某个 prompt 封装成 slash 命令:
- /daily-standup → 每天早上的一套例行提示词
- /explain $ARGUMENTS →
- /explain src/auth.ts
- /explain src/routes/*.ts
- 优点:
- 不再反复手写“代码审查模板 / 重构模板 / commit message 策略”等
- prompt 变成团队统一的“规范化接口”
九、Browser Integration:Claude 直接“操控浏览器”
Claude Code + Chrome
- Claude 现在可以直接控制 Chrome:
- 打开页面、导航
- 点击按钮、填写表单
- 读取 console 错误
- Inspect DOM
- 截图
- 典型用法就是:
- “修这个 bug 并确认在浏览器里真的跑通” → 一句话交给 Claude
- 使用方式:
- 安装 Claude 的 Chrome 扩展(文中链接到 claude.ai/chrome)。
Advanced: Agents & Extensibility——把 Claude 用成“多代理系统”
1. Subagents——“精分”出来的一群 Claude
- 作者的类比:
- 圣诞老人不可能亲自包每一个礼物,他有一群精灵。
- Subagent 的特点:
- 每个 subagent 拥有 独立的 200k context window
- 每个负责一个专门任务
- 可以 并行 运行
- 最后结果统一合并回主 agent
- 它们:
- 可以在后台持续跑
- 也具有对 MCP 工具的访问能力
- 实际想象:
- 一个 subagent 负责文档整理
- 一个负责重构某个模块
- 一个专门跑测试并分析结果
2. Agent Skills——可复用的“领域能力包”
- Skills 本质上是一个文件夹,里面包含:
- 说明文档
- 脚本
- 资源文件
- 作用:
- 教给 Claude 一套特定的“专业能力”
- 比如你们公司的部署流程、测试规范、文档标准
- 重要点:
- 这些叫 Agent Skills,已经被做成一个开放标准
- 所以它不是只给 Claude Code 用,只要支持这个标准的工具都能用。
3. Plugins——把 Commands / Agents / Skills / Hooks / MCP 打成一个包
- 以前要分享自己的 Claude Code 设置,要发很多文件、目录。
- 现在:
``bash
/plugin install my-setup
``
- 一个插件里可以包含:
- commands
- agents
- skills
- hooks
- MCP servers
- 还有插件市场(marketplace),支持搜索和过滤,方便发现别人整理好的工作流。
4. LSP Integration——把 Claude 接到 Language Server 上
- 接入 LSP 之后,Claude 拥有类似 IDE 的代码智能:实时诊断:每次编辑后立刻看到 error / warning
- 导航能力:Go to Definition、Find References、hover 查看信息
- 语言感知:类型、文档、符号的说明
- 这让 Claude 对你的代码库的理解,接近真正 IDE 的视角,而不是仅靠文本匹配。
5. Claude Agent SDK——把 Claude Code 的“agent 循环”嵌入你自己的系统
- SDK 暴露了与 Claude Code 相同的:
- agent loop
- tools
- context 管理机制
- 文中示例大概十几行代码:
- 调用 query()
- 让 agent 自动:读取文件、写文件、使用 Glob 工具
- permissionMode 设为 "acceptEdits",自动接受修改
- 在流式响应中监听 msg.type === 'result' 输出最终结果
- 这样你可以在自己的系统里,构建 类似 Claude Code 的“可读写文件 / 可用工具”的 AI 助手,而不是只拿到一段文本回复。
Quick Reference:一页速查表里的所有内容
作者最后给了一张“速查表”,把所有常用东西再汇总了一遍。
1. Keyboard Shortcuts(快捷键)
- !command → 立即执行 Bash
- Esc Esc → 回滚会话/代码
- Ctrl + R → 历史反向搜索
- Ctrl + S → Stash 当前 prompt
- Shift + Tab ×2 → 切换 Plan mode
- Alt + P / Option + P → 切换模型
- Ctrl + O → 切换 verbose mode
- Tab / Enter → 接受 prompt suggestion
2. Essential Commands(核心命令)
- /init → 生成 CLAUDE.md
- /context → 查看 context 占用
- /stats → 使用统计
- /usage → 查看配额
- /vim → Vim 模式
- /config → 配置面板
- /hooks → 配置 hooks
- /sandbox → 权限边界
- /export → 导出会话
- /resume → 恢复会话
- /rename → 重命名会话
- /theme → 主题选择
- /terminal-setup → 终端集成设置
3. CLI Flags(命令行参数)
- -p "prompt" → Headless / 打印模式
- --continue → 恢复最后一次会话
- --resume → 弹出会话选择
- --resume name → 按名称恢复
- --teleport id → 从 Web Teleport 会话
- --dangerously-skip-permissions → YOLO mode
收尾:作者的核心观点
“Claude Code 的精髓不是自动化,而是协作哲学。”
- 最好的开发者不是让 AI “替他写代码”,而是让 AI “帮他更好地思考和规划”。
- 像 Plan 模式、Hooks、Memory、Sandbox 等特性,都是为了让你掌控 Claude,而不是依赖它。
- Claude Code 的价值在于——帮助人类保持创造力和掌控感。
最后几段是作者的“方法论总结”:
- Claude Code 的这些功能,本质上都在做一件事:
让人保留“控制权”,而不是把事情全丢给 AI。
- 真正用得好的人不是那些只会打“帮我把这个项目全做了”的用户,而是:
- 知道什么时候用 Plan Mode
- 知道 prompt 要怎么结构化
- 知道什么场景该用 ultrathink
- 知道如何通过 hooks / sandbox 把风险前置
- 他的比喻是:
- AI 是一根杠杆,这些特性帮你找到更稳、更有力的“握法”。
