Claude Code v2.1.32 发布说明 – 实用技巧整理

进入正题

因为我主要使用 Claude Code 作为开发工具,所以养成了发布说明一出来就立刻查看的习惯。2 月 5 日发布了 v2.1.32,这次更新有很多实在的变化,所以想整理一下。

如果仅仅是“添加了这些功能”就太无聊了,所以我会一起写一些实战应用技巧,介绍一下实际该如何使用。希望能对大家有所帮助。


1. 新功能

A. 支持 Claude Opus 4.6 模型

添加了最新的 Opus 模型。可以在 Claude Code 中使用 --model 选项选择,也可以设置为默认值。

使用技巧:模型使用策略

不必所有任务都使用 Opus。根据情况分开使用,既能节省成本,又能保证速度。

情况 模型 理由
架构设计、复杂的重构 Opus 需要掌握广泛的上下文 + 精确的判断
简单的 Bug 修复、代码格式化 Sonnet 快速且便宜,这样就足够了
文件浏览、以搜索为主的任务 Haiku 作为子代理运行速度快

在 Plan 代理中进行设计时使用 Opus,实际修改代码时使用 Sonnet,这样组合使用性价比很高。

B. Agent Teams (研究预览)

多个代理互相发送消息并协作的功能。目前还处于实验阶段,需要设置环境变量。

# 激活 Agent Teams
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

使用技巧:在什么情况下有用

说实话,目前消耗的 Token 太多,日常使用会有负担。但在以下情况下可以尝试使用。

  • 大规模多模块重构:修改模块 A 时,模块 B、C 也需要连锁更改时
  • API 规格变更:后端 DTO 更改时,需要同时修改 Remote → Data → Domain → Presentation 所有层时
  • 迁移任务:例如 Gson → Kotlin Serialization 等涉及整个项目的任务

与现有的 Task 代理(子代理)的区别在于,Task 是单向委托任务,而 Agent Teams 是代理之间可以相互通信。由于目前还是研究预览,建议用于实验目的,而不是用于生产任务。

C. 自动内存 (Auto Memory)

我个人认为这是本次更新中最实用的功能

Claude Code 会自动将工作过程中学到的内容记录到 MEMORY.md 文件中,并在下次对话中参考。存储在项目目录中的 .claude/projects/.../memory/ 路径下。

使用技巧:内存管理方法

如果放任不管,内存可能会被不必要的内容填满。这样管理会有帮助。

# MEMORY.md (保持在 200 行以内)

## 项目结构
- feature 模块是 Compose,comics 模块是 XML + DataBinding
- Remote API 必须返回 DataResponse<T>

## 经常犯的错误
- 不能不使用 safeApiCall 直接使用 try-catch
- 不要在 ViewModel 中直接使用 viewModelScope.launch,而要使用 onMain/onIO

## 详细笔记链接
- 构建问题: debugging.md
- 代码模式: patterns.md

关键是MEMORY.md 超过 200 行就会被截断,因此要保持简洁,并将详细内容分离到单独的文件中。这与在 CLAUDE.md 中编写项目规则类似,但 MEMORY.md 的不同之处在于,Claude 会自动学习并积累内容。

D. “Summarize from here” 功能

可以在消息选择器中从特定点开始总结对话

使用技巧:上下文管理

使用 Claude Code 工作时间长了,就会出现上下文窗口不足的情况。以前只是简单地开始一个新的会话,或者交给自动压缩,但现在可以根据所需的点进行总结。

这种模式很有效。

  1. 完成探索/调查阶段(读取文件、掌握结构)
  2. 在这里执行“Summarize from here”
  3. 开始实现阶段(探索结果压缩成摘要,专注于代码修改)

在不必要的探索日志占用上下文的情况下,核心信息也能得到保留,因此提高了实现质量。

E. 自动加载 –add-dir 技能

使用 --add-dir 添加的目录中的 .claude/skills/ 文件也会被自动识别。

使用技巧

可以将通用技能集中在单独的目录中,并使用 --add-dir 将其加载到每个项目中。通过这次更新,技能也会被自动加载,因此命令的重用变得更加方便。


2. Bug 修复

A. 修复 @ 文件自动完成路径

如果在子目录中运行 Claude Code,则在引用 @ 文件时,相对路径会出现问题。例如,如果在 feature/offerwall/ 中运行,则无法正确捕获 @src/main/... 路径,但这个问题已得到修复。

B. Bash heredoc 模板字面量错误

这是我亲身经历过的问题,所以很高兴看到这个问题得到修复。如果在 Bash 工具的 heredoc 中包含 JavaScript 模板字面量(例如 ${index + 1}),则会发生 “Bad substitution” 错误。原因是 Shell 将 ${} 解析为变量替换,但现在可以正确地进行转义处理。

# 之前:如果 heredoc 中有这样的代码,则会发生错误
cat <<EOF
const item = items[${index + 1}]  // Bad substitution!
EOF

# v2.1.32: 正常运行

C. 泰语/老挝语元音渲染

修复了输入字段中泰语元音损坏的问题。(对韩语用户没有直接影响,但在处理多语言相关任务时,了解一下也很好)

D. [VSCode] 修复斜杠命令错误

修复了在 VSCode 中输入文本后按 Enter 键时,斜杠命令执行错误的问题。如果有人使用 VSCode 扩展来使用 Claude Code,那么会感受到这个修复。


3. 改进事项

A. –resume 自动重用代理

使用 --resume 继续之前的对话时,会自动重用该对话中使用的 --agent 值。

使用技巧

在创建和使用自定义代理的情况下很有用。例如,如果使用代码审查代理进行工作,然后中断会话,稍后使用 claude --resume 继续,则会自动恢复审查代理设置。以前需要再次附加 --agent 标志。

B. 扩大技能字符预算

分配给技能描述的字符预算已扩大到上下文窗口的 2%。这对注册并使用大量技能的人来说是个好消息。如果使用较大的上下文窗口,则可以容纳更多未被截断的技能描述。

C. [VSCode] 对话列表加载微调器

虽然很小,但在加载过去的对话列表时添加了加载微调器。从 UX 改进的角度来看。


4. 更新应用流程

顺便分享一下在确认发布说明后应用的顺序。

# 1. 更新
npm update -g @anthropic-ai/claude-code

# 2. 确认版本
claude --version

# 3. MEMORY.md 初始设置 (首次使用 Auto Memory 时)
# 在 .claude/projects/.../memory/MEMORY.md 文件中编写项目核心规则摘要
# Claude 会自动添加,但如果设置初始值,则方向性会更好

# 4. 测试新功能
# 通过简单的任务确认 Opus 4.6 的性能
claude --model claude-opus-4-6 "请分析一下这个项目结构" # 请分析一下这个项目结构

总结

v2.1.32 给人的感觉是提高了实际使用质量的更新,而不是华丽的大型功能。特别是 Auto Memory 和 Summarize from here 是直接解决长时间会话的固有问题(上下文不足、丢失上下文)的功能,因此会经常使用。

Agent Teams 虽然还处于实验阶段,但方向本身很有趣。如果代理之间协作的结构稳定下来,我认为可能会改变大规模代码库工作的格局。

还有 heredoc Bug 修复……说实话,因为我曾经因此踩过坑,所以这是我个人最欢迎的修复。

希望这篇文章能对使用 Claude Code 的人有所帮助。

发表评论