QuadCode（Cloud Code）实用技巧分享：从入门到高级工作流

QuadCode（Cloud Code）实用技巧分享：从入门到高级工作流

QuadCode 是 Anthropic 推出的全新一代全自主（fully agentic）AI 编程助手，其核心价值在于：无需改变现有工作流，即可在任何 IDE、终端或远程环境中，通过自然语言完成从代码问答、编辑到复杂功能构建的完整工程任务。

核心要点

• 定位转变：QuadCode 不同于传统的“逐行补全”式 AI 编程助手，它能够自主构建完整功能、编写所有功能代码、修复所有错误，是一个“全自主代理”。
• 工具无关性：QuadCode 支持所有主流 IDE（Xcode、JetBrains 系列等）、所有终端环境（本地、远程 SSH、Tmux），用户无需改变现有工作流。
• 上手门槛：对于从未使用过此类工具的用户，打开后面对一个 prompt 输入框可能会感到困惑，因此需要一套推荐的入门路径。
• 环境配置：通过简单的终端命令即可完成个性化设置，包括主题、换行方式、GitHub App 集成等。
• 核心工作流演进：从“基于代码的 Q&A”开始 → 进入“代码编辑” → 使用“自定义工具（Batch Tools / MCP）” → 通过“上下文管理（CLAUDE.md）”提升效果 → 最终实现“并行多会话”的高级用法。

详细解析

一、快速上手与环境配置

1. 安装与前置条件

• 需要 Node.js 环境。
• 演讲者鼓励未使用过 QuadCode 的听众现场打开电脑安装，以便跟随后续演示。

2. 推荐的基础设置命令

3. macOS 用户的语音输入技巧

• 路径：系统设置 → 辅助功能 → 听写（Dictation）。
• 操作：双击按键启动听写，直接口述 prompt。
• 价值：帮助用户更自然地表达复杂的 prompt，尤其适合“用工程师的方式与 Cloud Code 对话”，无需编写大量代码。

二、入门首选：基于代码的 Q&A

1. 为什么从 Q&A 开始？

• 零设置：QuadCode 不做任何索引（indexing），没有远程数据库存储你的代码，代码完全保持本地（“Tu código queda local”）。
• 即时可用：启动即可使用，无需等待索引或配置。
• 快速上手：这是向团队首次展示 QuadCode 时推荐的第一步，而非直接开始编辑代码。

2. Q&A 的实际效果与案例

• 技术入职（onboarding）效率提升：在 Anthropic 内部，技术新人的入职时间从 2-3 周缩短到约 2 天。新员工第一天解锁 Cloud Code 后，立即开始询问代码库相关问题。
• 深度回答能力：QuadCode 不仅仅是文本搜索（text search），它会深入代码库，寻找类的实例化方式、实际使用示例，给出比 wiki 或文档更深入的答案。
• 典型问题示例：
• “这段代码怎么用？”
• “这个类是如何实例化的？”

3. 高级 Q&A 场景：Git 历史分析

• 问题示例：“为什么这个函数有 15 个参数？这些参数为什么这样命名？”
• 能力：QuadCode 能查看 Git 历史，追溯参数的引入时间、引入者、当时的背景和关联的 issue。
• 价值：无需用户提供细节，模型本身足够智能，能自主使用 Git 工具完成调查。

4. 其他实用 Q&A 场景

• GitHub Issue 上下文：使用 WebFetch 工具获取 issue 的上下文信息。
• 周报生成：在每日站会前，询问“我这周提交了什么？”，QuadCode 会查看提交记录（git log），生成一份完整的提交摘要，可直接复制到文档中。

三、进阶：代码编辑与交互模式

1. 从 Q&A 过渡到编辑

• 当用户对 Q&A 模式感到舒适后，下一步是开始编辑代码。
• 核心原理：给 LLM 工具（编辑文件、执行命令、搜索），它就能自主探索代码、头脑风暴并最终完成编辑。用户无需指定具体使用哪个工具，只需下达目标指令。

2. 关键技巧：先规划，后编码

• 常见误区：用户直接要求“实现这个 3000 行的功能”，结果往往第一次构建的成果不符合预期。
• 推荐做法：在写代码前，要求 QuadCode 先进行头脑风暴和规划，并请求批准后再动手。
• 实现方式：无需使用特殊的 Plan Mode 或额外工具，只需在 prompt 中说明“在写代码前，先制定一个计划，我想先思考一下”。QuadCode 能智能理解这一指令。
• 演讲者常用 prompt 模板：“Oye, antes de escribir el código, haz un plan. Esto es también quiero pensar con esto.”（“嘿，在写代码之前，先做个计划。我也想思考一下。”）

3. 自主完成 Git 操作

