Claude Code 2.1：实用示例指南

Claude Code 是 Anthropic 开发的一款具备自主能力的编程工具，可直接在终端运行，也可通过连接的网页界面操作。与基于单次提示的方式不同，Claude Code 能理解整个仓库，跨文件进行推理、编辑代码并运行工具。

与早期版本相比（主要聚焦交互式代码辅助），Claude Code 2.1 进一步支持智能体、钩子与可复用技能，能够主动塑造代码变更的方式与时机。

Claude Code 面向希望将 AI 辅助直接嵌入真实工作流的开发者，无需在编辑器与聊天界面之间来回切换。尽管仍处于研究预览阶段，它已经在真实开发流程中展现出很强的实用价值。

若您想进一步了解 Claude 模型，建议学习Introduction to Claude Models 课程。您也可以查看我们的 Claude Cowork 教程。

Claude Code 2.1 有哪些新变化？

Claude Code 2.1 在核心终端体验之上，引入了一系列升级，使面向智能体的工作流更加灵活。这些变化拓展了 Claude Code 对代码库的推理方式以及开发者在实际任务中与其交互的方式。

Claude Code 2.1 中一些最值得关注的新增功能包括：

• 前言区的智能体与技能钩子，允许开发者在应用任何代码编辑前强制执行检查与约束。
• 扩展的技能支持，包括分叉上下文、热重载与自定义技能定义，使可复用工作流更灵活、更强大。
• 斜杠（/）技能调用，可在交互会话中快速访问常用操作。
• Claude Code 2.1 中的智能体在工具调用被拒绝时不再停止推理，工作流可不间断继续。
• 该工具支持语言可控的响应，尤其适用于多语言文档、评审与团队协作。
• 通配符工具权限，例如 Bash(*-h*)，提供更精细的自动化控制。
• CLI 现已支持使用 Shift+Enter 进行多行输入，无需额外设置即可改进交互式创作体验。

本指南将通过一组实用实验，展示这些新能力如何应用于真实项目。

设置 Claude Code 云端网页体验

Claude Code 2.1 提供完全在云端运行的网页体验。此模式尤其适用于协作工作流、拉取请求评审，以及无需本地环境的仓库级自动化。

步骤 1：登录并访问 Claude Code

首先访问 https://claude.ai/code，即可进入 Claude Code（研究预览版）界面。

步骤 2：将 Claude Code 连接到 GitHub

要处理真实仓库，Claude Code 需要访问 GitHub。点击“Connect to GitHub”，安装 Claude GitHub App。

在授权过程中，GitHub 将请求连接仓库的权限，包括：

• 验证您的 GitHub 身份
• 查看 Claude 可访问的仓库
• 代表您执行操作（例如创建分支或提交）

您可以选择：

• 所有仓库，或
• 仅选择特定仓库（建议以更好地控制权限）

常见权限包括：

• 读取仓库元数据与检查
• 对代码、Issues、拉取请求与工作流的读写权限

点击“Install & Authorize”，日后可在 GitHub 的应用设置中修改或撤销访问权限。此步骤是让 Claude Code 在网页环境中读取仓库、发起拉取请求与推送提交所必需的。

步骤 3：创建云环境

在开始首次会话前，Claude Code 会提示您创建云环境。该环境用于控制 Claude 的网络访问与执行边界。

可用选项包括：

• None：无网络访问，适用于最高安全场景。
• Trusted（推荐）：可访问已验证的软件包源。
• Full：不受限制的互联网访问。

对于大多数用例，Trusted 选项在安全与灵活性之间提供了最佳平衡。

步骤 4：启动网页会话

完成设置后，您将进入下图所示的 Claude Code 网页编辑器。

在这里，您可以：

• 选择一个仓库与分支
• 运行重构与评审
• 创建新分支与提交
• 恢复先前会话（如有）
• 在不更换环境的情况下切换仓库

设置 Claude Code 基于终端的 CLI 体验

CLI 是使用 Claude Code 2.1 的最直接方式。它非常适合本地开发、逐步重构，以及您希望对 Claude 在仓库中执行的操作进行精细控制的情形。

