只写实测过的步骤
每篇的截图与命令来自真实环境复现，敏感字段一律打码；做不到实测的断言会标注「以官方文档为准」。
KB · AI API 接入与排错知识库
先把一个报错讲清楚，再把一次接入走通
Shana KB 知识库：AI API 报错串对照排查、429/502 状态码速查，以及 Cherry Studio、Cline、Chatbox 等客户端接入 OpenAI 兼容自定义 Base URL 的完整流程，全部按可复核步骤整理。
WHY KB
把报错讲清楚，把接入走通
一个页面只解决一个问题
报错排查文按报错串定位，接入文按客户端定位；先给答案和自查顺序，再展开原因。
随版本滚动复测
客户端与模型版本更替后，旧步骤会复测并更新日期；改日期不改内容的事不做。
LATEST GUIDES
近期更新
2026-09-13
CC Switch 切了没反应：一份生效排查清单
CC Switch 里明明切换了供应商，Claude Code / Codex 却还在走旧配置？按本清单逐项排查：环境变量残留、CLI 进程快照、配置文件写错位置、新供应商本身不可用，每步附验证命令，十分钟后要么修好、要么拿着证据去反馈。
阅读全文 →2026-09-13
Codex 报 insufficient_quota：3 种真实原因与自查顺序
Codex 报 insufficient_quota / You exceeded your current quota 的决策树排查：先分清官方订阅还是中转 API Key，再按余额、额度池、Base URL 指向、模型倍率四条叶子逐层定位，每步附核对方法。
阅读全文 →2026-09-13
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 证书错误。每条给出真实原因、自查顺序和可直接复制的核对命令。
阅读全文 →2026-09-13
中转 API 常见 429/502/530 状态码速查表（附自检命令）
调用 AI API 中转时最常撞见的三个状态码：429（限流/额度）、502（网关上游异常）、530（边缘到源站中断）。每个码一屏讲清：责任在哪边、该等还是该查、附可直接复制的自检命令，另附 500/503/504/52x 速查行。
阅读全文 →START NOW