StreamSparkAI

概览/核心摘要 (Executive Summary)

Claude Code 是 Anthropic 开发的一种新型“代理式”AI编程助手，旨在处理复杂的开发任务，如构建完整功能、编写整个文件或修复大型bug，而非简单的代码补全。其核心优势在于与现有开发工具和工作流程无缝集成，支持多种IDE（如VS Code, Xcode, JetBrains, Vim, Emacs）和终端环境，并可在本地运行，确保代码安全不上传。该工具通过其“代理”能力，能自主理解并串联使用文件编辑、运行Bash命令和搜索文件等工具。

Anthropic强烈推荐用户从“代码库问答”（Codebase Q&A）功能开始使用，这能显著缩短技术人员的入职时间（从2-3周缩短至2-3天），因为它允许新员工直接向代码库提问，并获取深入的Git历史、代码用法和问题背景信息。Claude Code不进行代码索引或上传，确保用户代码的本地性和隐私。

进阶用法包括让Claude Code在编写代码前进行“头脑风暴”或制定“计划”，以及通过提供反馈机制（如单元测试、截图工具）使其能够自主迭代和优化代码。用户还可以集成团队的Bash工具和MCP工具，进一步提升效率。为了提供更智能的决策，用户可通过quad.md文件、斜杠命令和文件提及等方式向Claude Code提供更多上下文信息，甚至配置分层策略来管理团队工具和权限。SDK的提供使其能作为强大的Unix工具集成到CI/CD流程中。Anthropic选择CLI而非IDE形式，是基于对AI模型快速发展可能使传统IDE过时的预测，并强调其在内部（包括机器学习建模）的广泛应用。

Claude Code 简介与安装

Boris，Anthropic的技术人员，也是Claude Code的创建者，介绍了这款工具。他强调本次分享将侧重于实用技巧，而非理论或历史。

• 安装方式：对于未曾使用过的用户，可通过运行 npm install -g @anthropic-ai/claude-code 命令进行安装，仅需Node.js环境。
• 定位：Claude Code被定义为“一种新型的AI助手”，区别于以往仅完成单行或几行代码的AI工具。
• 核心特点：
  • 完全“代理式”（fully agentic）：旨在构建完整功能、编写整个文件、修复整个bug。
  • 无缝集成：与用户现有的所有工具和工作流程兼容，无需改变IDE（支持VS Code, Xcode, JetBrains, Vim, Emacs等）。
  • 环境通用性：可在本地、远程SSH或TMUX等任何环境中运行。
  • 通用目的工具：作为一个强大的工具，它不强制用户遵循特定工作流程，而是提供高度自由度。

环境设置与基础操作

首次使用Claude Code时，建议进行以下环境设置和操作：

• 终端设置：运行 /terminal setup 命令，启用Shift+Enter键进行换行输入，提升使用体验。
• 主题设置：使用 /theme 命令切换亮色、暗色或Daltonized主题。
• GitHub应用集成：运行 /install GitHub app 命令，以便在GitHub issue或pull request中提及Claude。
• 工具权限定制：可自定义允许使用的工具集，避免每次都被提示确认。
• 语音输入（macOS）：在macOS系统设置的辅助功能中启用听写功能，通过双击听写键即可直接语音输入提示词，极大提高效率，尤其适合输入具体、详细的提示。

推荐的起始点：代码库问答 (Codebase Q&A)

Boris强烈推荐将“代码库问答”作为Claude Code的第一个使用场景，尤其适合新用户或团队入职培训。

• Anthropic内部实践：新入职的技术人员在第一天就会学习并使用Claude Code进行代码库问答。
• 显著效益：
  • 减轻团队负担：减少新员工向团队成员提问的频率。
  • 加速入职进程：技术人员的入职时间从过去的2-3周缩短至2-3天。
• 数据安全与隐私：
  • 无索引：不创建远程数据库或索引用户代码。
  • 代码本地化：用户代码始终保留在本地，不上传到任何地方。
  • 不训练模型：Anthropic明确表示不会使用用户代码训练生成式模型。
  • 即时可用：无需等待索引或设置，下载后即可立即使用。
• 问答示例：
  • 代码用法：询问“这段代码如何使用？”或“如何实例化这个对象？”Claude Code不仅进行文本搜索，还会深入分析并提供实例化和使用示例，给出比简单文档更深入的答案。
  • Git历史分析：询问“为什么这个函数有15个参数？”或“为什么参数命名如此奇怪？”Claude Code能查阅Git历史，总结参数引入的原因、引入者以及相关联的issue。Boris强调，Claude Code能做到这一点是因为“模型非常出色”，而非系统提示的设定。
  • GitHub Issue上下文：利用webfetch功能获取GitHub issue的上下文信息。
  • 个人工作总结：每周例会时，可询问“我这周发布了什么？”Claude Code会根据Git日志和用户名，提供一份详细的发布清单，方便用户直接复制粘贴。