步骤 1：安装

可以通过终端使用平台专用安装器直接安装 Claude Code。

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash技术支持

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex技术支持

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd技术支持

安装完成后，您应看到一条确认消息，显示 Claude Code 版本与安装路径。有关更多设置选项，请参阅官方设置指南。

步骤 2：开始使用

安装后，导航到项目根目录并启动 Claude Code：

cd your-project-directory
Claude Code技术支持

启动后，Claude Code 会立刻扫描仓库并建立对代码库的初步理解。

这一初始上下文会让后续步骤中的推理更高效。

体验 Claude Code 2.1

在本次演示中，我使用了一个来自 GPT 5.2 的项目。以下是项目的简要概览。

一旦 Claude Code 能访问该文件夹内的每个文件与子文件夹，我们就可以开始实验。

使用分叉上下文技能进行重构

作为对 Claude Code 2.1 的评估，我执行了一次全仓库的重构以改进流水线。本实验重点展示带有分叉上下文的技能，Claude 能跨多个文件进行推理，而非对单个文件进行孤立编辑。

提示：

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.技术支持

Claude 会先生成详细的重构计划，包括拟议的模块结构、重复点与实施顺序，并在更改任何内容之前先征求您的批准。

得到您的批准后，Claude 会逐步应用重构，并在过程中展示差异与进度。

通过 Claude Code，我实现了以下改进：

• 按模块拆分职责：Claude 将 CSV 加载、转换、Excel 构建、PPT 生成与 LLM 规划（几乎所有模块）拆分为独立组件。
• 减少重复逻辑：将重复的工具方法（如列检测与格式化）集中管理，并将共享常量移动到统一的配置层。
• 提升可维护性：在保持应用外部行为一致的同时，Claude 还缩小了 app.py 的体量。

下面是变更前后的项目结构与重构输出对比。

之前：

之后：

最后，我在 Claude Code Web 中尝试了相同的重构。主要差别在于工作流：

• CLI 按步骤推进，并需要明确批准。
• Web 可直接将重构推送到新分支，便于协作与基于 PR 的工作流。

最终，Claude 已完成重构并将代码推送到一个分支。

编辑前验证钩子

数据流水线经常因为一个简单原因而失败：输入 CSV 的模式与代码预期不符。在 Claude Code 2.1 中，您可以通过编辑前钩子降低这类失败。该新功能允许智能体在 Claude 获准修改代码之前运行验证检查。

在此示例中，我让 Claude Code 创建一个在应用任何编辑前验证 CSV 结构的智能体。

提示：

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.技术支持

Claude Code 先生成了一个 CSV 模式验证智能体，并将其接入工作流，使其充当“守门人”。CLI 输出显示，Claude 不只是创建了一个脚本，而是组装了一个小型验证系统，包括：

• 核心模式验证模块，用于检查必需列、缺失值与基本一致性。
• 编辑前守门钩子，会在编辑继续之前自动运行验证。
• 最后，包含测试套件与一些使用示例，以在有效/无效 CSV 情况下验证该验证器。

在实践中，工作流会变得简单：

• Claude 会在进行任何代码更改前自动运行模式检查，将其作为前置条件。
• 若模式不清晰或无效，智能体会强制阻止编辑，并返回可操作的错误消息以指导修复。
• 验证通过后，Claude 再继续修改，使变更在护栏的引导下更可预测。

网页端输出的结果类似，但有一个关键差别：Claude Code Web 可以将包含验证模块、钩子集成、文档与测试的更改，直接推送到新分支。

总体而言，Claude Code 2.1 通过将钩子直接嵌入智能体与技能，在编辑发生前强制实施护栏。这在数据密集型项目中尤为有价值，因为输入正确性往往比代码本身更容易导致问题。

用于重复任务的斜杠命令技能

Claude Code 2.1 引入了可复用的斜杠命令技能，这些是可在 Claude 会话内交互调用，或直接从命令行执行的自包含工作流。

在此示例中，我们创建了一个可复用的 /generate-slides 技能，用于将 CSV 文件转换为专业的 PowerPoint 演示文稿。

提示：

