最近公司给免费开放了 Claude Code 的工具,我用了一段时间简单梳理一下常见的用法和一些技巧,方便以后回顾速查。

工作模式

Claude Code 中有 4 种工作模式(详见 根据任务选对模式):

模式特点适用场景
Agent Mode自主探索、编辑多文件需求明确、已有完善的 Rules/Skills
Ask Mode只读,不修改代码了解代码架构、头脑风暴
Plan Mode先生成详细计划需求不清晰、涉及多模块、需要讨论
Debug Mode插入埋点、分析根因调试 Bug、排查问题

切换方式:对话时 Claude 会根据任务建议切换,或在设置中手动选择。

核心命令

对话管理

/compact  # 压缩对话历史,保存 summary,节约 token
/clear    # 清空对话,开始新任务时使用
/export   # 导出当前对话记录

使用场景:长对话超过 context 上限时用 /compact;切换任务时用 /clear;需要分享或备份时用 /export

思考控制

/think         # 标准思考
/think hard    # 深度思考
/think harder  # 更深度思考
/ultra think   # 最深度思考(用于复杂问题)

思考时间越长,token 消耗越多,适合架构设计、算法优化等复杂场景。简单任务不需要开启。

执行与记忆

!command      # 执行 shell 命令,AI 会记录执行结果
#text         # 记忆模式,将信息添加到上下文中

示例

  • !git status - AI 执行后会记住当前 git 状态
  • #这个项目使用 PostgreSQL 15 - 后续对话 AI 会记住这个信息

IDE 集成

/ide          # 打通编辑器和 Claude,可以直接在 IDE 中使用
claude -p     # 临时对话模式,不保存历史记录

Sub-Agent 系统

Sub-agent 用于隔离上下文、并行处理任务(详见 SubAgent:上下文隔离是关键)。

/agents       # 查看当前所有 sub-agent
/resume       # 恢复之前的对话历史(只回退对话,不改代码)

Rules、Commands、Skills

这三个组件是让 AI 持续记住项目规范的核心(详见 让 AI 记住你的规矩)。

参考文档:

Plugin 系统

Plugin 是把 Rules、Commands、SubAgents、Skills、MCP 打包在一起的功能包,用于跨项目复用或团队共享。

/plugin install <name>    # 安装 plugin
/plugin list              # 查看已安装的 plugins
/plugin toggle <name>     # 开关 plugin

使用场景

  • 团队标准化:统一代码规范、工作流
  • 跨项目复用:在多个项目中使用相同配置
  • 社区分发:通过 Plugin Marketplace 分享给开源社区

Plugin vs 项目配置:项目配置(.claude/)只在单个项目生效;Plugin 可跨项目、团队共享,有命名空间避免冲突(如 /plugin-name:skill)。

参考:Create plugins 文档

MCP 服务管理

MCP (Model Context Protocol) 是 Claude 连接外部工具的协议。

claude mcp add <service>     # 添加 MCP 服务
claude mcp remove <service>  # 移除 MCP 服务
claude mcp list              # 查看已安装的服务

常用 MCP 服务

  • @modelcontextprotocol/server-filesystem - 文件系统访问
  • @modelcontextprotocol/server-github - GitHub 集成
  • @modelcontextprotocol/server-postgres - 数据库查询
  • @modelcontextprotocol/server-brave-search - 网页搜索

Hooks 机制

Hooks 是在特定时机自动执行的脚本或提示词,用于自动化工作流。

常见 Hook 事件

  • SessionStart - 会话开始时
  • PreToolUse - 工具使用前(可用于拦截危险操作)
  • PostToolUse - 工具使用后(可用于自动格式化)
  • TaskCompleted - 任务完成时

三种 Hook 类型

  • Command Hook:运行 shell 脚本(格式化、lint、安全检查)
  • Prompt Hook:让 LLM 做决策(如”是否允许删除文件?”)
  • Agent Hook:启动 SubAgent 执行验证任务

配置位置.claude/settings.json(项目级)或 ~/.claude/settings.json(用户级)

参考:Hooks 文档

快捷键

运行 /keybindings 打开快捷键配置文件(~/.claude/keybindings.json)。

常用快捷键

  • Enter - 发送消息
  • Ctrl+G - 在外部编辑器打开
  • Cmd+T - 开关扩展思考
  • Ctrl+R - 搜索命令历史

参考:Keybindings 文档

切换模型

Claude很好,但是它有问题是有点贵。有些任务我们想用便宜的模型。默认使用 Claude Sonnet,可通过以下方式切换:

1. Claude Code Router

内置路由器,根据任务自动选择模型:

  • 简单任务 → Haiku(快速、便宜)
  • 复杂任务 → Sonnet(平衡)
  • 极难任务 → Opus(最强)

在 Claude Code 设置中启用 Code Router

2. OpenRouter

通过 OpenRouter 使用其他模型(GPT-4、Gemini 等):

# 在 Claude Code 设置中配置 API Key
OPENROUTER_API_KEY=xxx

选择模型:Settings → Models → OpenRouter → 选择模型

一些使用技巧

1. Context 管理

  • 使用 @file 引用文件而不是粘贴代码
  • 定期 /compact 避免 token 超限
  • 将规则写入 AGENTS.md 文件,每次对话自动加载

2. Prompt 技巧

  • 具体化:不要说”优化代码”,而是”减少 SQL 查询次数”
  • 示例驱动:提供期望的输入输出示例
  • 分步骤:复杂任务拆成多步,逐步验证

更多 Prompt 技巧,详见 prompt-engineering

3. 避坑指南

  • ❌ 不要一次让 AI 重写整个文件(容易丢失细节)
  • ❌ 不要过度依赖 Auto Accept(关键逻辑需要 review)
  • ✅ 让 AI 生成初稿,人工精修细节
  • ✅ 使用 Plan Mode 讨论架构,确定后再让 AI 实现

更多实战建议,详见 几个实战建议