一段 CLAUDE.md 提示词,让 Claude Code/Codex 不再用过时 API
umeshonai · x · 2026-10-26
开发者 umeshonai 分享一个一手踩坑修复：AI 编码 agent（Claude Code / Codex）经常使用已弃用的 API，即使代码库早已迁移——罪魁祸首通常是过时的文档、README、注释和 docstring，agent 会照着旧文档写代码。
解决方案是往 CLAUDE.md / AGENTS.md 里加一段「文档 vs 代码」优先级规则，据称能修复 90% 以上的此类问题：
- 若 README、docs/、注释或 docstring 与现有代码不一致，以代码为准，遵循代码的行为与惯例；
- 除非被要求，不要通过改文档来「修复」这种不一致；
- 在最终回复中列出你注意到的每一处不一致：文档怎么说、代码实际怎么做、位置在哪。
第三点尤其巧妙：让 agent 主动报告文档与代码的偏差，既不静默改文档，也把过时文档暴露给开发者。
「编程与Agent」频道最新
- Ruff 作者感叹:前沿模型能在任何软件里找到无穷多 bug — charliermarsh · 2026-10-26
- 开发者实测同一 skill 跨 Opus 5.5 与 Sol 6.1:指令遵循表现参差 — lucasmeijer · 2026-10-26
- 用小开源模型逆向工程游戏二进制:主 agent 中途重写子 agent 的 harness — yb2698 · 2026-10-26
- ContractSim：首个评估 LLM 自然语言合同谈判的框架 — xuanalogue · 2026-10-26
- OpenAI 计算机使用 agent 团队：速度已逼近超越人类专家 — a16z · 2026-10-26
- Qdrant 推出迁移工具：从 Chroma 一条命令搬迁，无需重新 embedding — qdrant_engine · 2026-10-26