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

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

QuadCode 是一个全新的、完全智能体化的 AI 编程助手，它不局限于逐行补全代码，而是能够构建完整功能、修复错误，并适配所有主流 IDE 和终端环境，其核心使用路径是从代码问答开始，逐步过渡到编辑、工具集成和并行工作流。

核心要点

• QuadCode 的本质：新一代 AI 编程助手，与以往逐行补全的 AI 工具不同，它是完全智能体（agentic）式的，能够构建功能、编写所有功能代码、修复所有错误。
• 工具无关性：QuadCode 不要求改变工作流，支持所有 IDE（Xcode、JetBrains IDE 等）、所有终端，可在本地、远程 SSH、Tmux 等任何环境中运行。
• 上手路径：推荐从代码问答（Q&A）开始，而非直接编辑代码；通过提问了解代码库，再逐步过渡到编辑和更高级的用法。
• 上下文的重要性：通过 CLAUDE.md 文件、slash 命令、层级配置等方式给 QuadCode 提供更多上下文，可以显著提升其表现。
• 验证与迭代：给 QuadCode 提供验证工作的工具（如单元测试、Puppeteer 录制、iOS 模拟器录制），它能自主迭代并产出更高质量的结果。

详细解析

一、快速入门与初始设置

1. 安装与前置条件

• 需要 Node.js 环境。
• 安装命令在演讲中提及，用于帮助听众在演讲期间同步安装并跟随操作。

2. 推荐初始配置

演讲者 Boris 推荐在首次打开 QuadCode 时进行以下简单设置：

• `/terminal setup`：启用 Shift+Enter 换行，无需再输入反斜杠，使用更便捷。
• `/theme`：设置浅色或深色模式，或色盲友好主题。
• 安装 GitHub App：当天宣布的新功能，可在任何 GitHub issue 中提及 Claude。安装方式为在终端执行特定命令。
• 自定义允许的工具集：避免每次操作都被提示确认，提升效率。演讲者明确表示会进行此自定义，省去反复确认的麻烦。
• macOS 语音输入技巧：进入系统设置 → 辅助功能 → 听写，开启后双击按键即可语音输入 prompt。演讲者常用此方式口述 prompt，尤其适合快速表达想法。

二、核心使用模式：从问答到编辑

1. 代码问答（Q&A）—— 首要推荐

• 是什么：直接向 QuadCode 提问关于代码库的问题，例如“这段代码怎么用？”、“这个类如何实例化？”。
• 为什么重要：这是演讲者最推荐的入门方式。它无需任何索引或设置，不创建远程数据库，代码保持本地，即开即用。
• 实际效果：QuadCode 不只是做文本搜索，它会深入分析，找到类的实例化示例和实际用法，给出比 wiki 或文档更深入的答案。
• 案例数据：在 Anthropic，技术岗新员工的入职培训（onboarding）原本需要 2-3 周，使用 QuadCode 后缩短到约 2 天。

2. 常见问题类型

• 代码使用方式：询问某个函数、类或模块如何被使用、如何实例化。
• Git 历史分析：例如询问“为什么这个函数有 15 个参数？”、“这些参数为什么这样命名？”。QuadCode 能查看 Git 历史，追溯参数引入的背景、提交者、当时的情境和关联的 issue。
• GitHub issue 上下文：使用 WebFetch 工具获取 issue 的上下文信息。
• 周报生成：在每日站会前，询问“这周我提交了什么？”，QuadCode 会查看 git 日志并生成总结，可直接复制到文档中。

3. 编辑代码与智能体工作方式

• 工具集：QuadCode 提供一组精简的工具——文件编辑、命令执行、搜索，它会自主组合这些工具来探索代码、头脑风暴并最终完成编辑。用户无需指定具体工具，只需下达指令。
• 推荐做法：先规划后执行：
• 在让 QuadCode 写代码前，先要求它进行头脑风暴和规划。
• 常见做法是直接说“在写代码之前，先做一个计划”，QuadCode 能理解这种自然语言指令，无需特殊模式。
• 避免直接要求实现 3000 行的大功能，因为一次成功的概率不高，且构建方向可能不对。先规划可显著提高成功率。
• 自动 Git 操作：QuadCode 能自主完成 commit、push 到分支、创建 Pull Request，无需用户解释流程，它会自行发现 commit 格式等规范。

三、工具集成：Batch 工具与 MCP

1. 两种工具类型

• Batch 工具（CLI）：例如自定义的 CLI 工具，可以通过 --help 等方式告知 QuadCode 如何使用。如果频繁使用，可将其写入 CLAUDE.md 以便跨会话记忆。
• MCP（Model Context Protocol）服务器：QuadCode 支持 MCP，用户可以告知它如何使用，它会自主调用。

2. 工具集成的价值

