Cline / Roo Code 接入自定义中转 API 全流程：OpenAI 兼容模式、模型映射与连接排错
在 VSCode 中使用热门 AI 编程辅助扩展 Cline（及分支 Roo Code / Kilo Code）接入第三方中转 API 的保姆级配置指南：API Provider 模式选型、Base URL 避坑填写、自定义模型 ID 映射及常见报错排查。
TROUBLESHOOTING & INTEGRATION
知识库
AI API 报错串对照排查、状态码速查与常见客户端接入全流程，按可复核步骤整理。
中转 API 的 Base URL 到底带不带 /v1？主流客户端配置对照与 404 报错排查
配置 Cursor、Claude Code、Cline、Cherry Studio 等接入 OpenAI 兼容中转时，最常遇到的问题就是 Base URL 到底要不要加 /v1。本文给出全客户端配置对照表，拆解 /v1/v1/chat/completions 双重路径成因与 404/405 自检命令。
AI API 流式响应中断与超时（Streaming Timeout）：客户端、网络代理与中转网关分层排查
调用大模型流式输出（SSE stream）时频繁遭遇中途断流、504 Gateway Timeout 或请求卡死？系统拆解客户端缓冲区、Cloudflare 100秒限制、网关反代缓存与本地代理软件四大中断根因与针对性调优方案。
Codex 中转站接入指南：分组、配置与首次对话（2026）
Codex 中转站完整接入教程：中转 API 是什么、怎么选分组、config.toml 的 model_provider 怎么写、如何验证第一次对话成功。含分组倍率对照与常见报错链接，全部步骤实测。
API 中转站倍率与套餐怎么看：Shana 分组、额度与价格速查
看懂中转 API 价格的三件套：分组倍率、额度套餐、直购额度。本文以 Shana API 的真实页面为例，把倍率表、套餐表、模型价格一屏讲清，价格类目全部标注以站内实时为准。
Claude Code 接入 OpenAI 兼容中转：从 Key 到第一次对话
Claude Code 接入 OpenAI 兼容中转的分阶段实操：准备 Key/Base URL/模型名三件套，环境变量直连快速验证，CC Switch 长期管理，以及模型列表与分组的关系。全部步骤在真实环境跑通，附真实返回结果。
CC Switch 切了没反应：一份生效排查清单
CC Switch 里明明切换了供应商，Claude Code / Codex 却还在走旧配置？按本清单逐项排查：环境变量残留、CLI 进程快照、配置文件写错位置、新供应商本身不可用，每步附验证命令，十分钟后要么修好、要么拿着证据去反馈。
Codex 报 insufficient_quota 决策树：两大分支，四条叶子
Codex 报 insufficient_quota / You exceeded your current quota 的决策树排查：先分清官方订阅还是中转 API Key，再按余额、额度池、Base URL 指向、模型倍率四条叶子逐层定位，每步附核对方法。
Claude Code 连不上 API：6 个报错串对照排查
Claude Code 连接自定义 Base URL 时最常见的 6 个报错串：Invalid API key、401 authentication_error、404 model not found、Connection error、429 rate_limit、SSL 证书错误。每条给出真实原因、自查顺序和可直接复制的核对命令。
中转 API 常见 429/502/530 状态码速查表（附自检命令）
调用 AI API 中转时最常撞见的三个状态码：429（限流/额度）、502（网关上游异常）、530（边缘到源站中断）。每个码一屏讲清：责任在哪边、该等还是该查、附可直接复制的自检命令，另附 500/503/504/52x 速查行。