--- title: Claude Code 使用指南：配置、工作流与进阶技巧 description: 整理自 Anthropic 官方工程团队技术文档并融合实战经验，系统梳理 Claude Code 的配置、能力扩展、高效工作流、进阶技巧与实战心法。 category: AI 编程实战 head: - - meta - name: keywords content: Claude Code,AI编程,CLAUDE.md,MCP,Skills,Sub-Agent,Agentic Coding,AI辅助开发 --- # Claude Code 使用指南 大家好，我是 Guide。前面分享过 [IDEA 搭配 Qoder 插件的实战](./idea-qoder-plugin.md)、[Trae 接入大模型的实战](./trae-m2.7.md) 和 [Claude Code 接入第三方模型的实战](./cc-glm5.1.md)，这篇换个角度，聊聊 **Claude Code 的使用方法与技巧**。 这篇指南整理自 [Anthropic 官方工程团队的技术文档](https://www.anthropic.com/engineering/claude-code-best-practices)，并融合了我个人的实战使用经验。本文基于 Claude Code v2.1.x 撰写（笔者当前版本 v2.1.114），部分功能可能随版本更新而变化。 Claude Code 是 Anthropic 推出的命令行工具，专为 **Agentic Coding（代理式编程）** 而生。它和传统的代码补全插件（如 Copilot）不同，能自己读代码、跑命令、看报错、再改，形成一个完整的”理解意图 → 规划 → 执行 → 修复”闭环。 它的设计哲学是**“刻意低级且不强加观点”**——不强制你遵循特定流程，只提供最原始的模型访问权限，让你像搭积木一样构建自己的开发流。 这篇文章从**配置、能力扩展、工作流、进阶技巧**和**实战心法**五个方面，梳理 Claude Code 的使用技巧。看完你会搞清楚： 1. ⭐ **`CLAUDE.md` 怎么写、放哪里**：四级作用域、模块化管理和动态更新的最佳实践 2. ⭐ **如何扩展 Claude 的能力边界**：MCP、Skills、Sub-Agent、插件系统分别解决什么问题？ 3. ⭐ **哪些工作流模式最实用**：探索-规划-执行、TDD、多实例协作各自的适用场景 4. ⭐ **上下文管理的核心心法**：`/compact`、`/clear`、`/fork`、交接文档分别在什么时候用 5. ⭐ **如何让 Claude 自己验证自己的工作**：这是单一最高收益的改变 Claude 系列是目前最强的编程模型，但国内使用门槛和成本较高，还可能面临封号。国内的话，一般是使用 GLM 和 MiniMax 作为替代。GLM、MiniMax 和 Kimi 都是不错的选择，但要做好心理预期，编程表现上和 Claude 还有差距。 ## 一、基础配置：自定义你的开发环境 ### ⭐️ 1. 灵魂文件：`CLAUDE.md` 一句话：**`CLAUDE.md` 是 Claude Code 的“项目说明书”，也是所有技巧中投入产出比最高的一项配置。** Claude 在启动时会自动读取该文件，将其中内容注入系统提示，成为它思考的底层背景。你往里面写的每一条规则，都在塑造 Claude 的行为边界。 **核心内容**：常用 Bash 命令、核心工具函数、代码风格指南（如：使用 ES Modules 而非 CommonJS）、测试指令、分支命名规范等。 **放置策略（四级作用域）**： | 作用域 | 文件位置 | 用途 | | ---------------------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------- | | **企业级（Managed Policy）** | macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`，Linux: `/etc/claude-code/CLAUDE.md` | 组织级安全、合规要求，由 IT 管理员配置 | | **项目级** | `./CLAUDE.md` 或 `./.claude/CLAUDE.md` | 团队共享规范，提交至 Git | | **用户级** | `~/.claude/CLAUDE.md` | 个人偏好，对所有项目生效 | | **本地级** | `./CLAUDE.local.md` | 个人在本项目中的特定配置（加入 `.gitignore`） | 所有层级的 `CLAUDE.md` 均会加载进上下文（**拼接而非替换**），当规则冲突时，更具体作用域的规则优先生效。子目录下的 `CLAUDE.md` 会在 Claude 访问该目录下的文件时按需加载，不会一次性全部注入上下文。工作目录上方的父目录中的 `CLAUDE.md` 则在启动时全部加载，这对 monorepo 场景特别有用，`root/CLAUDE.md` 和 `root/foo/CLAUDE.md` 会同时生效。 > **注意**：企业级（Managed Policy）是唯一不遵循“更具体优先”规则的层级，它**不能被任何个人设置排除**（`claudeMdExcludes` 对其无效），确保组织级指令始终生效。 **初始化**：在项目根目录运行 `/init`，Claude 会自动分析你的代码库并生成一份包含构建命令、测试说明和项目约定的初始 `CLAUDE.md`。如果文件已存在，它会建议改进而非覆盖。 **动态更新技巧**： - 在对话中按 `#` 键，给 Claude 一个指令，让它自动把当前的上下文总结并写入 `CLAUDE.md`。 - 更推荐的做法：每次纠正 Claude 的错误后，追加一句“更新 CLAUDE.md，确保下次不再犯同样的错误”。随着时间推移，`CLAUDE.md` 会变成一个能不断进化的规则系统。 - 也可以运行 `/memory` 命令直接在编辑器中打开并编辑。 **保持精简**：官方建议单个 `CLAUDE.md` 文件控制在 **200 行以内**，超过此阈值会显著消耗上下文并降低规则遵守率。每一条规则都应该对应一个 Claude 曾经犯过的真实错误，如果某条指令删掉后 Claude 依然能正确完成，就果断删掉。文件太长时，可以考虑拆分到 `.claude/rules/` 或用 `@path` 引用。 对于必须每次都执行、零例外的操作（如代码格式化），优先考虑用 Hooks 来实现，而不是写在 `CLAUDE.md` 里。两者的本质区别：CLAUDE.md 中的规则是**建议性**的（Claude 会尽力遵守但不保证），而 Hooks 是**确定性**的（脚本在特定节点自动执行，零例外）。判断标准：问自己“这条规则被违反一次后果是什么”，后果严重的用 Hooks。 > **精简判断**：问自己“没这行规则 Claude 会犯什么错”。答不上来就删掉。 **模块化管理**：如果项目比较复杂，可以在根目录的 `CLAUDE.md` 中用 `@` 导入语法引入其他文件。根目录放项目概览和快速启动命令，各子模块的架构和开发规范分别放在各自的 `.claude/CLAUDE.md` 中： ``` ## Project Structure my-project/ ├── backend/ # Spring Boot backend ├── frontend/ # Vue 3 frontend └── admin/ # Admin console ## Module Documentation - **Backend**: See `@backend/.claude/CLAUDE.md` for architecture and conventions - **Frontend**: See `@frontend/.claude/CLAUDE.md` for component structure - **Admin**: See `@admin/.claude/CLAUDE.md` for setup and state management ``` ### 2. 权限与工具管理 默认情况下，Claude 执行敏感操作（如写文件、Git 提交）需要逐一授权。 - **白名单化**：使用 `/permissions` 命令或编辑 `.claude/settings.json`，将 `Edit`、`git commit` 等高频且你信任的操作加入白名单，大幅减少交互中断，实现“沉浸式编程”。 - **GitHub 集成**：强烈建议安装 `gh` CLI。Claude 能够直接调用它来创建 PR、读取 Issue 或处理 Code Review 评论。 ## 二、能力扩展：MCP、Skills 与插件生态 Claude Code 不只是一个对话框，它继承了你的整个 Shell 环境。光有对话能力不够，得给它装上“工具箱”。 ### ⭐️ 1. 模型上下文协议 (MCP) MCP 是扩展 Claude 能力的主要通道，相当于给 Claude 装上了“USB 接口”。通过连接 MCP 服务器，你可以让 Claude 具备： - **网页浏览**（如通过 Puppeteer）。 - **数据库查询**（如连接 PostgreSQL 或 MySQL）。 - **第三方 API 调用**（如 Sentry、Slack）。 - **项目级共享**：将 `.mcp.json` 检入仓库，让团队成员开箱即用相同的工具集。 MCP 服务器支持三种配置范围： | 范围 | 存储位置 | 适用场景 | | -------- | ------------------------------ | ---------------------------------- | | **本地** | `~/.claude.json`（项目路径下） | 个人实验配置、包含敏感凭据的服务器 | | **项目** | 项目根目录的 `.mcp.json` | 团队共享，可提交至版本控制 | | **用户** | `~/.claude.json` | 跨项目复用的个人工具 | 安装 MCP 服务器的推荐方式是使用 HTTP 传输： ```bash # 连接远程 MCP 服务器 claude mcp add --transport http # 带认证头的示例 claude mcp add --transport http notion https://mcp.notion.com/mcp \ --header "Authorization: Bearer your-token" ``` ### 2. 自定义斜杠命令 对于重复性的复杂任务，可以在 `.claude/commands` 目录中创建 Markdown 模板，将其固化为命令。 - **示例**：创建一个 `/fix-issue $ARGUMENTS` 命令。 - **效果**：输入 `/fix-issue 1024`，Claude 自动执行：`查看 Issue → 搜索相关代码 → 编写修复 → 运行测试 → 提交 PR` 的全套流程。 ### ⭐️ 3. Skills：将重复劳动固化为技能 如果一件事你一天做了两次，就值得把它变成一个 Skill。 一句话：**Skill 是保存下来的工作流，启动时只加载元数据（名称和描述，约 100 个 Token），只有当任务匹配时才会读取完整指令。** 这种“延迟加载”的设计保证了能力可用，又不会挤占上下文窗口。 - **手动调用**：在对话框中输入 `/skill-name`。 - **自动发现**：Claude 根据 Skill 的描述自动匹配当前任务并激活。 Skill 存放在 `~/.claude/skills/`（用户级）或 `.claude/skills/`（项目级）。一些优秀的社区 Skills： - **[Superpowers](https://github.com/obra/superpowers)**：TDD + Code Review + 自动计划，把软件工程最佳实践封装为 AI 可执行的技能（推荐首装）。 - **[Everything Claude Code](https://github.com/affaan-m/everything-claude-code)**：Anthropic 黑客松冠军配置，多 Agent 分工协作，解决上下文腐化问题。 **何时用 Skills vs CLAUDE.md**：简单来说，CLAUDE.md 是“每次都需要的全局上下文”，Skills 是“按需加载的任务指令”。如果一条规则只在特定场景下才需要（如“审查 API 代码时遵循这些规范”），放到 Skills 或 `.claude/rules/` 里；如果每次会话都需要 Claude 知道（如“项目使用 ES Modules”），放 CLAUDE.md。 ### ⭐️ 4. Sub-Agent：让主对话保持干净 当 Claude 需要深度调查一个问题时，它会读很多文件，大量消耗上下文窗口。Sub-Agent（子代理）就是解决这个问题的：让一个独立的 Claude 实例去做调查，它有自己的独立上下文，完成后只把结论汇报给主会话。 Claude Code 内置了几种子代理： | 子代理 | 模型 | 用途 | | ------------------- | ------------------- | ------------------------------ | | **Explore** | Haiku（快速低延迟） | 文件发现、代码搜索、代码库探索 | | **Plan** | 继承自主对话 | 规划阶段的代码库研究 | | **General-purpose** | 继承自主对话 | 复杂研究、多步骤操作、代码修改 | 你也可以在 `.claude/agents/`（项目级）或 `~/.claude/agents/`（用户级）中创建自定义子代理，指定专属系统提示、工具权限和使用的模型。 典型用法： - **隔离高消耗操作**：`使用子代理运行测试套件，仅报告失败的测试及其错误消息。` - **并行研究**：`使用单独的子代理并行研究身份验证、数据库和 API 模块。` - **链式委派**：`使用 code-reviewer 子代理查找性能问题，然后使用 optimizer 子代理修复它们。` ### 5. 插件系统（Plug-In） 插件是 Claude Code 的“应用”——一个插件可以打包 Skills、MCP 服务器、子代理、钩子和自定义命令，一键安装、一键分享。 安装方式： ```bash # 注册插件市场 /plugin marketplace add / # 安装插件 /plugin install @ ``` 也可以用 `--plugin-dir` 在开发阶段本地测试插件。 ## 三、实战模式：高效工作流 搞清楚了基础配置和能力扩展，接下来就是怎么把这些能力串起来，形成真正高效的工作流。 ### ⭐️ 1. 探索-规划-执行 适用于需求模糊或复杂的场景，也是我个人最推荐的工作流。 - **Explore**：让 Claude 阅读文件、日志或 URL，明确告诉它“先阅读，暂时不要写代码”。 - **Plan**：进入计划模式（Plan Mode），让 Claude 输出详细的实施计划：哪些文件要改、改动顺序、可能踩的坑。复杂任务严禁直接动手。 - **Code**：你确认计划无误后，再让它动手实现。 - **Verify**：让它自己运行测试或检查代码。 **进阶做法**：一个 Claude 写计划，再起一个 Claude 以高级工程师的视角审这个计划。计划过了才开始写代码。先花 10 分钟在计划上，省下后面 2 小时的返工。 > 先想清楚再动手，永远是最高效的。 ### 2. 测试驱动开发 (TDD) AI 编程中最稳健、幻觉最少的模式。 - **写测试**：让 Claude 基于需求编写测试用例（此时不写实现代码）。 - **红灯**：运行测试，确认失败（确保测试有效）。 - **绿灯**：让 Claude 编写代码，直到测试通过。 - **重构**：在测试的保护下，让 Claude 优化代码结构。 也可以用并行 Session 来做 TDD：Session A 先写测试，Session B 再写让测试通过的代码。 ### 3. 视觉迭代 (Visual Iteration) 适用于前端开发。 1. **投喂**：截图、拖拽设计图给 Claude。 2. **实现**：让 Claude 写代码。 3. **反馈**：截图运行结果发回给 Claude，让它对比差异并修正。 更进阶的做法：让 Claude 实现设计稿后，自动截图对比原图，列出差异并自行修复——形成一个自动纠错回路。 ### 4. 代码库问答 新入职或接手陌生代码库时的神器。Claude 会自动搜索、读取文件并总结答案，大大降低认知负荷。 - “日志系统是怎么工作的？” - "这个 `Async` 函数在第 134 行是做什么的？" - “用户登录的完整流程是什么，从第一个请求到 session 建立？” 这些是你原本要问老员工的问题，Claude 答得一样好，还不嫌你问。 ### 5. Git/GitHub 自动化 让 Claude 成为你的 Release Manager。 - “分析刚才的修改，写一个 Commit Message。” - “查看 Issue #123，分析原因并修复，然后提一个 PR。” - “解决这个 Rebase 冲突。” - **PR 协作**：在 GitHub PR 评论中 `@claude` 可以触发 Claude Code 在 CI 中响应，执行代码审查、修复建议等任务。 ### ⭐️ 6. 多实例协作 (Multi-Claude) 不要让一个 Claude 处理所有事情——**这是效率最大的杠杆之一**。核心原则是"不要等 AI，要让 AI 等你"：把耗时任务推向后台，你只需以"首席架构师"视角做决策。 - **AB 角色**：一个写代码，另一个在独立终端中负责审查或写测试。 - **Git Worktrees**：在不同的目录中检出不同分支，同时开启多个 Claude 实例处理不相关的 Feature，互不干扰。设置 Shell 别名（`za`、`zb`、`zc`）快速切换。 - **`/batch` 命令**：输入一个大任务，Claude 会自动拆解为多个独立 Unit，为每个创建独立 Worktree，并行处理后合并。示例： ``` /batch 1、移除自选股界面，优化提示词管理 2、自选股提取组件、K线展示单独提取组件 3、历史记录设计优化 ``` ### 7. `/simplify`：三 Agent 并行代码审查 这是一个容易被忽略但用一次就离不开的命令。`/simplify` 会并行启动三个审查 Agent，各自带着不同的视角去读同一份代码： - **Code Reuse Agent**：看有没有重复造轮子——手写的工具方法是不是项目里已经有了 - **Code Quality Agent**：看设计有没有问题——硬编码、该拆没拆的类、冗余逻辑 - **Efficiency Agent**：看性能有没有隐患——循环里重复创建对象、不必要的并发容器、该用缓存的结果每次重新算 不带参数时审查 `git diff` 的增量变更（工作区干净时审查最近一次 commit）；也可以指定具体类名做全量审查： ```bash /simplify # 审查当前变更 /simplify thread safety # 指定关注方向 /simplify MarketDataService # 审查指定类 ``` 它最大的价值在于能发现需要**领域知识**才能识别的问题——Spring 代理导致的 `@Transactional` 失效、MyBatis 的批处理行为、Redis 分布式锁的边界条件。这些是 SonarQbe 之类的规则匹配工具抓不到的。 不过它做不了全项目全量扫描，也不关心代码风格（那是 formatter 的活）。架构级重构它只会建议，不会主动执行。 > 一句话：**提交 PR 前跑一遍 `/simplify`，成本很低但收益可能很高。** ### 8. `/loop`：自主迭代和定时调度 Claude Code 创始人 Boris Cherny 多次公开推荐这个命令。它解决两类烦人的事： **定时调度（Cron 模式）**——告诉它干什么、隔多久干一次，到点自己跑： ```bash /loop 30m /review # 每 30 分钟跑一次代码审查 /loop 1h "跑一遍单元测试，看看有没有失败的" # 每小时检查测试 /loop 5m "检查 GitHub 上开放的 PR 状态" # 每 5 分钟看 PR 动态 ``` **自主迭代（Agentic Loop）**——给它一个目标，它自己规划、执行、验证、修正，循环往复直到完成。普通模式下 Claude 写完代码就交给你了，报错你得自己贴回去；`/loop` 模式下它自己读报错、自己改、自己重跑，不用你盯着： ```bash /loop "修复 auth 模块里所有失败的单元测试，直到全部通过" /loop "把 src/legacy 下所有组件迁移到 Tailwind CSS，确保页面渲染正常" ``` 需要注意：`/loop` 是比较烧 Token 的用法，指令尽量具体、完成标准要明确。循环任务创建 7 天后自动过期，且只在当前会话有效，关掉终端就没了。建议在指令里加上限（如“最多尝试 10 次”），避免无限循环。 > 一个高效的组合工作流：`/loop` 自动完成任务 → `/simplify` 做代码清理 → `/review` 做安全审查。三步走下来基本不用你插手。 ### 9. 跨端同步（Teleport） 在终端写累了？`--teleport` 功能让你把网页版 Claude Code 的会话一键拉回本地终端，包括完整的对话历史和分支状态。在终端里运行 `claude --teleport` 即可看到你的网页会话列表，选择后自动拉取远程分支并恢复上下文。反过来，在会话中输入 `/teleport`（或 `/tp`）也能跳转到网页端继续。 ## 四、进阶技巧：优化与自动化 基础配置和工作流都搞定了，接下来是一些能进一步提升效率的进阶技巧。 ### 1. 无头模式（Non-interactive Mode） 将 Claude 集成到脚本或 CI/CD 中。 - **使用**：`claude -p "prompt" --output-format stream-json`。官方文档现在称其为“非交互模式”（以前叫 headless mode），但功能不变。 - **场景**：自动 Issue 分类、代码风格检查、大规模数据迁移脚本生成。 - **加 `--bare` 跳过初始化**：如果不需要 Hooks、Skills、MCP 等自动发现，加 `--bare` 可以显著加快启动速度。 ### ⭐️ 2. 让 Claude 自己验证自己的工作 **这是单一最高收益的改变。** 不要只说“写一个邮件校验函数”，而是说： ``` 写一个验证邮箱的函数。测试用例：hello@gmail.com 应该通过， hello@ 应该失败，@domain.com 应该失败。写完后跑一遍测试告诉我结果。 ``` 有了具体的验收标准，Claude 就能自主检查输出，省去你一大半的人工审查。 更高阶的做法：让 Claude 给自己的答案打分——“根据预设的成功标准给你的输出评分，列出不足之处。” > 有了验收标准，Claude 才从“我觉得没问题”变成“测试证明没问题”。 ### 3. 提示词的反直觉技巧 **① 让 Claude 审你** 在提交代码之前：“用最挑剔的方式质问这些改动，直到我通过你的测试才能开 PR。”角色倒过来，Claude 成了 Reviewer。 **② 让 Claude 重写一个更优雅的版本** Claude 第一次的方案往往取了个捷径。解决完之后说：“你现在知道所有背景了。把这个方案推翻重来，给我一个优雅的实现。”通常能拿到比第一次更好的答案。 **③ 让 Claude 证明** 别只看测试绿了就信：“证明给我看这个改动有效。把 main 分支和我的 feature 分支的行为差异展示出来。” ### 4. Bug 修复：直接扔原始数据 修 Bug 的最佳姿势不是把 bug 描述成文字让 Claude 猜，而是直接把原始数据扔给它，说"fix"。给 Claude 真实的信息（错误日志、Slack 线程、Docker 输出），而不是你对这些信息的描述。前者让 Claude 可以自主追踪，后者让 Claude 在你的理解框架里猜。 ### 5. 清单与草稿板 对于超长任务（如重构 100 个文件）： - 让 Claude 先生成一个 Markdown Checklist。 - 每完成一项，让它勾选一项。这能有效防止上下文丢失导致的“忘了自己在干嘛”。 ### ⭐️ 6. 路线纠偏与上下文管理 上下文窗口是你最贵的资源，这部分讲的是怎么把这块白板用得更高效。 - **及时中断**：按 `Esc` 键中断 Claude 的错误尝试，保留上下文并重定向。一旦它开始偏离轨道，立即停止。 - **历史回溯**：双击 `Esc` 打开检查点菜单，可以回滚代码、对话或两者兼回。存档点甚至在你关闭终端后依然保留。 - **`/compact`**：软重置。将对话历史压缩为结构化摘要，保留关键信息（你的意图、已修改的文件、错误和修复方案、待办任务），同时重新从磁盘加载 `CLAUDE.md` 和 Auto Memory。适用于上下文快满但还想继续当前任务的场景。 - **`/clear`**：硬重置。彻底清空上下文，从零开始。适用于话题已经飘到五个方向、或者纠正了两次同一个错误 Claude 还是不对的时候——不要纠正第三次了，清掉上下文，结合学到的经验写一个更精准的起始 prompt，重头开始。 - **`/fork`**：对话分支。在当前会话中输入 `/fork`，会创建一个新的分支对话，你可以在新分支里自由探索不同方案，而不影响原始会话的上下文。适合“我想试试另一种实现方式”的场景。 - **交接文档（Handoff Document）**：在 `/clear` 之前，让 Claude 把当前进度写入一个 `HANDOFF.md` 文件，记录做了什么、还差什么、踩了哪些坑。清空上下文后，新会话的第一句话就是“阅读 HANDOFF.md，继续之前的工作”。这比从零开始写 prompt 高效得多。 > **核心原则**：同一个问题纠正了两次还没改对，就不要再纠正第三次了。清掉上下文，写一个更好的 prompt 重新开始。上下文被污染后，继续纠正等于白费。 ### 7. 后台静默验证 配置 `Stop` 钩子，让 Claude 在完成任务后自动运行测试或格式化工具，不需要你手动检查。Stop 钩子在主代理完成响应时触发，还可以通过返回 `decision: "block"` 来阻止 Claude 提前结束，强制它验证完再收工。也可以配置 `PostToolUse` 钩子，让 Claude 在每次工具调用后自动运行格式化工具，解决 CI 因代码格式报错的低级问题。 ### 8. 快捷键与效率技巧 **输入框快捷键：** | 快捷键 | 功能 | | ----------------------- | ---------------------------------------- | | `Ctrl + A` / `Ctrl + E` | 光标跳到行首 / 行尾 | | `Ctrl + W` | 删除前一个单词 | | `Ctrl + U` / `Ctrl + K` | 删除光标前 / 后的所有内容 | | `\` + `Enter` | 多行输入（适合写长提示词） | | `Ctrl + G` | 打开外部编辑器编写提示词，写完保存即提交 | **运行时快捷键：** | 快捷键 | 功能 | | ----------- | ---------------------------- | | `Esc` | 中断当前操作 | | `Esc` `Esc` | 打开检查点菜单 | | `Ctrl + B` | 将当前正在运行的操作移到后台 | **实用命令：** - **`/copy`**：快速复制 Claude 最后一次的输出到剪贴板，省去手动选择复制。 - **终端别名**：在 Shell 配置文件中设置别名可以大幅减少输入量。推荐配置：`alias c='claude'`、`alias cr='claude --resume'`（恢复上次会话）、`alias cn='claude --new'`（新会话）。 - **粘贴技巧**：遇到 Claude 无法直接访问的内容（如截图、加密文档片段），直接粘贴到输入框即可，Claude 支持多模态输入。 ### 9. 精简工具加载 如果你安装了很多 MCP 服务器，启动时会拖慢速度。在 `.claude/settings.json` 中设置 `"ENABLE_TOOL_SEARCH": true`，Claude 不会在启动时加载所有工具描述，而是按需搜索和加载——只加载与当前任务相关的工具。工具多了之后，这个优化能显著减少 Token 消耗和启动时间。 ### 10. 模型堆叠 在打开 Claude Code 之前，先用其他大模型（如 Gemini、GPT）规划项目、生成高级提示词。这个策略还能节省计划模式的 Token。 ## 五、实战心法：与 AI 协作的经验 除了工具本身，**如何与 AI 沟通**决定了上限。这部分是我在实战中反复踩坑后总结出来的经验，不一定每条都适用于你，但每条背后都有至少一次真实的翻车经历。 ### 1. 说英文 - **原因：** 虽然 Claude 中文很好，但编程语境下英文更具确定性。例如，"Modal" 比“弹窗”更能让 AI 联想到具体的组件库实现。 - **收益：** 显著减少幻觉，代码逻辑更准确。这也是强迫自己二次思考需求的过程。 ### 2. 限制工作范围 - **原则**：不要试图“一句话生成全栈应用”。 - **做法**：明确指定修改范围（如"仅限 `/src/api` 目录“）。按照”数据库 -> 后端逻辑 -> 前端 UI"的顺序拆解任务。 - **避免无边界调查**：让 Claude“调查”某事但没有限定范围，它会读取数百个文件填满上下文。解决办法：缩小调查范围，或明确说“用子代理来调查”。 ### 3. 信息过载优于信息匮乏 - **反直觉：** 提示词不要太短。 - **做法：** 即使是简单修改，也要告诉它： - 文件位置在哪里？ - 修改的最终目的是什么？（比如“为了匹配新的设计风格”） - 参考组件是什么？ - **原理：** 大模型本质是概率预测。提供的关联信息（Context）越多，它的联想收敛得越窄，结果越精准。 ### 4. 提供“金标准”范例 - **原理：** AI 本质上是一个高级的模式补全引擎。它在“照猫画虎”时表现最好，而让它“凭空创造”时最容易出现风格偏差。 - **场景：** 假设你要开发一个新的 `OrderController`。如果不给参考，AI 可能会使用过时的 `@Autowired` 字段注入，或者忘记使用统一的 `Result` 包装类。 - **做法：** - 先找到你项目中写得最好的现有代码（比如 `UserController.java`）。 - 把项目规范写进 `CLAUDE.md`（如构造器注入、统一异常处理、Swagger 注解风格等），这样即使你不手动指定参考文件，Claude 也能遵循一致的标准。 - **提示词示例：** "阅读 `/src/main/java/.../UserController.java` 及其对应的 Service 和 DTO。参考它的分层架构、构造器注入模式、统一异常处理以及 Swagger 注解写法，为我生成 `OrderController` 的相关代码。" - **收益：** 确保新旧代码风格的高度一致性。 ### 5. 消除样式”AI 味”：锁定样式标准与设计 Skill - **原理：** 如果不加约束，Claude 生成的页面容易出现典型的”AI Look”——千篇一律的 Inter 字体 + 紫色渐变 + 圆角卡片，毫无辨识度。 - **做法：** - 明确要求使用 Tailwind CSS 或特定的组件库（如 shadcn/ui, Ant Design）。 - 在提示词中加入风格关键词，例如：”使用 **Tailwind CSS**，风格参考 **Linear** 或 **Vercel**，采用极简主义、大留白、圆角矩形和深色模式。” - 可以直接告诉它具体的色值（Primary Color）、间距（Spacing）和字体。 - **安装前端设计 Skill**：社区已有成熟的设计 Skill，可以让 Claude 在写代码前先确定视觉方向，从根源上避免”AI 味”： - **Anthropic 官方 Frontend Design**（`claude plugin add anthropic/frontend-design`）：Anthropic 官方出品，强制 Claude 在编码前先确定视觉方向，内置反模式规则拦截 Inter + 紫色渐变等通用套路，要求使用真实的字体搭配和 CSS 变量体系。 - **Web Designer Plugin**（`claude plugin add MickeyAlton33/web-designer`）：基于 38 个 Awwwards 获奖网站提炼了 48 套设计模式，覆盖排版系统、配色理论（5 种色板原型）、动画词汇表、布局模式和 3D 技法，附带 10 个完整概念站点示例和”AI Look”反模式清单。 - **收益：** 生成的页面直接符合项目视觉规范，告别千篇一律的”AI 味”。 ### 6. 安全红线与权限模式 - **禁止**：不要使用 `--dangerously-skip-permissions` 跳过所有权限检查，这相当于把家门钥匙给了 AI。这个模式完全不做安全审查，所有操作立即执行，没有任何兜底机制。官方文档原话：”bypassPermissions offers no protection against prompt injection or unintended actions.”。 - **容器隔离**：如果确实需要跳过权限检查（比如跑自动化脚本），务必在 Docker 容器等隔离环境中运行，限制文件系统访问范围，避免对主机造成不可逆的破坏。 - **正确做法**：利用 `/permissions` 配合 `.claude/settings.json` 进行精细化的权限白名单管理，既要效率也要合规。 **Auto Mode（推荐替代 bypass 模式）** 如果你觉得频繁弹确认太烦，官方现在推荐用 Auto Mode 替代 `--dangerously-skip-permissions`。两者的核心区别在于：bypass 模式什么都不检查，Auto Mode 有一个独立的分类器模型（基于 Sonnet 4.6）在后台审查每个操作——读文件、改代码这些低风险操作自动放行，下载执行远程代码、发送敏感数据到外部、推送 main 分支这类高风险操作则会被拦截。 开启方式： ```bash # 命令行开启 claude --enable-auto-mode # 或者在 settings.json 中设为默认 # ~/.claude/settings.json 或 .claude/settings.local.json ``` ```json { “permissions”: { “defaultMode”: “auto” } } ``` 开启后，`Shift+Tab` 循环中会多出 `auto` 选项，可以随时切换。 Auto Mode 的审查逻辑： | 操作类型 | 行为 | | ------------------------------------------------ | ---------------------------- | | 只读操作（读文件、搜索） | 自动放行，无需审查 | | 工作目录内的文件编辑 | 分类器快速审查后放行 | | 安装依赖、本地构建 | 审查后放行 | | 下载执行远程代码（`curl \| bash`） | 拦截 | | 发送敏感数据到外部端点 | 拦截 | | 推送到 main、force push | 拦截 | | 修改 `.git/`、`.claude/`、`.bashrc` 等受保护路径 | 始终拦截（所有模式下都保护） | 还有一些实用细节：分类器连续拦截 3 次或累计拦截 20 次后，Auto Mode 会自动暂停，恢复手动确认——防止 Claude 在错误方向上越跑越远。被拦截的操作会记录在 `/permissions` 的”Recently denied”中，按 `r` 可以重试。 > **前提条件**：Auto Mode 目前要求 Claude Code v2.1.83+、Team/Enterprise/API 计划、Sonnet 4.6 或 Opus 4.6 模型、且必须通过 Anthropic API 直连（不支持 Bedrock、Vertex 或第三方中转）。Pro 和 Max 计划暂不支持。 ## 六、常见失败模式速查表 | 失败模式 | 症状 | 解决方法 | | -------------- | ------------------------------------- | --------------------------------------------------------------- | | 厨房水槽会话 | 话题飘到五个方向，Claude 开始胡言乱语 | 切任务就 `/clear` | | 纠正死循环 | 同一个错误纠正 3 次以上 | 清空上下文，重写 prompt | | CLAUDE.md 膨胀 | 规则文件超过 200 行，Claude 忽略细节 | 问自己“没这行会犯什么错”，删掉多余的；或拆分到 `.claude/rules/` | | 无边界调查 | Claude 读了几百个文件，上下文耗尽 | 给调查划定范围，或用子代理隔离 | | 过度指定 | 提示词太短，AI 猜测意图 | 多给上下文、文件位置、修改目的 | | 盲目信任 | 测试绿了就信，不管实际行为 | 让 Claude 证明，对比 main 和 feature 分支的行为差异 | ## 总结 回顾一下全文的关键结论： 1. **上下文窗口是你最贵的资源**——所有技巧本质上都在帮你把这块白板用得更高效。 2. **先规划后执行**——Plan Mode 投资的是后面的时间。 3. **`CLAUDE.md` 自我进化**——把纠正转化为规则，让 AI 越用越顺手。 4. **并行是最大的效率杠杆**——多实例 + Worktree + 子代理。 5. **验证优于信任**——给 Claude 验收标准，让它自己检查。 6. **`/compact` 比反复纠正更有效**——上下文被污染后，压缩或清空重来更好。