• 教学建议：对于首次接触Claude Code的用户或团队，应从代码库问答开始，以帮助他们理解如何提问以及Claude Code的能力边界。

代码编辑与迭代

当用户熟悉代码库问答后，可以进入代码编辑阶段。

• 工具集：Claude Code拥有一套精简的工具集，包括：
  • 编辑文件
  • 运行Bash命令
  • 搜索文件
  • Claude Code能够自主将这些工具串联起来，进行代码探索、头脑风暴并最终进行编辑。
• 头脑风暴与计划（强烈推荐）：
  • 在让Claude Code编写代码之前，建议先要求它进行“头脑风暴”或“制定计划”。
  • 这有助于确保最终结果符合预期，尤其是在处理大型功能（如3000行代码）时。
  • 用户只需简单地提示“在你编写代码之前，先制定一个计划”，Claude Code便会理解并执行。
• 自动化Git操作：
  • 使用类似“commit postsphere”[原文中为"commit postsphere"，可能为口误或特定术语]的提示，Claude Code能自动完成提交、推送到分支、创建分支并在GitHub上创建Pull Request等操作。
  • 它能自行分析代码和Git日志，理解提交格式，无需用户详细解释。

集成团队工具与上下文管理

随着使用深入，用户可以开始集成团队的特定工具，并提供更多上下文信息以提升Claude Code的智能决策能力。

集成团队工具

• 工具类型：主要分为两类：
  • Bash工具：例如，自定义的CLI工具（如虚构的barley cli）。用户可以告知Claude Code这些工具的存在及其使用方法（如通过--help命令）。
  • MCP工具：Claude Code同样支持使用MCP工具。
• 强大之处：在处理新代码库时，用户可以向Claude Code提供团队已使用的所有工具，使其能够直接利用这些工具进行操作。
• 工作流优化：
  • 探索、计划与确认：先进行探索和规划，并在编写代码前请求确认。
  • 迭代优化：通过提供反馈机制（如单元测试、集成测试、Puppeteer或iOS模拟器截图），Claude Code能够检查自己的工作并进行迭代。这对于从模型构建Web UI等任务尤其有效，通过多次迭代可达到近乎完美的结果。
  • 核心提示：无论领域如何，提供一个让Claude Code能够“检查其结果”的方式（如测试、截图），它便能自主迭代并产出更好的结果。

提供更多上下文

更多的上下文信息能帮助Claude Code做出更明智的决策。

• quad.md 文件：
  • 特殊文件名：通常放置在项目根目录，在每个会话开始时自动加载到上下文中。
  • 用途：可包含常用Bash命令、常用MCP工具、架构决策、重要文件等，即任何在代码库中工作通常需要了解的信息。
  • 类型：
    • 共享 quad.md：应提交到版本控制，与团队共享，实现一次配置，全员受益。
    • 本地 quad.md：不提交版本控制，仅供个人使用。
    • 嵌套 quad.md：放置在子目录中，当Claude Code在该目录中工作时自动加载。
    • 企业 quad.md：放置在企业根目录，由企业统一管理，自动应用于所有员工。
  • 长度建议：保持quad.md文件尽可能短，过长会占用过多上下文并降低实用性。
• 斜杠命令 (.claude/commands)：
  • 可放置在用户主目录或项目目录中，用于定义Shell命令。
  • 示例：Anthropic内部使用 /label GitHub issues 命令，由Claude Code自动为GitHub issue打标签，节省了大量人工时间。
• 文件提及：随时使用 @mention 提及文件，将其内容拉入上下文。
• 上下文调优：花时间调优上下文至关重要，它能显著提升性能。需考虑上下文的受众（团队共享或个人偏好）、加载方式（每次加载或按需加载）。

分层配置 (高级)

Claude Code支持分层配置，以更精细地管理工具和权限。

• 配置层级：
  • 项目特定配置：与Git仓库关联，可提交版本控制或仅供个人使用。
  • 全局配置：适用于所有项目。
  • 企业策略：为所有员工自动应用的全局配置。
• 应用范围：适用于Bash命令、权限管理等。
  • 示例：企业策略可自动批准所有员工使用的特定Bash命令，或阻止访问特定URL，从而提高效率和安全性。
• MCP服务器配置：通过在代码库中放置 mcp.json 文件，可提示团队成员安装所需的MCP服务器，实现团队共享。
• 起始建议：对于不确定如何开始的用户，Boris建议从“共享项目配置”（如共享的quad.md）开始，因为这能带来“网络效应”，一人配置，全员受益。
• 内存管理工具：
  • /memory：查看所有已加载的内存文件（包括企业策略、用户内存、项目quad.md、嵌套quad.md等）。
  • /memory edit：编辑特定的内存文件。
  • # (井号)：在输入时，可选择将内容保存到哪个内存文件。

