ai-doc/Claude Code.md at e5b5d3269204cc32601af33e882335effd5ca7f1

18 KiB

Raw Blame History

下面按时间线和“能力演进”两个维度，系统梳理 Claude Code 的发展历程，并结合版本节点说明它是如何从一个简单 CLI 工具，演变为今天多终端、多代理的智能编程平台的。

一、总体概览：从命令行助手到多端智能开发平台

从目前公开信息来看，Claude Code 的整体演进可以分为四个阶段：

研究预览期（2025‑02 ～ 2025‑05，0.2.x）
- 作为简单的终端 AI 编程助手出现：聊天、编辑文件、运行 Bash 命令、与 GitHub 仓库交互等。[1][2]
- 在 0.2.x 系列中逐步补齐基础能力（会话恢复、图片与文件 @ 引用、早期 MCP 等）。[3]
正式发布与 1.x 快速迭代期（2025‑05 ～ 2025‑09，1.0.x）
- 2025‑05‑22 正式 GA（1.0.0），接入 Claude 4（Opus 4 / Sonnet 4），支持 VS Code / JetBrains 插件、GitHub Actions、TS/Python SDK 等。[3][4]
- 2025‑06～07 通过 1.0.x 连续小版本，引入 Hooks 系统、会话初始化、MCP 增强等，完成从“命令行工具”到“小型开发平台”的过渡。[1][3][5]
2.0 大版本：多代理 & IDE 深度集成 & 长时自主开发（2025‑09 ～ 2025‑12，2.0.x）
- 2025‑09‑29 发布 Claude Code 2.0.0：原生 VS Code 扩展、终端 UI 2.0、检查点（/rewind 时间旅行调试）、背景任务、子代理（subagents）、Hook/Agent SDK 等能力成体系。[6]
- 2025‑10‑20 上线 Claude Code Web：浏览器与 iOS 中的异步编码代理形态，配合强沙箱和网络隔离，降低本地配置门槛。[7][8]
- 2025‑12 2.0.7x 之后加入 LSP（语言服务器协议）集成，补齐“跳转定义/查引用/悬停文档”等编辑器级智能功能。[9]
2.1 大版本：Skills 热重载、多语言与工作流打磨（2026‑01 起，2.1.x）
- 2026‑01‑07 发布 Claude Code 2.1.0，一次性合入 1000+ 次提交，被多方评价为“自上线以来最大生产力升级”。[10][11]
- 核心是把 2025 年陆续出现的 MCP、Hooks、Subagents、Skills 等“堆料”，真正打磨成“顺手又可控”的日常工作流：技能热重载、会话传送、终端兼容大幅改进、权限系统升级、多语言输出等。[10][12]

下面分阶段详细说明。

二、时间线：关键版本与里程碑

1. 研究预览期：0.2.x（2025‑02‑24 ～ 2025‑05‑21）

这一阶段本质是“验证 AI 代理编码模式是否好用”。

起点：首发与定位

2025‑02‑24：
- Anthropic 发布 Claude 3.7 Sonnet 的同时，推出 Claude Code 研究预览版，定位为首个 agentic coding tool。[2][4]
- 初始能力：
  - 搜索并读取代码
  - 编辑文件
  - 运行测试
  - 提交 / 推送代码到 GitHub
  - 运行命令行工具
  - 通过自然语言驱动一整套开发动作，Claude 会在每一步保持与你同步。[2]

0.2.x 关键特性演进（摘自英文/中文 changelog）[3]：

0.2.14（2025‑02）
- 初始 MCP 支持：可以接入模型上下文协议服务器。
- 早期 自定义 slash 命令 系统。
- 初版 工具权限控制。
0.2.75（2025‑03）
- 视觉增强：
  - 支持 图片拖拽 / 粘贴。
  - 支持在对话中通过 @文件 引用仓库文件。
  - 改进 TUI 视觉体验。
0.2.93（2025‑04）
- 会话恢复（resume conversations）：跨会话延续上下文。
- 会话持久化：重启后保留上下文。

到 0.2.93，Claude Code 已经从“一次性对话的 CLI 工具”变成了可以维护长任务、反复迭代的开发会话。

2. 正式 GA 与 1.0.x 迭代（2025‑05‑22 ～ 2025‑09）

1.0.0：GA 大版本（2025‑05‑22）[3][4]

与 Claude 4（Opus 4 / Sonnet 4）同日发布，标志 Claude Code 从实验工具走向正式产品线。
关键特性：
- IDE 集成：
  - 正式支持 VS Code、JetBrains 插件，提供内联编辑体验。
- GitHub Actions 集成：
  - 支持后台任务、CI/CD 流程中的自动修复与改动提案。
- 可扩展 SDK：
  - 官方 TypeScript / Python SDK，可在自有系统中嵌入 Claude Code agent。
