第 21 章 · 近期更新与新特性
本章目标：了解 Claude Code 近一个月的重要版本更新，掌握新特性的使用方法，保持工具链与时俱进。
21.1 版本概览
Claude Code 迭代速度极快（几乎每日发版）。以下是近期值得关注的版本：
| 版本 | 发布日期 | 核心变化 |
|---|---|---|
| v2.1.241 | 近期 | Bug fixes and reliability improvements |
| v2.1.240 | 近期 | Bug fixes and reliability improvements |
| v2.1.239 | 近期 | /claude-api upgrade 命令、Bedrock/Vertex 全屏渲染器 |
| v2.1.238 | 近期 | keybindingFlavor 设置、Plugin marketplace headersHelper |
| v2.1.237 | 近期 | 内置 "Concise" 输出样式、LLM gateway prompt caching 修复 |
21.2 /claude-api upgrade：SDK 迁移助手
v2.1.239 新增了 /claude-api upgrade 斜杠命令，可将 Python 项目从 Anthropic SDK 0.x 自动迁移到 1.x：
> /claude-api upgrade
Analyzing your project...
Found 12 files using anthropic 0.x API patterns.
Key changes:
- anthropic.Anthropic() → anthropic.Client()
- httpx.Timeout → anthropic.Timeout
- completion.model → response.model
Apply changes? [y/N]迁移注意事项：
- 超时类从
httpx.Timeout变更为anthropic.Timeout - 流式回调签名有变化
- 建议先跑测试套件再提交
21.3 keybindingFlavor：快捷键风格
v2.1.238 新增 keybindingFlavor 设置，支持 Bash readline 风格的快捷键：
// ~/.claude/settings.json
{
"keybindingFlavor": "readline"
}设置后 Ctrl+W 在提示符中删除到上一个空白字符（与 Bash 行为一致）。默认值 "classic" 保持不变。
21.4 Plugin Marketplace headersHelper
v2.1.238 为插件市场新增了 headersHelper 机制——当 marketplace URL 需要动态认证头时，可以指定一个命令来生成临时 token：
// marketplace.json
{
"url": "https://internal.company.com/plugins/catalog.json",
"headersHelper": "/usr/local/bin/get-plugin-token"
}该命令仅在安装或更新插件时执行，适合短期令牌场景，避免硬编码长期密钥。
21.5 Concise 输出样式
v2.1.237 内置了 Concise 输出样式。启用后 Claude 会跳过前言和叙述，直接输出结果：
/config → Output style → Concise适合有经验的开发者——减少阅读时间，同时不牺牲代码质量。
21.6 Bedrock/Vertex 支持
同一版本为 Bedrock、Vertex AI 和 Foundry 用户添加了全屏渲染器支持，新安装在这些平台上现在默认进入全屏 TUI。
21.7 LLM Gateway Prompt Caching 修复
v2.1.237 修复了使用自定义 base_url 或 LLM 网关时 prompt caching 失效的问题。如果你的组织通过代理路由 API 请求，升级后将自动享受缓存折扣。
本章小结
- Claude Code 几乎每日发版，关注 changelog 及时获取新功能；
/claude-api upgrade自动化 SDK 迁移，减少手工修改；keybindingFlavor: readline让终端老手更顺手；- Concise 输出样式提升效率，减少无效阅读；
- Plugin headersHelper 支持动态认证，适配企业安全策略。
🧪 随堂测验
点击你认为正确的选项。答错时会展示正确答案与原因解析。
1. /claude-api upgrade 命令的主要用途是什么？
2. keybindingFlavor 设置为 "readline" 后，Ctrl+W 的行为变成什么？
3. Plugin marketplace 的 headersHelper 用于解决什么问题？
4. Concise 输出样式的效果是什么？
🛠️ 动手实践
- 升级到最新版本
npm update -g @anthropic-ai/claude-code，查看 changelog 确认新特性。 - 尝试切换 Concise 输出样式，对比前后对话体验差异。
- 在 settings.json 中设置
"keybindingFlavor": "readline"，验证 Ctrl+W 行为变化。