Claude Code 常用操作与最佳实践
什么是 Claude Code
Claude Code 是 Anthropic 推出的终端原生 AI 编程助手,直接在命令行中运行,深度理解整个代码库上下文,帮你完成编码、调试、代码审查、Git 操作等工作。
常用 Slash 命令
Claude Code 提供了一系列内置命令,输入 / 即可查看完整列表。以下是最常用的:
| 命令 | 作用 |
|---|---|
/help | 查看帮助 |
/clear | 清除当前会话上下文 |
/compact | 压缩上下文,保留关键信息 |
/context | 查看当前上下文占用情况 |
/cost | 查看当前会话费用 |
/init | 为项目生成 CLAUDE.md 文件 |
/doctor | 诊断 Claude Code 安装和环境问题 |
/config | 查看和修改设置 |
/status | 显示当前项目和会话状态 |
/pr-comments | 查看当前 PR 的评论 |
/review-pr | 审查一个 PR |
/terminal-setup | 配置终端 Shfit+Enter 快捷键 |
/upgrade | 升级 Claude Code 到最新版本 |
/install-github-app | 安装 GitHub App(用于 PR 审查等) |
快捷键
| 快捷键 | 作用 |
|---|---|
Enter | 提交消息 |
Shift + Enter | 换行(需在用 /terminal-setup 绑定后) |
Esc | 取消当前操作 |
Ctrl + C | 强制中断 |
Ctrl + O | 显示/切换模型选择面板 |
↑ / ↓ | 切换历史命令 |
Ctrl + R | 搜索历史命令 |
其中 Ctrl + O 切换模型最常用——快速任务用 Haiku,复杂任务切到 Opus。
核心技巧与最佳实践
1. CLAUDE.md —— 项目级"记忆"
在项目根目录创建 CLAUDE.md,记录 Claude Code 需要知道的上下文:项目架构、常用命令、编码规范、注意事项。每次对话 Claude Code 会自动读取这个文件。
好的 CLAUDE.md 应该包含:
- 项目概述和架构说明
- 常用命令(构建、测试、部署)
- 目录结构和命名约定
- 自定义模板或修改说明
- 注意事项和陷阱
2. 一次性任务用 -p 模式
简单的一次性操作不需要进入交互模式:
# 单次执行
claude -p "帮我把所有 console.log 替换成 logger.debug"
# 配合管道
cat error.log | claude -p "分析这个错误日志,找出根本原因"
# 输出 JSON
claude -p "列出所有导出了函数的文件" --output-format json
3. 继续对话用 -c
# 继续上次的对话
claude -c
# 恢复到指定会话
claude --resume <session-id>
4. /compact —— 长对话的救命功能
对话长了之后,上下文会占用大量 token,响应变慢、费用变高。适时用 /compact 压缩上下文,Claude 会自动总结关键信息。
5. 选择合适的模型
| 模型 | 适用场景 |
|---|---|
| Haiku | 简单问答、快速搜索、小改动 |
| Sonnet | 常规编码、代码审查、中等复杂度任务 |
| Opus | 复杂架构设计、深度调试、重重构 |
按 Ctrl + O 随时切换。日常开发用 Sonnet 最均衡,遇到棘手问题切到 Opus。
6. 善用权限模式
# 可信任的项目里跳过重复确认
claude --permission-mode accept-edits
# 完全跳过所有确认(谨慎使用)
claude --dangerously-skip-permissions
或者在 settings.json 中配置,让某些目录下的操作自动授权。
7. 费用控制
# 设置单次最大花费
claude -p "审查整个项目" --max-budget-usd 5
8. MCP 扩展
Claude Code 支持 MCP(Model Context Protocol),可以扩展 Claude 的能力——比如连接数据库、操作浏览器、调用外部 API 等。在 settings.json 中配置 MCP 服务器即可。
9. 版本更新
Claude Code 更新频繁,定期升级:
# 查看当前版本
claude --version
# 升级
/upgrade
我的工作流
- 启动项目时:
claude进入交互模式,Claude 自动读取CLAUDE.md - 写代码时:描述需求,Claude 生成代码,我审查并确认
- 审查代码时:
/review-pr <PR 编号>或claude -p "审查这次改动" - 遇到 Bug:把错误信息贴进去,Claude 定位问题并修复
- 长对话后:
/compact保持上下文清爽 - 收尾:先
/cost看花费,再/clear
进阶玩法
Custom Slash Commands
在 .claude/commands/ 目录下创建自定义命令文件,定义自己的 / 命令。
Hooks
在 settings.json 中配置 hooks,实现在特定事件时自动触发操作——比如每次答复前自动跑 lint、每次保存文件时自动格式化。
Skills
/skill-creator 可以创建自定义 skill,把常用操作封装成可复用的能力模块。
总结
Claude Code 的核心优势在于理解整个代码库上下文,而不只是单个文件。用好了,它能从"代码补全工具"升级为"真正的编程搭档"。几个最重要的习惯:
- 写好 CLAUDE.md —— 这是投入产出比最高的操作
- 适时
/compact—— 避免上下文膨胀 - 选对模型 —— 别让 Haiku 干 Opus 的活,也别用 Opus 做简单搜索
- 配置权限 —— 可信任的仓库减少确认提示,专注干活