• 在新代码库中使用 QuadCode 时，可以一次性提供团队已有的所有工具，QuadCode 会替你使用它们。
• 这是 QuadCode 真正发挥威力的场景，也是 Anthropic 内部和外部用户常见的模式。

3. 验证与迭代循环

• 核心技巧：给 QuadCode 提供一种验证自身工作的方式，例如编写单元测试、Puppeteer 录制、iOS 模拟器录制。
• 效果：有了反馈机制，QuadCode 能自主迭代。例如构建 UI 时，第一次可能不错，但经过两次迭代后往往接近完美。
• 建议：无论领域是什么（单元测试、集成测试、截图、web 应用），都让 QuadCode 自己尝试使用工具并找到正确的工作方式。

四、上下文管理：CLAUDE.md 与层级配置

1. CLAUDE.md 文件

• 是什么：一个特殊命名的 Markdown 文件，是给 QuadCode 提供上下文的主要方式。
• 放置位置与生效范围：
• 项目根目录：放在项目路径下，每次会话开始时自动读取，包含在前几轮对话中。
• 子目录：放在嵌套目录中，当 QuadCode 在该目录下工作时按需加载。
• 用户本地：放在用户主目录，仅对个人生效，不纳入版本控制。
• 企业路径：放在企业路由中，自动加载，适用于公司统一管理。
• 内容建议：常见基础命令、最佳 MCP 工具、架构决策、重要文件、任何在该代码库工作需要知道的信息。
• 长度控制：尽量保持简短，过长可能导致信息不被充分处理。
• 团队共享：项目级 CLAUDE.md 应纳入版本控制，与团队共享，写一次即可全员使用。

2. Slash 命令（.claude/commands）

• 是什么：自定义的斜杠命令，可放在用户主目录或通过项目版本控制共享。
• 示例：在 Anthropic 的 repo 中，有处理 GitHub issue 选择的命令，QuadCode 会执行该命令，无需人工干预。
• 用途：将常用操作封装为命令，提升效率。

3. 层级配置体系

• 项目级配置：特定于 Git 仓库，可纳入版本控制。
• 全局配置：适用于所有项目。
• 企业策略：全局配置，自动应用到所有员工和团队。
• 可配置内容：
• Slash 命令：可按层级配置。
• 权限：例如，企业可预先授权所有员工使用某个 bash 命令（如 test 命令），在 EnterprisePolicies 文件中配置后，员工执行该命令时自动授权，无需确认。
• 命令阻止：可配置禁止执行的命令或禁止访问的 URL，防止员工覆盖，保障代码库安全。
• MCP 服务器：通过 mcp.json 文件配置，纳入版本控制后，任何使用 QuadCode 的人都会被邀请安装团队共享的 MCP 服务器。

4. 起步建议

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

五、终端快捷键与效率技巧（Protips）

• 查看所有快捷键：点击 Tab+Shift 可显示所有快捷键列表。
• 自动接受模式（auto-accept）：当确认 QuadCode 方向正确，或正在迭代单元测试时，使用此模式免去每次点击确认。
• 内联命令：在 bash 命令旁点击感叹号，可输入自定义命令。该命令会在本地执行，同时进入上下文菜单，QuadCode 下一轮会看到。适合精确指定命令或补充说明。
• Esc 键：随时按下 Esc 可中断当前操作，QuadCode 会询问需要什么不同的做法，或建议修改。可对建议进行微调（如“19 行没问题，但有一行需要改”），然后让它重新编辑。
• 双击 Esc：返回历史记录。
• 会话总结：会话结束后，可让 QuadCode 生成总结。
• Ctrl+R：查看完整输出，与 QuadCode 上下文窗口中看到的内容一致。

六、QuadCode SDK 与 CLI 管道

1. SDK 概述

• QuadCode SDK 与 QuadCode 本身使用的是同一套 SDK，用户可基于它构建自己的应用。
• 演讲中提到，过去几周团队正在规划大量新功能以进一步完善 SDK。

2. Claude Code CLI 用法

• 基本用法：claude 命令可传入 prompt，指定允许的工具（包括特定 batch 命令），并设定输出格式（如 JSON）。
• 定位：可视为一个“超级智能的 Unix 工具”——输入 prompt，输出 JSON。
• 实际应用：
• 用于事件响应（incident response）。
• 可与其他 Unix 工具组合，例如 git status 通过管道传给 jq 筛选结果。
• 读取 GCP 日志等大型日志文件，交给 Claude 分析其中有趣的信息。
• 从 CLI 收集数据，通过管道处理后执行后续操作。
• 组合的无限可能性：演讲者认为这只是冰山一角，社区正在不断发现新的用法。

七、高级并行工作流

