命令行技巧
34 条实用 Claude Code CLI 技巧,助你成为高效开发者
需要 API Key? 前往注册 →端点与 Base URL →
本页目录
本文整理了 34 条 Claude Code 实用技巧,从基础操作到高级用法,帮助你充分发挥 Claude Code 的能力。
基础操作¶
1. Tab 自动补全文件路径¶
输入 @ 后按 Tab 键可以自动补全文件路径,无需记住完整路径。
2. 使用 @ 精确引用文件¶
> 分析 @src/utils/auth.ts 的安全性
> 对比 @v1/api.js 和 @v2/api.js 的区别
直接引用文件比描述文件位置更准确,AI 不会猜错。
3. 管道输入分析数据¶
git diff | claude "解释这些更改"
cat error.log | claude "分析错误原因"
npm test 2>&1 | claude "分析测试失败原因"
4. 键盘快捷键¶
| 快捷键 | 功能 |
|---|---|
Tab |
文件路径自动补全 |
Esc |
中断当前输出 |
Ctrl+C |
取消当前操作 |
↑ / ↓ |
浏览历史命令 |
Shift+Tab (从 auto 按三次,从 default 按两次) |
进入规划模式 |
Alt+Tab / Option+Tab |
切换思考模式 |
5. 使用 ! 快速执行命令¶
在提示中使用 ! 前缀可以直接执行 shell 命令:
> !git status
> !npm run build
斜杠命令¶
6. /help 查看所有命令¶
> /help
显示所有可用的斜杠命令和快捷键。
7. /clear 清空对话¶
> /clear
开始新任务前清空上下文,避免之前对话干扰。
8. /compact 压缩对话历史¶
> /compact
当上下文过长时使用,压缩历史以节省 token,保持核心信息。
9. /context 查看上下文使用量¶
> /context
显示当前上下文使用百分比。建议在达到 60% 时考虑压缩或开始新会话。
10. /model 切换模型¶
> /model opus
> /model sonnet
-
Opus 5.5:复杂任务、架构设计、疑难问题(当前主力旗舰)
-
Sonnet 5.5:日常编码、快速迭代(性价比高)
-
Haiku 5.5:轻量快速的简单任务
别名(opus / sonnet / haiku)由 Claude Code 解析到最新版本;想固定型号,直接写完整 ID,例如 /model claude-opus-5-5、/model claude-sonnet-5-5、/model claude-haiku-5-5。用 /effort 可以调整思考强度(见 Adaptive Thinking 配置指南)。
11. /memory 编辑项目记忆¶
> /memory
打开 CLAUDE.md 文件进行编辑,定义项目规范和偏好。
12. /init 初始化项目配置¶
> /init
让 Claude 自动分析项目并生成 CLAUDE.md 配置文件。
13. 直接说「提交这些更改」¶
> 提交这些更改
自动分析更改、生成规范的 commit message 并提交。
说明:/commit 不是 Claude Code 内置命令(官方内置命令清单里没有它),只有你自己或插件提供了自定义命令或技能才可用;没有的话,直接用自然语言让 Claude 提交即可。
14. /review 代码审查¶
> /review
对当前更改进行代码审查,检查潜在问题。
15. /resume 恢复会话¶
> /resume
恢复之前的对话会话,继续未完成的工作。
上下文管理¶
截至 2026-10-15,Claude Code 官方文档写明:Opus 4.7 及更新版本、Sonnet 5 及更新版本、Haiku 5.5 默认使用 1M token 的上下文窗口,Opus 4.6 与 Sonnet 4.6 需选 [1m] 变体,否则是 200K。建议一个会话专注于一个任务,并使用 /context 监控使用量、/compact 压缩历史、/clear 开始新会话。
详细的上下文管理策略(含长会话溢出处理)→ 上下文管理
规划模式 (Plan Mode)¶
19. 进入规划模式¶
按 Shift+Tab 切换到规划模式(从默认的 auto 出发按三次,从 default 出发按两次)。Claude 会先分析研究,再制定实施方案,不会直接修改代码。
20. 先规划后执行¶
对于复杂任务,先让 Claude 制定计划:
> 先分析这个功能需求,制定实施方案,不要写代码
计划确认后再让它执行,减少返工。
21. 分步执行复杂任务¶
大任务拆分成小步骤:
> 第一步:分析现有认证系统
> 第二步:设计新的 JWT 方案
> 第三步:实现核心功能
> 第四步:添加测试
子代理 (Subagents)¶
22. 使用 Explore 代理快速搜索¶
Explore 代理专门用于快速搜索代码库,比手动搜索更高效:
> 使用 Explore 代理找到所有处理支付的代码
23. 使用 Plan 代理设计方案¶
Plan 代理专门用于设计实施计划:
> 使用 Plan 代理设计用户权限系统的实现方案
24. 后台代理并行处理¶
可以启动多个后台代理并行处理任务,提升效率。
CLAUDE.md 配置¶
CLAUDE.md 是项目级配置文件,Claude 每次启动自动读取。可用 /init 自动生成,或手动创建。在其中定义代码规范、常用命令、项目架构等信息,省去每次重复说明。
完整配置指南与示例 → CLAUDE.md 配置
Git 工作流¶
28. 智能生成 commit message¶
> 提交这些更改
Claude 会分析所有更改,生成符合规范的 commit message。
29. 创建 PR 描述¶
> 为当前分支创建 PR 描述
自动生成包含变更摘要和测试计划的 PR 描述。
30. 分析 PR 变更¶
gh pr diff 123 | claude "审查这个 PR"
测试与调试¶
31. 让 Claude 写测试¶
> 为 @src/services/UserService.ts 编写单元测试
让 Claude 自己写测试,然后通过测试来验证代码正确性。
32. 分析测试失败¶
npm test 2>&1 | claude "分析失败原因并修复"
33. 调试错误¶
> 分析这个错误:[粘贴错误信息]
> 在 @src/pages/Login.tsx 中排查问题
高级技巧¶
34. 使用截图/图片¶
Claude Code 支持图片理解:
> 查看这个截图 @screenshot.png,分析 UI 问题
效率对比¶
| 场景 | 传统方式 | Claude Code |
|---|---|---|
| 找代码 | grep + 手动翻阅 | @文件 或 Explore 代理 |
| 写测试 | 手写 + 调试 | /review + 自动生成 |
| Git 提交 | 想 message + 手写 | 说「提交这些更改」 |
| 代码审查 | 逐行查看 | /review 智能分析 |
| 理解代码 | 读文档 + 读代码 | 直接问 Claude |
最佳实践总结¶
-
明确意图:清楚描述需求,包括约束条件
-
善用引用:用
@指定文件,避免猜测 -
分步执行:复杂任务拆分成小步骤
-
及时中断:输出不对立即按
Esc -
保持上下文:一个会话专注一个任务
-
定期压缩:上下文过长时使用
/compact -
先规划后执行:复杂任务先制定计划
-
让 AI 测试:让 Claude 写测试验证自己的代码
下一步¶
-
学习 工作流技巧 掌握高效开发流程
-
了解 上下文管理 应对长会话和 token 溢出
-
了解 CLAUDE.md 配置 为项目定制 Claude 行为
-
探索 Codex 集成 使用另一个 AI 工具
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models