- 企业级就绪：
  - 内置安全、隐私、合规特性。
- 多云 + 多平台：
  - 模型侧：Anthropic API、AWS Bedrock、Google Vertex AI。
  - 运行环境：Windows（含 WSL2）、macOS、Linux。
  - 订阅：Pro、Max 计划开放使用 Claude Code。

1.0.x 的“高频小步快跑”（以 2025‑06～07 为典型）[1][3][5]：

2025‑06‑11：SDK 正式对外
- TS / Python SDK 用于 IDE 插件、CI/CD、内部工具集成。[1]
2025‑06‑18：MCP 实时通信增强
- 支持 SSE / HTTP，提供 /mcp 命令，通过 OAuth 2.0 调远程 MCP 服务，可在 prompt 中引用 MCP 资源。[1]
2025‑06‑30：自定义 Hooks
- 发布 Hooks 系统：可以在 SessionStart / PreToolUse / PostToolUse / UserPromptSubmit / Stop 等事件上挂接脚本，实现自动化工作流。[1][5]
1.0.60（2025‑07‑24）
- 正式把 Hooks 系统 收进 GA 分支：
  - 支持会话初始化脚本、对 Edit/Write 后自动运行 Lint/测试等。
- 命令命名空间与子目录结构完善（如 .claude/commands/frontend/component.md → /frontend:component）。
- MCP 调试体验改善。[3]
1.0.61（2025‑07‑25）
- 新增 /export 导出会话。
- 队列系统优化：Claude 忙碌时按 Enter 将消息入队。
- 改进图片拖放、MCP 稳定性、快捷键（Ctrl+Z 暂停、Ctrl+U 撤销）。[3]
1.0.62（2025‑07‑29）
- 强化长会话稳定性、大代码库内存占用与网络错误处理。[3]

到 1.0.6x，Claude Code 已不仅是“一个模型 + 若干工具”，而是具备 SDK、Hooks、MCP 的 可编程 AI 开发平台。核心主题变成了“上下文工程 + 工作流自动化”。

3. 2.0 时代：多代理、VS Code 原生扩展与 Web 化（2025‑09 ～ 2025‑12）

3.1 2.0.0：VS Code 原生扩展 + 检查点（2025‑09‑29）

根据官方文章与技术解读，[6] 这一版的几个核心变化可以概括为：

原生 VS Code 扩展（Claude Code for VS Code）
- 不再只是“终端旁边开个 VS Code”；而是把 Claude Code 直接嵌入编辑器：
  - 左侧专用侧边栏、内联 diff 显示。
  - 支持 “计划模式（plan mode）”：先看计划再决定是否执行修改。
  - 快捷键（如 Alt+Cmd+K / Alt+Ctrl+K）一键把选中代码发给 Claude。[6]
时间旅行调试 / 检查点系统（/rewind）
- 每次 Claude 修改代码前自动做 checkpoint。
- 三种恢复方式：[6]
  - 仅代码回退
  - 仅对话回退
  - 代码 + 对话一起回到过去
- 恢复点可保留 30 天，适合长任务；只跟踪 Claude 的改动，不取代 Git。
终端 UI 2.0 & UX 提升
- 状态可视化增强（/status）。
- 可搜索的 prompt 历史（Ctrl+R）。
- 背景任务（Ctrl+B）管理长期运行服务。
模型与订阅配套升级
- 默认模型切换到 Sonnet 4.5，可 /model 切换到 Opus 4.1。[6]
- Pro / Max 订阅给出明确 token 预算和“思考时长”配额。
Claude Agent SDK（前身 Claude Code SDK）
- 暴露与 Claude Code 同一套：
  - 上下文管理
  - 权限系统
  - 子代理与 Hook 支持
- 用于构建更通用的“智能体系统”（如合规审计、安全扫描、调试代理等）。[6]

**转折点：**2.0 把“命令行 AI 助手”推到了 IDE 一等公民 + Agent SDK 底座 的层级，为后续的 Web 版和 LSP 集成铺平道路。

3.2 Web 版本与沙箱：2025‑10‑20

2025‑10‑20，Anthropic 发布 Claude Code for Web：[7][8]

访问路径：claude.ai 中的 “Code” 标签，或 iOS App 中的 Claude Code 页签。
形态：异步编码代理（asynchronous coding agent）：
- 你在网页里把一整份需求交给它，它在云端容器中长时间运行、改代码、开 PR。
- 支持将会话与改动 teleport 回本地 CLI 继续。
工作方式：
- 绑定 GitHub 仓库；
- 选择执行环境（完全沙箱 / 仅 allow-list 域名 / 通配 * 域名）；
- 任务结束后自动在仓库开分支，必要时创建 PR。[7]
沙箱与安全：
- 文件系统与网络隔离：
  - 通过外部代理进程控制网络访问，使用 Unix 域套接字与沙箱通信。
  - 默认仅允许安装依赖相关域名，支持自定义 allow-list；可配置“无网络”模式。[7]