Create a reusable skill called /generate-slides that converts a CSV into a PPT.技术支持

小贴士： 使用 /statusline 配置自定义状态行，显示在输入提示下方（便于展示仓库、分支或模式）。

Claude Code 会在 .claude/skills/ 下生成完整的技能定义，包括文档、验证逻辑与可运行的 Python 入口点。

• 技能创建：Claude 会编写完整文档的 generate-slides 技能，描述其目的、输入、验证步骤与执行流程。
• 模式验证：该技能会在任何处理之前先验证 CSV 模式，确保数据质量并提供清晰的错误信息。
• 执行：该技能可直接从终端运行，表现如同独立的命令行工具。
• 错误处理：缺失文件、无效模式或缺少 API 密钥时，会给出清晰且可操作的错误。
• 自动化：一条命令即可生成 Excel 工件、图表与 PPT 文稿。

您可以在本地通过以下命令测试该技能：

python .claude/skills/generate-slides.py --csv-file kpis.csv技术支持

注意：运行前请确保已添加您的 API 密钥。

斜杠命令技能让 Claude Code 不仅是助手，更是工作流引擎。与其为同一任务反复提示，不如定义一次并在项目、会话与环境间复用。您可以在下方看到更新后的仓库结构，反映了新技能的加入。

该示例展示了：

• 技能可在 CLI 中以交互方式调用。
• Claude 生成的技能可与现有代码库顺畅集成。

异步子智能体与后台运行

AI 编码工具的一大摩擦点是“等待时间”：当 AI 思考或执行耗时的测试套件时，盯着闪烁的光标干等。Claude Code 2.1 通过异步子智能体解决了这一问题。

您现在可以将长耗时任务（如复杂重构、测试运行或文档清理）通过 Ctrl+B 放到后台。这会立即释放您的终端，使您可以：

• 继续查询代码库。
• 排队第二个并行任务。
• 在 Claude 工作时手动审阅文件。

例如，当 Claude 正在重构 app.py 模块（规划与执行可能需要几分钟）时，您可以按下 Ctrl+B，并立即提问：“在它运行的同时，请解释 auth.py 中的认证逻辑。”

后台任务完成后，Claude 会通知您，您可以将其上下文合并回主流程。这样实际上把 Claude Code 从单线程的聊天界面变为一个多线程的开发伙伴，更贴近资深工程师的工作方式。

语言可控的输出

Claude Code 2.1 可配置为使用特定语言响应，这对多语言团队、本地化文档与非英文的代码讲解很有用。在此示例中，我们让 Claude 用日语完整讲解仓库的幻灯片生成流水线。

提示：

Explain the slide generation logic in Japanese.技术支持

Claude 以日语作答，并产出结构化的端到端流程说明。如输出所示，它不只是翻译摘要，还将流水线映射为清晰阶段，并引用了各步骤涉及的相关模块。CLI 输出显示：

• 全程日语： 响应自始至终保持日语，包括标题与要点。
• 分步流程： Claude 将流水线拆分为独立阶段（CSV 验证、数据处理、Excel 工作簿、LLM 规划与幻灯片创建）。
• 基于代码库的引用： 在解释每个组件作用时，指向相关文件与目录。
• 文档化格式： 输出读起来像内部文档，便于复用于 README 或入职指南。

注意： 本例我只在 CLI 中测试了此行为，但同样的语言控制能力属于 Claude Code 2.1 的整体特性。

纸面上这只是个小功能，但在需要使用英语以外语言进行文档与评审时，它能显著提升效率。

Claude Code 2.1 命令

以下是一些可在 Claude Code 中试用的命令。

结语

本指南通过在 CLI 与网页工作流中的动手实验，带您探索了 Claude Code 2.1。我们使用 Claude Code 借助分叉上下文技能重构现有仓库、用编辑前验证钩子强化数据保障、创建可复用的斜杠命令技能，并直接从代码库生成受语言控制的讲解。

这些示例表明，Claude Code 2.1 已从简单的 AI 辅助编辑迈向更偏智能体驱动的开发工作流。尽管仍为研究预览版，但它已在真实项目中展现出显著的实用价值。