纯度AI标签：排错
带有“排错”标签的文章共 33 篇（教程 31 篇、指南 2 篇），最近更新于 。
- 通过中转站用 Claude API：哪些功能能用，哪些不能，附一个自测脚本教程 · Claude Code · 约 19 分钟
自己写程序调 Claude 的接口，走中转站时哪些功能和官方一样、哪些用不了、哪些看着成功其实没生效。本站把这个系列在一家中转站上实测到的出入汇成一张表，分成四类讲怎么应对，并给出一个 25 个请求的自测脚本，换成你的地址和 key 就能照着测一遍。
- 把代码升级到 Claude 5.5 这一代要改什么：四个模型的不兼容改动和一份检查清单教程 · Claude Code · 约 12 分钟
把模型名换成 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.1，有几处老写法会直接报 400：强制调用工具、关掉思考、预填回答。还有几处不报错但结果变了：回答的第一块可能是空的 thinking，max_tokens 可能被思考用光。本文按官方迁移指南整理，能试的都通过中转站实测过。
- Claude API 的报错、限流和停止原因：每个状态码和 stop_reason 是什么意思，通过中转站时哪些不一样教程 · Claude Code · 约 13 分钟
调 Claude 的接口时，请求没成功是一回事，成功了但回答停得不对是另一回事。本文整理官方的十一个报错状态码、两种限额、七个停止原因和拒答的处理办法，并通过中转站用 Python SDK 把能触发的都触发了一遍：报错的类型名、限流的响应头、停止序列等好几处和官方文档不一样。
- Claude Code mod 的测试和排错：不开会话就能跑的测试，以及 mod 没反应时从哪查教程 · Claude Code · 约 13 分钟
mod 出了错不会让会话崩掉，它只是被悄悄跳过，看上去像什么都没做。本站用官方教程的示例 mod 实测了两件事：用 claude plugin test 写不开会话、不联网的测试，三个测试 0.67 秒跑完；再把 mod 故意弄坏五种方式，记下静态检查查得出哪几种、哪几种要到运行时才报、报错出现在哪。
- Claude Code 的网络和数据：代理怎么配，它实际连了哪些地方，你的代码和对话去了哪教程 · Claude Code · 约 10 分钟
本站在代理后面跑 Claude Code，记下它实际连的主机：即使模型请求走中转站，一句话的工夫它还连了五次 api.anthropic.com；设一个环境变量后只剩中转站。附代理配错的三种表现（非交互模式下会一声不吭地卡两分钟以上）、证书和防火墙要放行的地址，以及对话和代码存在哪、存多久、哪些会被发出去。
- Claude Code 插件进阶（上）：代码智能插件实测，装之前怎么审，不工作怎么查教程 · Claude Code · 约 11 分钟
代码智能插件把语言服务器接给 Claude：改完代码自动拿到类型错误，按符号找定义和引用。本站用 TypeScript 实测，连踩三个坑才跑通，并发现第一次编辑的诊断要等到下一步才到。后半篇讲装一个插件之前怎么看清它会在你机器上运行什么，以及卸载之后还留下什么。
- Claude Code 的设置文件：四个文件各管什么、谁盖过谁、怎么确认生效教程 · Claude Code · 约 11 分钟
改了设置没反应，多半是写错了文件，或者被更高一层盖住了。本站实测了项目共享、项目本地和命令行三层的先后，权限规则跨文件合并，哪些值写在项目文件里不生效，以及设置写坏时的表现：多一个逗号整份文件作废，键名拼错则一声不吭。附 ~/.claude 目录里它自己存了哪些数据。
- Claude Code 常见报错怎么查：连不上、401、模型不可用、配置不生效教程 · Claude Code · 约 15 分钟
报错分三类：装不上、请求报错、配置不生效。本站用假地址和假 key 把常见的请求报错逐个复现，记下原文和原因。两个容易误判的：接口地址多写一级 /v1，报的是“模型有问题”；settings.json 写坏了，claude -p 照常运行、没有提示。附 claude doctor、--debug 的用法。
- 通过中转站用 Claude Code：哪些功能和直连一样，哪些不一样，出了问题怎么判断是谁的教程 · Claude Code · 约 12 分钟
Claude Code 官方有一份写给网关的兼容性说明：哪些请求头和字段必须原样转发，漏了会坏什么。本站对照这份说明，在一家中转站上把十几项功能实测了一遍：大部分正常，遇到过三处不一样的地方，其中子代理换模型后主会话报 400 的一处，中转站已经修好。附判断问题出在哪一方的办法。
- 用 Claude Code 修 bug：从一条报错到带回归测试的修复教程 · Claude Code · 约 9 分钟
一个启动就崩的应用，报错出在依赖包里，根因在自己的代码里。本站用同一个 bug 实测了两种问法：把现象、复现办法和做完的标准说清楚，和只说一句“修一下”。两次都修对了，差别在有没有回归测试、改动能不能回退。附一份提 bug 的提示词模板。
- DeepSeek Harness 在国内网络下怎么用：代理要设环境变量，哪些请求不走代理教程 · DeepSeek Harness · 约 6 分钟
按 DeepSeek Harness 官方文档整理：dsh 不读操作系统的代理设置，只认 HTTP_PROXY、HTTPS_PROXY 这些环境变量，所以常见的情况是浏览器能上、它连不上。讲清变量设在哪里、不支持 SOCKS、哪些地址要直连、哪些请求本来就不走代理，以及怎么验证。
- DeepSeek Harness（dsh）接入中转站：添加自定义模型 API，协议和地址怎么填教程 · DeepSeek Harness · 约 9 分钟
按 DeepSeek Harness 官方文档整理：在“设置 → 模型”里添加模型提供商，切换到“自定义模型 API”，填 Provider ID、中转站地址、协议和 key，再加上模型。讲清三种协议怎么选、密钥存在哪里、中转站拒绝请求时改哪两个兼容开关，以及常见报错怎么查。
- 接入中转站的通用方法：三种接口、地址填到哪一级、怎么先验证指南 · 约 10 分钟
不管接哪个工具，改的都是接口地址、key 和模型名三样。本文讲清中转站常见的三种接口各是什么、同一个地址为什么有的工具带 /v1 有的不带，并列出各工具和 OpenAI、Anthropic SDK、LangChain 等框架的写法，以及怎么用 curl 先验证、报错怎么对照。
- Chatbox 接入中转站：添加自定义的模型提供方，电脑和手机都能用教程 · Chatbox · 约 5 分钟
按 Chatbox 官方文档整理：在设置的“模型提供方”里点添加，选 API 类型，填中转站的 key 和主机地址，加上模型后点“检查”。讲清 API 主机和路径怎么分、模型能力怎么勾、一键导入配置要注意什么，以及检查失败时各个错误码的含义。
- Cherry Studio 接入中转站：添加自定义服务商，地址填到哪一级教程 · Cherry Studio · 约 5 分钟
按 Cherry Studio 官方文档整理：在“模型服务”里添加自定义服务商，填中转站的 key 和地址，获取模型列表后打开启用开关。讲清地址为什么通常只填根地址、什么时候在末尾加
- 沉浸式翻译接入中转站：自定义接口地址要写完整路径教程 · 沉浸式翻译 · 约 5 分钟
按沉浸式翻译官方文档整理：在翻译服务里填中转站的 key、模型名和自定义接口地址，就能用中转站的模型翻译网页。和多数工具不同，这里的地址要写到 /v1/chat/completions 为止。讲清两种填法、出现 429 时怎么调请求数，以及翻译这种用法要留意的费用和隐私。
- LobeHub 接入中转站：在 AI 服务商里填代理地址，自己部署的用环境变量教程 · LobeHub · 约 5 分钟
按 LobeHub 官方文档整理：在应用设置的“AI 服务商”里选 OpenAI 或 Anthropic，填中转站的 key 和代理地址，点“检查”后启用模型。讲清代理地址要不要带 /v1、自己部署时用哪几个环境变量、模型列表怎么增减，以及回复为空、检查失败怎么查。
- NextChat 接入中转站：设置里填接口地址，自己部署的用 BASE_URL教程 · NextChat · 约 5 分钟
按 NextChat 的官方说明整理：在客户端的设置里选模型服务商，填中转站的接口地址、key 和自定义模型名；自己部署时用 BASE_URL、OPENAI_API_KEY、CUSTOM_MODELS 几个环境变量。讲清地址为什么不带 /v1、模型列表怎么增减、为什么一定要设访问密码。
- Claude 桌面应用接入中转站：在第三方推理设置里填网关地址和 key教程 · Claude Code · 约 6 分钟
按 Claude 官方文档整理：桌面应用不读环境变量和 settings.json，要打开开发者模式，在 Configure Third-Party Inference 里选 Gateway 并填中转站的地址和 key。讲清中转站要满足什么条件、认证方式怎么选、模型列表为什么是空的，以及接入后哪些功能不可用。
- Cline 接入中转站：OpenAI Compatible 和 Anthropic 两种填法教程 · Cline · 约 4 分钟
按 Cline 官方文档整理：在设置里把 API Provider 选成 OpenAI Compatible，填地址、key 和模型名，就能让 Cline 走中转站；用 Claude 时也可以选 Anthropic 并勾选自定义地址。讲清两种填法怎么选、模型参数怎么设，以及工具调用失败、模型不存在等问题怎么查。
- Cursor 能不能接中转站：自带 key 的范围、限制和替代办法教程 · Cursor · 约 5 分钟
对照 Cursor 官方帮助页整理：Cursor 支持填自己的 API key，但官方只列了 OpenAI、Anthropic 等几家，没有写怎么改接口地址；自带的 key 只对对话模型有效，补全照旧，请求还要经过 Cursor 的服务器。讲清这些限制，以及想在 Cursor 里用中转站时更稳的替代办法。
- VS Code 的 Copilot 对话接入中转站：用 Custom Endpoint 添加自己的模型教程 · GitHub Copilot · 约 6 分钟
按 VS Code 官方文档整理：在语言模型管理里添加 Custom Endpoint，填中转站的地址、key 和模型名，就能在 VS Code 的对话里用中转站的模型，不需要 GitHub 账号和 Copilot 订阅。讲清配置文件怎么写、地址和认证头怎么定，以及哪些功能不走这条线路。
- Zed 接入中转站：在 Agent 设置里添加 OpenAI 或 Anthropic 兼容的供应商教程 · Zed · 约 4 分钟
按 Zed 官方文档整理：在 Agent 设置里点 Add Provider，或者在 settings.json 里加一段配置，就能让 Zed 的智能体走中转站。讲清 OpenAI 兼容和 Anthropic 兼容两种写法、key 存在哪里、模型能力怎么声明，以及哪些功能不走这条线路。
- Hermes Agent 接入中转站：自定义接口的三种配法和上下文长度的要求教程 · Hermes Agent · 约 6 分钟
按 Hermes Agent 官方文档整理：运行 hermes model 选“Custom endpoint”，填地址、key 和模型名，就能让 Hermes 走中转站。讲清配置文件怎么写、同时配多个中转站的办法、Anthropic 格式的接口怎么接，以及它要求模型至少有 64,000 token 上下文这件事。
- OpenClaw 接入中转站：自定义供应商怎么配，三种接口各填什么教程 · OpenClaw · 约 7 分钟
按 OpenClaw 官方文档整理：用安装向导或者在 openclaw.json 里加一个自定义供应商，就能让 OpenClaw 走中转站。讲清三种接口类型怎么选、地址和 key 怎么填、模型要声明哪些信息、怎么设成默认模型并验证，以及控制花费要注意的地方。
- WorkBuddy 接入中转站：自定义模型怎么添加，接口地址怎么填教程 · WorkBuddy · 约 5 分钟
按腾讯 WorkBuddy 官方文档整理：在设置的“模型”里添加一个自定义模型，填接口地址、API key 和模型名，就能让 WorkBuddy 走中转站。讲清地址要不要写完整路径、“自定义协议”开关什么时候开、几个能力选项怎么勾，以及模型不出现、请求失败怎么查。
- GPT 中转站背后是不是 Claude：自己从响应的字段里看指南 · Codex · 约 4 分钟
有的中转站把 GPT 的请求转给别家的模型，再把格式改回来。这种转换有时会在响应里留下痕迹。本文讲清 OpenAI 两种接口各自正常的响应长什么样、哪些字段不该出现、怎么用一条命令自己看，以及这个办法查不出什么。
- Claude Code 接入中转站：两个环境变量、settings.json 的写法和常见报错教程 · Claude Code · 约 8 分钟
按 Claude Code 官方的网关文档整理：接入中转站只需要接口地址和 API key 两样，先在终端里临时设置并验证，再写进 settings.json。讲清凭据该放哪个变量、VS Code 扩展和桌面应用怎么单独设置，以及 401、404、认证冲突等报错怎么查。
- Codex 接入中转站：config.toml 里自定义供应商的写法、验证和常见问题教程 · Codex · 约 6 分钟
按 Codex 官方的网关文档整理：在 config.toml 里加一个自定义供应商，把 key 放进环境变量，就能让 Codex 走中转站。讲清中转站必须支持 Responses API、配置文件里顶层项的位置、怎么验证，以及供应商不生效、认证失败、流式卡住等问题怎么查。
- opencode 接入中转站：自定义供应商怎么写，地址为什么要带 /v1教程 · opencode · 约 5 分钟
按 opencode 官方的供应商文档整理：用 /connect 存下 key，再在 opencode.json 里加一个自定义供应商，就能让 opencode 走中转站。讲清三种接口格式各用哪个包、地址要带 /v1、key 怎么不写进文件，以及找不到模型、404 等问题怎么查。
- OpenAI 提示词缓存怎么用：30 分钟有效期、缓存断点和未命中诊断教程 · Codex · 约 11 分钟
按 OpenAI 官方文章和文档整理 GPT-6 系列的新版提示词缓存：缓存读取最低是输入价的 5%，写入是 1.25 倍，有效期至少 30 分钟。讲清哪些改动会让缓存失效、显式断点怎么放、怎么用诊断工具查出未命中的原因。
- 两周把 claude.ai 提速 3 倍：和 Claude 一起做性能优化的方法教程 · Claude Code · 约 11 分钟
根据 Anthropic 工程师的文章整理：他们在一个 Slack 频道里和 Claude 协作，两周合并三千多个改动，把 claude.ai 的核心体验提速约 3 倍，没有出过事故。讲清“先找到能数的指标”的思路、每个线程的循环、护栏和人的分工。
- Claude Code 安装教程：Mac、Windows、Linux 的安装、验证、更新和卸载教程 · Claude Code · 约 7 分钟
按官方文档整理的 Claude Code 安装步骤：三种系统各用哪条命令、装完怎么验证、第一次怎么登录、怎么更新和卸载，以及安装时最常见的几个报错是什么意思。