Claude AI使用指南：技巧与最佳实践

把 Claude API 使用的模型换成新版后，出现 AttributeError: 'ThinkingBlock' object has no attribute 'text'，或者响应的文本变成空的。原因是 Claude 5 及以后的模型即使不写 thinking 也会在需要时思考，响应的第一个块变成了思考块。Claude 4 系列不写就不思考，所以只换模型名，响应的形式就会改变。输入简单时第一个块仍是文本，所以轻量输入的测试会通过。本文根据 Anthropic 的文档和我在自己环境中对 4 个模型的实测（2026 年 11 月 1 日），整理了原因、按类型查找文本块并读取的修复方法（Python、TypeScript）、因 max_tokens 而没有返回文本时的处理、能关闭思考与不能关闭思考的模型，以及在测试中不漏掉的步骤。

把多个站点放进一个仓库，并在每个站点的文件夹里放 CLAUDE.md 或 AGENTS.md，这些规则也不一定会在开始工作前被读取。Claude Code 会在 Claude 读取、写入或编辑启动目录以下某个文件夹中的文件时，加载该文件夹的 CLAUDE.md；Codex 则只在每次运行开始时读取一次从项目根目录到启动目录的 AGENTS.md。本文按相同的项目比较两款工具如何加载这些文件、如何确认是否已加载（/context 只显示启动时加载的内容），然后介绍负责的文件夹之外有改动就停止发布的检查，以及阻止写入的工具设置。此外还介绍如何用远程 URL 和根提交区分名称相似的仓库，以及只显示环境变量名称的命令（2026 年 11 月 1 日确认）。

Claude 的 Max 套餐每月附带 $100 的 API 额度，Ultra 为 $200，Team 合计最多 $500，Free 和 Pro 没有。Gemini 附带 Google Cloud 额度：Google AI Pro 每月 $10，Ultra 5x 每月 $40，Ultra 20x 每月 $100，Plus 没有。自2026年10月28日起，ChatGPT 在 Pro 100、200、500 上每月分别附带 $100、$200、$500，在 Business 上按席位附带额度（合计最多 $500），Go 和 Plus 没有。本文根据三家公司的官方价格页、帮助文章和开发者文档（2026年10月27日确认；ChatGPT 为10月30日确认），按相同顺序对比额度能用和不能用的地方（Claude Code 的使用上限不会改变）、领取方法（Gemini 需要预付 $5）、有效期（Claude 和 ChatGPT 的额度每月失效，Gemini 的额度有效期12个月且可累积）、不订阅套餐也能免费使用的内容（Claude 的试用额度、Gemini 的免费层级、OpenAI 共享数据换取的免费 token），以及发送的内容是否会被用于训练，最后总结选择时的关键判断点。

Anthropic 于 2026年10月26日（美国时间）向美国证券交易委员会（SEC）提交了首次公开募股（IPO）的 S-1 注册声明，并申请以“ANT”为代码在纳斯达克全球精选市场上市。上市日期、发行股数、价格区间和募资金额均未确定。本文依据 S-1 原文，梳理营收（2025 年 45.85 亿美元，2026 年上半年 162.86 亿美元）及亏损背后的原因、五类股票（A、N、T、F、E）及其表决权、长期利益信托（LTBT）与公益公司（PBC）结构如何运作、Amazon 和 Google 的持股、募集资金用途和风险因素。随后依据 SEC 的说明介绍上市步骤、能否以及如何购买该股票（确认于 2026年10月27日），以及这对 Claude 用户意味着什么。本文不构成投资建议，并会在有新信息时随时更新。

“Codex 不说就不并行”在一定条件下是对的：Codex 的应用、CLI 和 IDE 扩展会在你直接要求，或 AGENTS.md 或技能指示委派时启动子智能体（ChatGPT Work 的 Ultra 也会自行判断委派）。Claude Code 则会根据请求和各子智能体的描述自行委派。本文依据 OpenAI 与 Anthropic 的官方文档（2026 年 10 月 26 日确认），比较了触发并行的条件、指示中应写明的五项内容、可直接使用的提示词示例、Codex 的 config.toml 中的 [agents] 与 .codex/agents/ 下的 TOML 文件、Claude Code 的 .claude/agents/ 与环境变量、/subagents、/tasks、/subtask、/batch、/worktree 等命令、适合与不适合并行的任务，以及对用量上限的影响，并分享了本站并行运行子智能体时得到的经验。