- 官方开源了 sandbox runtime 实现（Apache 2 授权）。[7]

**意义：**这一步把 Claude Code 从“开发者本机工具”推到了 云端多人协作 / 安全受控的远程编码环境，类似“云 IDE + AI 代理”的结合。

3.3 2.0.x 后续：LSP 集成与上下文工程（2025‑12）

到 2025‑12，2.0.x 系列进一步强化：

v2.0.73 / v2.0.74（2025‑12‑19 左右）[9]
- 引入 LSP 工具：
  - 提供跳转定义、查找引用、悬停文档等能力。
- 提升 /context 可视化，将上下文按来源、命令、token 用量分组展示。
- 新增 /terminal-setup 支持更多终端（Kitty、Alacritty、Zed、Warp 等）。
- 修复多项插件、渲染细节问题。

从此，Claude Code 不只是“对话式修改文件”，而是能在 LSP 提供的编辑器语义层 之上进行推理与重构，实现“AI 代理 + IDE 原生智能”的组合。

4. 2.1 时代：Skills 热重载与工作流打磨（自 2026‑01‑07 起）

2.1.0 发布（2026‑01‑07） 被多家文章形容为“自发布以来最大更新”[10][11][12]：

4.1 Skills 系统全面升级

自动技能热重载[12]
- 技能目录：~/.claude/skills 或 .claude/skills。
- 新建 / 修改技能文件后 立刻生效，无需重启会话。
技能在分叉子代理上下文中运行（context: fork）[12]
- 可以把资源消耗大、输出嘈杂的技能放在 forked context 中执行，不污染主对话。
frontmatter 支持 agent 字段[12]
- 为单个技能指定执行代理模型 / 类型（例如专门用 Opus 子代理做安全审计）。
生命周期钩子整合
- Skills 可使用 PreToolUse / PostToolUse / Stop 等 Hook 与工具调用流程深度耦合。[12]

这使 Skills 从“被动的说明文档模块”升级为 可编程、可复用的智能工作单元，并通过热重载真正做到“边开发边试”。

4.2 终端 & 输入体验大改

Shift+Enter 多行输入开箱即用[12]
- 在 iTerm2、WezTerm、Ghostty、Kitty 等主流终端无需额外配置。
- Alt+B / Alt+F 等字词级光标移动修复。
- iTerm2 中 Cmd+V 支持图片粘贴。
Vim 动作支持大幅扩展[12]
- 支持 ; / , 重复 f/F/t/T。
- 全面的 yank / paste（y、yy/Y、p/P）。
- 多种 text object（iw / aw / iW / aW 等） + 括号/引号对象。
- / << 缩进，J 行连接等。

对重度终端 / Vim 用户来说，这一波使 Claude Code 更像“一个适配良好的文本编辑器”，而不再是“一个别扭的 CLI 前端”。

4.3 权限与 Bash 安全增强

Bash 权限通配符[12]
- 在 Bash 权限规则中允许 * 模式匹配，如：
  - Bash(npm *)
  - Bash(* install)
  - Bash(git * main)
- 减少逐条配置的摩擦。
计划模式下权限提示简化
- 进入 plan mode 不再频繁打断用户。
安全修复
- 修复 debug 日志中可能泄露 OAuth token / API key / 密码的风险，官方建议组织尽快升级。[12]
- 修复 Bash 命令处理中的命令注入漏洞、tree-sitter 内存泄漏等。

4.4 新设置与多语言支持

语言设置：language[12]
- 可指定 Claude 回答语言，如 "japanese", "spanish", "chinese"，支持“代码英文、解释母语”的混合工作流。
respectGitignore
- 控制 @文件 时是否遵守 .gitignore，细化大仓库中的上下文选择策略。
脱敏与输出控制
- CLAUDE_CODE_HIDE_ACCOUNT_INFO：在录屏/直播场景隐藏账号信息。
- CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS：限制文件读取的 token 输出上限。

这几项实质上是向“大团队 / 企业”场景看齐：多语言协作、安全脱敏与上下文精细化。

三、能力视角：几个关键“质变点”

如果从“能力层级”而不是版本号看 Claude Code 的发展，大致有四个关键跃迁：