专业技巧与快捷键

Boris分享了一些不为人知的常用快捷键和专业技巧：

• Shift+Tab：接受编辑。此操作会切换到“自动接受编辑”模式，后续的编辑将自动被接受（Bash命令仍需批准）。这在Claude Code进行单元测试或迭代时非常有用。
• # (井号)：告诉Claude Code记住某些信息。例如，如果Claude Code未能正确使用某个工具，可以通过#告诉它正确用法，它会将其整合到quad.md中。
• ! (感叹号)：进入Bash模式。可运行本地Bash命令，命令及其输出都会进入Claude Code的上下文窗口，适用于长时间运行的命令或需要将输出纳入上下文的场景。
• @mention 文件/文件夹：随时将文件或文件夹内容拉入上下文。
• Escape：安全地停止Claude Code的当前操作，不会损坏会话。用户可以随时停止，然后指示Claude Code进行不同的操作或修正部分内容。
• Escape两次：回溯历史。
• claude --resume 或 claude --continue：恢复之前的会话。
• Ctrl+R：显示完整的输出，即Claude Code在上下文窗口中看到的所有内容。

Claude Code SDK

• SDK介绍：claude -p 标志即为SDK。Anthropic内部广泛使用该SDK。
• 内部应用：Anthropic在CI/CD、事件响应和各种自动化流程中大量使用该SDK。
• 功能：可将SDK视为一个“Unix工具”。用户可以向其传递提示、允许的工具（包括特定Bash命令），并指定输出格式（如JSON或流式JSON）。
• 灵活性：可以进行管道操作，例如将git status的输出通过管道传递给SDK，并使用jq进行结果筛选。Boris认为这是一种“超级智能的Unix工具”，其潜力尚未完全发掘。
• 数据处理：可读取大型日志文件（如GCP存储桶中的日志），通过管道传递给Claude Code，让其识别日志中的关键信息；也可从Sentry CLI获取数据并进行处理。

高级用例与并行工作

• 高级用户模式：Boris观察到，Anthropic内外的资深用户通常会运行多个Claude Code会话以实现并行工作。
  • 通过SSH会话或TMUX隧道连接到Claude Code会话。
  • 在同一代码库中进行多个检出（checkout），以便并行运行多个Claude Code实例。
  • 使用Git工作树（worktrees）来隔离不同的并行工作。
• 未来展望：Anthropic正在积极努力，使并行工作模式更易于使用。

问答环节

• 最困难的实现部分：Boris认为最棘手的部分是如何安全地执行Bash命令。Bash本质上具有危险性，可能意外改变系统状态。然而，手动批准每个Bash命令又会严重影响工程师的生产力。解决方案涉及：
  • 识别只读命令。
  • 进行静态分析以确定哪些命令可以安全组合。
  • 建立一个复杂的分层权限系统，允许在不同级别上设置命令的白名单和黑名单，以适应不同代码库和环境（例如，并非所有用户都在Docker容器中运行代码）。
• 多模态功能：
  • 是，Claude Code从一开始就完全支持多模态。
  • 尽管在终端中可能不易发现，但用户可以通过拖放图像、提供文件路径或复制粘贴图像来输入。
  • 示例：用户可以拖入一个UI模型图，要求Claude Code实现它，并结合Puppeteer服务器进行迭代，实现完全自动化。
• 为何选择CLI工具而非IDE集成：
  • 原因1：Anthropic内部多样性：Anthropic的工程师使用各种IDE（VS Code, Zed, Xcode, Vim, Emacs），CLI是所有人的共同分母，更容易构建一个普适的工具。
  • 原因2：模型发展速度：Boris预测，AI模型发展速度极快，“到今年年底，人们可能不再使用IDE了。”Anthropic希望为这一未来做好准备，避免在UI和其他上层投入过多，因为这些工作可能很快变得无用。
• Claude Code在机器学习建模中的应用：
  • 广泛应用：Anthropic内部大量使用Claude Code进行机器学习建模。
  • 使用情况：Anthropic约80%的技术人员每天使用Claude Code，包括研究人员，他们使用“notebook notebook tool”等工具编辑和运行Jupyter Notebook。

结论

Claude Code是一款功能强大且高度灵活的AI编程助手，其“代理式”设计使其能够处理复杂的开发任务，并通过与现有工具和工作流程的无缝集成，显著提升开发效率。其核心优势在于对代码的本地处理、强大的上下文理解能力以及对团队工具的集成。Anthropic选择CLI作为其主要接口，体现了对AI技术未来发展趋势的深刻洞察。通过提供丰富的配置选项和SDK，Claude Code不仅能满足个人开发者的需求，也能在企业级CI/CD和自动化流程中发挥关键作用。