• QuadCode 能自主完成 commit、push 到分支、创建 Pull Request 等操作。
• 用户无需解释提交信息的格式规范，模型能自行发现并遵循代码库的提交格式。
• 关键点：这不是预设的系统，而是模型本身足够智能，知道如何正确操作。

四、高级用法：自定义工具（Batch Tools）与 MCP

1. 工具类型与配置方式

• Batch Tools（批处理工具）：例如一个自定义的 CLI 工具。用户可以通过 --help 等方式告诉 QuadCode 如何使用该 CLI。
• MCP（Model Context Protocol）服务器：QuadCode 使用 Batch Tools，用户可以告知其用法，它会自动开始使用。

2. 工具的价值

• 新代码库快速上手：当在一个新代码库中使用 QuadCode 时，可以一次性提供团队已有的所有工具，QuadCode 能自主调用它们。
• 效率提升：如果某个 CLI 工具使用频繁，可以将其用法写入 CLAUDE.md，QuadCode 会在会话期间记住。

3. 自我验证与迭代循环

• 核心技巧：给 QuadCode 一种验证自身工作的方法，例如编写单元测试、使用 Puppeteer 录制、或录制 iOS 模拟器。
• 效果：有了反馈机制后，QuadCode 能自主迭代。例如，构建一个 Web UI，第一次可能不错，但第二次迭代后“几乎完美”。
• 适用领域：单元测试、集成测试、图形界面、Web 应用、移动应用等任何领域，都应让 QuadCode 自行尝试并验证。

五、上下文管理：CLAUDE.md 与分层配置

1. CLAUDE.md 的作用与位置

• 定义：一个特殊命名的 Markdown 文件，用于为 QuadCode 提供项目上下文。
• 项目根目录：放在项目根目录（与项目同路径）的 CLAUDE.md 会在每次会话开始时被自动读取，并包含在最初的对话轮次中。
• 团队共享：项目级 CLAUDE.md 应纳入版本控制（source control），与团队共享，实现“一次编写，全员使用”。
• 个人专属：还可以有一个本地的 CLAUDE.md，仅对自己可见，不提交到版本控制。

2. CLAUDE.md 的内容建议

• 常用基础命令
• 最佳工具（MCP 服务器）
• 架构决策
• 重要文件
• 任何在该代码库上工作所需了解的信息
• 注意：尽量保持简短，如果太长可能效果不佳。

3. 分层与嵌套

• 嵌套目录：可以在子目录中放置 CLAUDE.md，当 QuadCode 在该目录下工作时，会按需加载这些文件。
• 企业级配置：公司可以将 CLAUDE.md 放在企业路径（enterprise path）中，自动应用到所有代码库。

4. 其他上下文注入方式

• Slash Commands（`.claude/` 目录）：放在用户主目录或通过项目版本控制。用于定义自定义命令。示例：一个用于“选择 GitHub issues”的 slash command，QuadCode 会执行对应命令，无需人工干预。
• @-文件引用：在对话中通过 @ 符号引用文件，将其内容加入上下文。
• Prompt Improver：可以通过运行 Prompt Improver 来优化 prompt 的上下文。

六、企业级配置与安全策略

1. 分层配置体系

• 项目级（Project）：特定于 Git 仓库，可纳入版本控制。
• 全局配置（Global）：适用于用户的所有项目。
• 企业策略（Enterprise Policies）：全局配置，自动应用于所有员工和团队。

2. 配置的应用场景

• Slash Commands：可以为企业配置统一的命令。
• 权限管理（Permissions）：
• 自动授权：例如，所有员工都会使用的 test 命令，可以在 EnterprisePolicies 文件中配置，执行时自动授权，无需逐一确认。
• 命令拦截：可以配置阻止特定命令，例如某个 URL 永远不应被抓取。配置后，员工无法覆盖此限制。
• MCP 服务器：通过 mcp.json 文件，在代码库中共享 MCP 服务器配置。任何使用 Cloud Code 的人都会被邀请安装这些服务器。

3. 起步建议

• 如果不知道从何入手，推荐从共享项目上下文开始：写一次，分享给整个团队。
• 案例：Anthropic 的 Repos App（包含所有 Web 和 App 代码）中，有一个共享的 Puppeteer MCP 服务器，通过 mcp.json 配置，任何工程师都能自动使用 Puppeteer 驱动测试。

七、终端快捷键与交互技巧（Protips）

八、Cloud Code SDK 与 CLI 高级用法

1. SDK 概述

• Cloud Code SDK 与 Cloud Code 使用的是同一个 SDK，功能完全相同。
• 团队正在积极规划更多功能，使其更加强大。

2. claude -p（CLI）模式

• 基本用法：claude -p 可以传入 prompt，指定允许的工具（包括特定的 batch 命令），并定义输出格式（如 JSON）。
• 定位：像一个 Unix 工具——输入 prompt，输出 JSON。
• 实际应用：Anthropic 内部广泛使用，例如用于事件响应（incident response）。

