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

设置ANTHROPIC_BASE_URL、各公司的API密钥和模型名环境变量后，Claude Code也能运行DeepSeek、GLM（Z.ai）、Kimi（Moonshot AI）的模型。它的优点是保留界面、工具和设置，只替换负责回答的模型，适合想降低费用或碰到Claude使用上限时使用，但Anthropic不支持这种用法。本文基于各公司及Anthropic的官方文档（2026年10月19日确认），整理了优缺点、可直接写入settings.json的三家官方设置示例、9个模型每百万token的单价、同一用法下单次会话的估算费用、影响账单的四个因素、DeepSeek自2026年11月1日起按每1,000次成功调用$0.75收取的搜索与抓取费用、与GLM Coding Plan等固定套餐的比较、避免设置失误的注意事项，以及代码发送去向的安全性（包括DeepSeek数据存储在中国及美国政府机构禁止使用的报道）。

Claude Haiku 5.5（claude-haiku-5-5）是 Anthropic 于 2026 年 10 月 7 日发布的轻量模型。单次提示词不超过10万 token 时，每百万 token 输入 $0.10、输出 $0.50，是 Haiku 4.5 的十分之一；超过后变为输入 $0.50、输出 $2.50，从缓存读取的部分也计入长度。上下文窗口为 1M token，最大输出 128K，知识截止于 2026 年 6 月，也是第一款可以选择 effort（默认 medium）的 Haiku。本文依据 2026 年 10 月 15 日对照原文核实的官方文档与发布公告，介绍：按同一文本约多计 30% token 校正后的四款模型费用估算、Anthropic 公布的基准测试该怎么看、与 Sonnet 5.5、Opus 5.5 的选择、思考与 effort 的设定、从 Haiku 4.5 迁移时会返回 400 错误的写法以及不报错但会改变的地方、Claude Code 中 haiku 的指向（v2.1.293 起在 Anthropic API 上为 Haiku 5.5），以及在应用、GitHub Copilot 和云平台上的提供情况。

Claude 的 Max、Ultra 和 Team 套餐每月附带可用于 Claude API 的额度（Max 为 $100，Ultra 为 $200，Team 按席位数计算，合计最多 $500）。不过，在 claude.ai 的账单页面关联 Claude Console 的组织之前无法领取，没用完的部分也不会结转。本文依据笔者于2026年10月10日在 Max 20x（现在的 Ultra）套餐上领取时的界面记录，以及同一天对照原文核实的官方文档、帮助文章和条款整理而成。内容包括：可用的地方（API、Message Batches、Managed Agents、Agent SDK、Playground、用 API 密钥运行的 claude -p）和不可用的地方（Claude Code 的交互使用、应用中的额外用量、Bedrock 等）；在周期中途关联也到账了全额、有效期约为3周后；已关联的组织无法自行更改，一个组织只能领取一个套餐的额度；扣费顺序与自动充值；长期设置 ANTHROPIC_API_KEY 会让 Claude Code 切换为 API 付费的注意事项；用完额度的办法与支出上限；以及不能转让或出售等条款要点。

除 CLI 外，还说明如何在 Codex 应用与 IDE、Claude Desktop、VS Code、Web 及手机端中将其设为仅调查模式。文中涵盖 read-only 与 Plan 的区别、设置的生效与保存范围、工具限制、可直接使用的请求文本以及差异确认方法。

Claude Code 的 mod（Claude Mods）是在 Claude Code 内部运行 JavaScript 或 TypeScript 函数的插件，于 2026年10月1日随 v2.1.287 正式加入。本文依据同年10月5日确认的官方文档原文，介绍由三个文件组成的 mod 如何工作，它与写在 settings.json 中的以往 hooks、技能和 MCP 有何不同，mod 能做什么（在界面中绘制面板、创建无需等待即可运行的命令、拦下工具调用询问用户等），以及运行时间等限制。mod 以你的权限在沙箱之外运行，并且能覆盖权限决定。文中用表格说明：在 Team 或 Enterprise 中，或在有托管设置的电脑上，deny 规则有效；但在个人套餐中，mod 甚至能批准 deny 规则已拒绝的调用。此外还介绍了阅读 Anthropic 三个官方示例 mod 的代码、统计其所用 API 的结果，安装前如何解读 claude plugin validate，如何试用、让 Claude 编写以及关闭 mod，mod 的运行场所和内置 mod，以及安装前检查清单。