“Your credit balance is too low to access the Anthropic API”（在 Claude Code 中显示为“Credit balance is too low”）表示你的 Claude Console 组织的预付额度不足。原因有两种：余额确实不足；或者你本想使用 Pro、Max 等订阅计划，Claude Code 却在用环境变量 ANTHROPIC_API_KEY 中的 API 密钥运行，改成了 API 计费。用 /status 即可区分。本文依据 Anthropic 官方文档和帮助中心（2026年10月26日确认），说明这个错误的显示形式、找出原因的三个问题、如何在 Console 的 Billing 中购买额度并设置自动充值、如何在 macOS、Linux 和 Windows 上删除 API 密钥并在 VS Code 中检查、它与 Max 和 Team 的每月 API 额度及用量额度（usage credits）有何不同，以及相似但不同的错误。

在 Google Cloud 账单下使用 Claude 有两种方式：由 Google 作为 Agent Platform（原 Vertex AI）的一部分提供的 Google 托管版，以及于 2026年10月22日正式发布的 Anthropic 托管版。Claude Code 运行在 Google 托管版上，通过 CLAUDE_CODE_USE_VERTEX 等设置进行配置（面向多人部署时建议固定模型）。如果需要 Files API、Agent Skills、Managed Agents、fast mode 等功能，请选择 Anthropic 托管版。在 Google 托管版的 global 端点上，Opus 5.5、Sonnet 5.5 和 Haiku 5.5 的价格与 Claude API 相同，us 和 eu 多区域则为 1.1 倍。Anthropic 托管版以 CCU 计量，官方文档中没有按 token 计的价目表。本文依据官方文档（2026年10月26日确认），介绍两者的区别与选择方法、价格、区域、开通步骤、SDK、Claude Code 设置，以及配额和 429 错误的处理方法。

Claude API中出现“`temperature` is deprecated for this model.”时，原因是向Claude 4.7及以上模型发送了非默认的temperature、top_p或top_k，从请求中删除这三个参数即可解决。在旧版API版本2023-06-01中，Claude 4.7及以上模型同样不接受非默认值；在新版API版本2026-10-21中，所有模型即使使用默认值也会返回400错误。Python的anthropic 2.0.0等新版SDK会自动发送2026-10-21，且这三个参数已从类型定义中移除，因此继续传入这些参数的代码升级SDK后会出现参数错误或400错误。文章依据Anthropic官方文档（2026年10月26日确认），说明两种出错场景、如何在代码中查找这些参数、各SDK的版本、需要一并修改的内容（如API密钥的传递方式），以及相近错误“anthropic-version: header is required”的解决方法。

运行Claude Code和Codex不需要高性能电脑。两者的模型都在服务器上运行，因此换电脑并不会缩短AI思考和编写代码的时间。官方要求中，Claude Code的CLI需要4GB以上内存、x64或ARM64处理器以及互联网连接，Codex则未公布内存和CPU的具体数字。电脑影响的，是构建、测试、搜索等在本地执行的命令的耗时。本文梳理两款工具的要求、快速模式、各系统沙盒的条件及卡顿时的应对方法，并说明如何自行核实耗时构成，以及换电脑前应确认的三点。

Claude Code 的 /goal 是一个命令：你写下“什么时候算完成”的条件后，另一个小模型会在每轮结束时判定，未满足就让 Claude 继续工作。本文依据官方文档原文，整理设置、确认、取消的方法，判定机制与因错误而停止的情况，条件写法，以及与 /loop 和 Codex 的 /goal 的区别。另外记录了本站用它统一文章句末句号的试用（与普通请求1次对照）：321件也只用1轮结束，额外开销仅为1次判定；数字之外的成品质量，判定角色无法确认。

Anthropic 于2026年10月8日以测试版推出 Claude Dashboards 和 Claude Motion。Dashboards 可在询问公司数据时制作仪表板，Motion 可把报告或图表做成短的说明动画。本文依据 Anthropic 的公告和帮助文档原文（2026年10月22日确认），介绍可连接的数据、查询与验证方式、Motion 的运作方式与导出格式、可用方案（Dashboards 为 Pro、Max、Team、Enterprise，Motion 为 Team、Enterprise）及管理员设置、与 Docs、Slides、Design 的分工，以及适合与不适合的用法。

Claude Duet 是一款应用，Claude 以“主动型智能体”的方式工作：每天早上提供简报，每隔几小时巡查一次，并在云端推进你委托的任务。本文依据 Anthropic 的发布公告和帮助文档（2026年10月22日核实），介绍其功能（Make 与 Tasks 标签页、6,000 多个连接器）、适用人群与费用（美国 Pro 和 Max 用户凭邀请使用，无额外费用，用量上限与 Claude 共用，11月30日前重置用量上限）、在发送、付款、签名和删除前征求确认的安全机制、目前尚不支持的功能、美国以外地区的可用情况，以及与 ChatGPT dot 的区别。