3. 管道（Pipe）组合

• 示例：git status 的输出通过 jq 筛选后，再传给 Claude 处理。
• 潜力：这是一种“超级智能 Unix 工具”的新理念，组合可能性无限。例如：
• 从 GCP 日志（bulletin）中读取大量日志，交给 Claude 分析有趣的信息。
• 从 CLI 收集数据，通过管道处理后执行后续操作。

九、并行工作流与高级场景

• 典型高级用户画像：拥有 SSH 会话、Tmux 隧道、同一仓库的多个 checkout（或使用 Git Worktree 隔离）。
• 并行执行：可以同时运行多个 Cloud Code 实例，每个实例处理不同的仓库或任务。
• 现状与未来：团队正在积极优化并行使用的易用性，但当前上述方法已可实现高效的并行工作。

案例与数据

• Anthropic 内部入职效率：技术新人 onboarding 时间从 2-3 周缩短至约 2 天。
• Anthropic 内部使用率：约 80% 的技术人员（包括工程师和研究人员）每天使用 Cloud Code。
• 内部工具案例：Anthropic 的 Repos App 通过 mcp.json 共享 Puppeteer MCP 服务器，实现自动化测试。
• CLI 工具案例：演讲者创建了一个名为 Barley 的示例 CLI（非真实工具），用于演示如何向 Cloud Code 描述自定义 CLI 的用法。

限制与待确认问题

• CLAUDE.md 长度：如果文件过长，可能无法被有效利用（“puede que no sea suficiente”）。
• Bash 命令安全性：这是实现中最困难的部分之一。Bash 可能以意外方式改变系统状态，但若要求手动批准每个命令则效率极低。Anthropic 的解决方案包括：
• 静态分析识别只读命令，安全组合。
• 复杂的权限系统，在不同层级进行允许（allow）和阻止（block）。
• 并行工作流：团队正在“积极工作”以简化并行使用，但当前方法仍属高级技巧。
• IDE 的未来：Anthropic 认为终端是“最大公约数”（denominador común），因为内部员工使用多种 IDE（VS Code、Zed、Xcode、Vim）。同时，团队预见到“到年底人们可能不再使用 IDE”的可能性，因此避免在 UI 上过度投资，为这一未来做准备。

行动清单

1. 安装与环境配置：确保 Node.js 已安装，运行 terminal setup 设置 Shift+Enter 换行，使用 /theme 设置主题，安装 GitHub App。
2. 个性化设置：自定义允许的工具集，避免频繁确认；macOS 用户可配置听写功能，用语音输入 prompt。
3. 从 Q&A 开始：首次使用或向团队演示时，从基于代码的问答开始，探索代码库、分析 Git 历史、生成周报。
4. 进入编辑模式：熟悉 Q&A 后，开始尝试代码编辑。务必先要求 QuadCode 制定计划并等待批准，再开始写代码。
5. 引入自定义工具：将团队常用的 CLI 工具（通过 --help 描述）和 MCP 服务器配置给 QuadCode，提升其在特定代码库中的效率。
6. 建立验证循环：为 QuadCode 提供验证工作的方法（单元测试、Puppeteer、模拟器），让它自主迭代改进。
7. 创建 CLAUDE.md：在项目根目录创建简洁的 CLAUDE.md，包含常用命令、架构决策、重要文件等，并纳入版本控制与团队共享。
8. 配置企业策略：在 EnterprisePolicies 中配置自动授权或阻止特定命令，通过 mcp.json 共享 MCP 服务器。
9. 掌握终端快捷键：熟练使用 Shift+Tab、Escape、Ctrl+R、! 等快捷键，提升交互效率。
10. 探索 SDK 与 CLI：使用 claude -p 进行脚本化调用，结合管道（pipe）和 jq 等工具，构建自动化工作流。
11. 尝试并行工作：通过 SSH、Tmux、Git Worktree 等方式，运行多个 Cloud Code 会话处理不同任务。

总结

QuadCode 代表了 AI 编程助手从“补全工具”到“自主代理”的范式转变。其核心优势在于工具无关性（任何 IDE/终端）和自主性（规划、编码、测试、Git 操作全流程）。成功使用的关键在于分阶段推进：从低风险的代码问答入手，逐步过渡到代码编辑，再通过自定义工具（Batch Tools/MCP）和上下文管理（CLAUDE.md）大幅提升效果，最终利用 SDK 和并行会话实现高级自动化。Anthropic 内部约 80% 的技术人员日常使用该工具，入职效率提升 10 倍以上，验证了其实际价值。同时，Bash 命令的安全管理是当前实现中最复杂的挑战，而团队正积极优化并行工作流的易用性，并前瞻性地布局“后 IDE”时代。