只要把代码放在 GitHub 私有仓库、只在该仓库安装 Claude GitHub App，并让生产服务器用只读部署密钥拉取代码，就能把开发工作交给 Claude Code 云端会话，而不给生产环境多开一条入口。本文是我于 2026年10月4日在另一个开发项目上开始使用云端会话的记录，并对照了当日官方文档的原文。文中说明：不用 GitHub 运行 claude --cloud 时，会发送所有分支的历史以及已跟踪文件的未提交更改（在 Windows 上不论文件名）；连接了另一个 GitHub 账号时如何解决；“Only select repositories”以及公开仓库为何出现在列表中；由于使用环境的任何人都能读取环境变量，为什么每个项目都应新建环境；云端看不到本地文件；云端的 Accept edits 遇到每条命令都会停下，而 Auto 会持续推进。这些都汇总成一份开始前的检查清单。本文还分享了一个真实案例：一条指令自主运行，在我中途叫停之前就用掉了 $226 的限时额度，并解释额度消耗如此之快的原因和节省费用的方法。

你在 Claude Code 里的对话会不会被用于训练 AI 模型，取决于套餐和账户设置。在 Free、Pro、Max 个人套餐上，只有 claude.ai 隐私设置中的“用于改进模型”开启时，数据才会用于训练（保存 5 年），关闭后训练停止（保存 30 天）。这个设置属于账户，所以不需要修改运行 Claude Code 的电脑上的配置文件。本文依据 Claude Code 官方文档“Data usage”、Anthropic 隐私中心以及 Claude Platform 页面“API and data retention”截至 2026 年 10 月 4 日的原文，说明设置在哪里、如何关闭，退出不会把数据从过去的训练中移除，👍👎 评分、/feedback 和被标记为违规的对话如何处理，以及包括 Team、Enterprise、API 和 Bedrock 在内的各套餐训练与保存规则。同时解释 API 的输入和输出默认不用于训练、30 天内删除，ZDR 覆盖哪些范围、为什么 Fable 等 Covered Models 需要保存 30 天，用来关闭使用指标和错误报告（与训练无关、另行发送）的环境变量，以明文保存在你自己电脑上的对话记录，以及处理机密工作时该如何选择。

Claude Tag 是 Anthropic 推出的功能：只要在 Slack 频道里输入 @Claude，就能把调研、写文档、定期报告，甚至 GitHub 拉取请求草稿交给 Claude（2026年6月23日发布，公开测试版）。只有 Team 和 Enterprise 组织可以使用；个人 Pro 和 Max 套餐在 claude.ai 上可能会看到提示，但点击后走不下去。我通过在个人 Max 套餐上实际点击后看到的画面，以及官方故障排查页面中对应的那一行，确认了这是设计如此。本文依据截至 2026年10月4日的官方文档原文，整理了能否使用的判断流程、没有 Claude 席位的同事如何在频道里提请求、各类工作从哪里扣费（每月上限选项，以及未连接账号成员私信的 7 天、$50、50 个会话限制）、在频道、私信和群组私信中的用法、频道记忆、用 Routines 实现定时执行和频道监控、切换模型、用 Access bundle 和 Claude 专用账号连接工具、GitHub 和 GitLab 上的 PR 流程与双人审批、访客与 Slack Connect 的处理、数据保留与删除、常见问题与命令，以及与旧版 Claude in Slack、Cowork、Claude Code 的区别。