• 适用人群：高级用户（Power Users），通常在 Anthropic 内外部的重度使用者中观察到。
• 典型模式：
• 拥有 SSH 会话和 Tmux 隧道。
• 在会话中运行同一 repo 的多个 checkout。
• 并行运行多个 Claude 实例。
• 使用 Git Worktree 实现隔离。
• 现状：团队正在积极优化并行使用的体验，但目前上述方法是实现并行工作的可行思路。
• 核心理念：可以同时运行任意数量的会话，并行完成大量工作。

八、问答环节要点

1. 最难的实现部分：Bash 命令安全

• 挑战：Bash 命令可能以意外方式改变系统状态，存在安全风险；但若要求每个命令都手动审批，工程师体验极差、无法高效工作。
• 解决方案：
• 静态分析：识别只读命令，判断哪些命令可以安全组合。
• 复杂的权限系统：在不同层级列出和阻止命令。
• 目标是设计一种能适应不同代码库类型（并非所有人都用 Docker 容器管理代码）的安全扩展方案。

2. 多模态支持

• QuadCode 从一开始就支持图像输入，但终端环境不易发现此功能。
• 使用方法：拖拽图片到终端、提供文件路径、或直接复制粘贴图片。
• 应用场景：演讲者常用 mock 图，直接拖入并指示“实现这个”，然后启动服务器迭代，完全自动化。

3. 为什么选择终端优先

• 原因一：Anthropic 内部使用多种 IDE（VS Code、Zed、Xcode、Vim），构建一个通用工具很难，终端是所有人的共同点。
• 原因二：Anthropic 观察到用户可能不再使用 IDE，预计到年底可能更多人不用 IDE。团队希望为这一未来做准备，避免在 UI 上过度投资。

4. 内部使用情况

• Anthropic 约 80% 的技术人员（工程师和研究员）每天使用 QuadCode。
• 包括学生使用 QuadCode 进行机器学习建模，编辑和执行代码。

方法与步骤

推荐的上手路径

1. 初始设置：运行 /terminal setup、/theme 设置主题、安装 GitHub App、自定义允许的工具集。
2. 从代码问答开始：向 QuadCode 提问代码库相关问题，熟悉其能力和边界。
3. 过渡到代码编辑：先要求规划，再执行；利用自动 Git 操作。
4. 集成团队工具：通过 batch 工具和 MCP 服务器，让 QuadCode 使用团队现有工具。
5. 提供验证机制：配置单元测试或录制工具，让 QuadCode 自主迭代。
6. 丰富上下文：创建 CLAUDE.md、slash 命令、层级配置。
7. 探索高级用法：使用 SDK/CLI 管道、并行会话、SSH/Tmux 工作流。

编写 CLAUDE.md 的步骤

1. 在项目根目录创建 CLAUDE.md 文件。
2. 写入常见基础命令、最佳 MCP 工具、架构决策、重要文件列表。
3. 保持内容简短精炼。
4. 纳入版本控制，与团队共享。
5. 根据需要在子目录放置额外的 CLAUDE.md。
6. 企业场景下，可在企业路由中放置全局 CLAUDE.md。

案例与数据

限制与待确认问题

• Bash 安全：当前通过静态分析和权限系统管理，但需适应不同代码库类型，并非所有环境都使用 Docker 容器。
• 并行工作流：团队正在积极优化，当前方案（SSH、Tmux、多 checkout、Git Worktree）是可行的但体验有待改进。
• CLAUDE.md 长度：过长可能导致信息处理不充分，需保持简短。
• IDE 未来：Anthropic 预测用户可能不再使用 IDE，但这是基于内部观察的推测。
• SDK 功能：演讲提到正在规划新功能，但未具体说明细节。

行动清单

• [ ] 安装 Node.js 和 QuadCode
• [ ] 运行 /terminal setup 启用 Shift+Enter
• [ ] 设置主题（/theme）
• [ ] 安装 GitHub App
• [ ] 自定义允许的工具集
• [ ] （macOS 用户）开启听写功能用于语音输入
• [ ] 用代码问答方式探索代码库
• [ ] 尝试 Git 历史分析问题
• [ ] 编辑代码前先要求 QuadCode 做规划
• [ ] 配置验证工具（单元测试、Puppeteer 等）
• [ ] 创建项目级 CLAUDE.md 并纳入版本控制
• [ ] 配置 slash 命令和层级权限
• [ ] 尝试 SDK/CLI 管道组合
• [ ] 探索并行会话工作流

总结

QuadCode 代表了 AI 编程助手从“补全代码”到“智能体式工作”的范式转变。其核心优势在于工具无关性、智能体自主性和强大的上下文管理能力。成功使用的关键在于：从问答开始逐步深入、先规划后执行、提供验证反馈循环、通过 CLAUDE.md 和层级配置丰富上下文、集成团队工具链。对于高级用户，SDK 管道和并行工作流提供了更大的灵活性和自动化空间。Bash 命令安全是当前实现中最复杂的部分，团队通过静态分析和权限系统在安全性与效率之间寻求平衡。