从“智能 CLI 助手”到“可持续会话的代理”
- 0.2.x：会话恢复、文件 @ 引用、MCP 初版。[2][3]
- 能处理 30～60 分钟的连续开发任务，而非一锤子买卖。
从“单一 agent”到“可编排的多 Agent 系统”
- 1.0.x：Hooks、MCP、SDK 打好底座。[1][3][5]
- 2.0.x：Subagents、Agent SDK、Plan mode，把复杂任务拆给不同“人格”的子代理。[6][13]
- 2.1：Skills + Hooks + Subagents 深度整合，可构建“任务路由器 + 专家子代理 + 钩子自动化”的流水线。
从“只在本地终端”到“跨 IDE / Web / 移动端的一致体验”
- 1.0.x：VS Code / JetBrains 插件。
- 2.0：VS Code 原生扩展 + 终端 UI 2.0。
- 2025‑10：Web 版 + iOS 支持，用云端沙箱统一执行环境，并可 teleport 回本地。[6][7][8]
从“prompt 工程”到“上下文工程 + 生态工程”
- 通过：
  - CLAUDE.md + Skills 模块化
  - MCP Servers 统一接入外部系统
  - Subagents 按职责分离上下文
  - Hooks 做事件驱动自动化 [13]
- 新的开发范式不再是“写一个超长 prompt”，而是 设计技能 / 子代理 / MCP / Hooks 的组合，让 Claude Code 像“软件工厂”一样持续运转。

四、对开发者的启示：如何顺势用好“这条演进线”

结合上述发展轨迹，如果你今天（2026 年初）要上手或升级使用 Claude Code，比较务实的建议是：

版本层面：至少用 2.0+，能上 2.1 就不要停在 1.x
- 2.0 带来的 VS Code 原生扩展、/rewind、Agent SDK 是质变级别。
- 2.1 的 Skills 热重载、多语言、权限通配符、终端体验，直接决定“你每天用起来顺不顺”。
工作流设计层面：按“工具栈”来规划，而不是只看模型
- 基础：CLAUDE.md + 项目级 .claude/ 配置。
- 自动化：把重复流程封装成 Skills + Hooks（例如保存即测 / 提交前检查）。
- 专长：为测试、性能、架构、安全各自建 Subagents。
- 外部系统：用 MCP 统一接 GitHub、Issue 系统、Playwright 等。
环境选择：本地 CLI vs IDE vs Web
- 本地 CLI：适合重度后端 / DevOps / 终端流。
- VS Code 插件：前端 / 全栈日常开发主场。
- Web 版：多人评审、云端 PR、对安全隔离要求高的场景。

小结

用一句话概括 Claude Code 的发展历程：

它从 2025 年初的“聊天 + 改文件 + 跑命令”的命令行玩具，
在一年多时间里，经由 0.2.x 研究预览 → 1.0 GA → 2.0 多代理 + IDE / Web 深度集成 → 2.1 Skills / Hooks / Subagents 全面打磨，
演化成了一个 以上下文工程和代理编排为核心的、多终端 AI 编程平台。

如果你想进一步研究某一阶段（比如 2.0 的 VS Code 扩展、2.1 的 Skills 热重载），可以从对应版本的 release 说明和社区实践文章入手，围绕 MCP、Skills、Subagents、Hooks 这几个关键词去搭自己的“AI 原生开发流水线”。

References

[1] Claude Code 更新日志（中文节选）. https://blog.csdn.net/m0_52224307/article/details/149518099
[2] Claude 3.7 Sonnet and Claude Code 初始发布信息. https://www.anthropic.com/news/claude-3-7-sonnet
[3] Claude Code Changelog（0.2.x～1.0.x 概览）. https://www.claudecode101.com/en/upgrade
[4] Claude Code 2025 New Features / GA 概览. https://smartscope.blog/en/generative-ai/claude/claude-code-2025-features/
[5] Hooks / MCP / 会话初始化等说明. https://www.claudecode101.com/zh/upgrade
[6] Enabling Claude Code to work more autonomously（2.0 官方说明）. https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously
[7] Claude Code for web — a new asynchronous coding agent. https://simonwillison.net/2025/Oct/20/claude-code-for-web/
[8] Anthropic brings Claude Code to the web. https://techcrunch.com/2025/10/20/anthropic-brings-claude-code-to-the-web/
[9] Claude Code v2.0.74 LSP 更新报道. https://www.how2shout.com/news/claude-code-v2-0-74-lsp-language-server-protocol-update.html
[10] Claude Code 2.1 NEW Features. https://mlearning.substack.com/p/claude-code-21-new-features-january-2026
[11] Claude Code 2.1.0 ships. https://hyperdev.matsuoka.com/p/claude-code-210-ships
[12] Claude Code 2.1.0 详细特性整理. https://hyperdev.matsuoka.com/p/claude-code-210-ships
[13] Understanding Claude Code’s Full Stack: MCP, Skills, Subagents, and Hooks Explained. https://alexop.dev/posts/understanding-claude-code-full-stack/

18 KiB Raw Blame History Unescape Escape