Claude Code 的 /doctor prompt-audit（/checkup prompt-audit 与之相同）让 Claude 读取 CLAUDE.md、CLAUDE.local.md、AGENTS.md 以及 .claude/ 下的规则、技能、命令和子代理，查找为旧模型写的提示、对不存在的文件或命令的引用和相互矛盾的指令，并返回附带 diff 建议的报告。不开口就不会改任何东西，需要 v2.1.283 及以上。本文依据 2026年10月3日核对的官方文档和 CHANGELOG 原文，以及 Claude Code 内置的审查指南，说明运行方法和用路径缩小范围、它把什么判定为过时（过强的措辞、不存在的路径、文件之间的冲突等）、不删除背景和有理由的禁令的规则、报告的六个字段和置信度的读法，以及它与 /doctor、/claude-api prompt-audit 和终端命令 claude doctor 的区别。还分享了用本站指令文件实测的结果（9 条发现采纳 7 条，其中有一处添加规则后忘了改写说明的真实偏差），以及用量额度、每次结果不同、应用前逐条核实的工夫等注意事项。

提示缓存会复用请求中与之前某个请求开头完全相同部分的计算结果，让这部分输入处理得更便宜、更快。OpenAI（GPT-5.6 及以后）默认启用，最后一次使用后至少保留 30 分钟（可选 12 小时），写入价格为输入价格的 1.25 倍（12 小时为 2.5 倍），读取为 0.1 倍（部分模型更低）。Claude 需要加上 cache_control 才会缓存，默认保留 5 分钟（可选 1 小时），写入为 1.25 倍（1 小时为 2 倍），读取为 0.1 倍（部分模型更低）；本文依据 2026 年 10 月 3 日两家官方文档的原文，比较规格、计算回本次数，并整理不生效的原因以及如何用 usage 字段和诊断功能确认是否命中。

Claude Code 的 /code-review 是一个内置技能，它读取当前分支领先于上游的提交和未提交的修改（或你传入的 PR、分支、路径），查找正确性 bug 并报告。/review 是它的别名，审查以后台子智能体的形式运行，费用计入常规用量。本文依据截至2026年10月2日（级别的说明截至10月14日）的官方文档和 CHANGELOG 原文，说明如何指定审查对象，low（只报把握大的问题）与 medium 到 max（覆盖面更广，但需要甄别结果）怎么选，不指定级别时沿用上次输入的级别这一规则，后台运行时 --fix 的修改无法用 /rewind 撤销这一注意事项，以及 --comment 在 GitHub 和 GitLab 上发布到哪里。文中还介绍了由云端多个智能体只返回经过验证的问题的 ultra（约15到25分钟；Pro 和 Max 有一次性的3次免费机会，之后通常每次花费 $5 到 $25 的用量额度），以及它与 /simplify、/security-review、GitHub 应用版 Code Review、claude-code-action 的区别。最后分享了在本站 AI 图像检查工具的代码上运行一次 /code-review high 的结果（10条结果中有9条是真实的 bug，已全部修复），以及用量消耗、核实结果的工作量、--fix 的撤销方法等缺点。

在 Windows 上，Claude Desktop 无法启动，并显示 “There's a problem with Claude. Reinstall the application from its original install location or contact your administrator.” 这是 Windows 拒绝启动打包应用（MSIX）时显示的提示，Anthropic 的帮助中心和文档都没有解释它，也没有给出解决办法（截至 2026 年 9 月 30 日）。对话框让你重装，但先用 Get-AppxPackage 查看状态，就知道该走哪条路。如果什么也不返回，说明程序包的注册已经消失，直接重装即可。如果 Status 显示 Modified, NeedsRemediation，就先结束残留进程并尝试“修复”，然后用 -DisableDevelopmentMode 重新注册，再用官方安装程序覆盖安装，只有到最后才备份、删除并重装。重装会保留聊天记录和 Claude Code 的对话日志（.claude\projects），但有用户报告桌面应用的会话列表丢失了；claude --resume 仍能打开这些会话。Microsoft 的文档把 Remove-AppxPackage -PreserveApplicationData 限定于开发中的应用，也有报告称它会以 0x80073CFA 失败。文章还整理了 GitHub 报告中出现的诱因：内置浏览器崩溃、应用运行中被自动更新，以及 Cowork 服务注册失败。