本文用于说明如何在常见 AI 客户端中使用 LongCC 中转 API。
如果客户端提示认证失败，优先检查 Key 是否复制完整，前后是否多了空格，或者客户端是否仍在使用旧 Key。
| 客户端类型 | Base URL |
|---|---|
| Claude Code | https://api.longcc.edu.kg |
| Codex / OpenAI 兼容客户端 | https://api.longcc.edu.kg/v1 |
| 手动调用 OpenAI Chat Completions | https://api.longcc.edu.kg/v1/chat/completions |
大多数 OpenAI 兼容软件只需要填写 https://api.longcc.edu.kg/v1，软件会自动拼接 /chat/completions 等路径。
CC-switch 可以集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等工具的供应商配置。
下载地址：https://github.com/farion1231/cc-switch/releases
配置步骤：
如果 Codex 启动时一直显示 Reconnecting 1/5 到 5/5，通常是因为它先尝试 WebSocket，而 LongCC 走标准 HTTP 接口。
请在 ~/.codex/config.toml 的自定义 provider 中加入：
supports_websockets = falseWindows 常见位置：
C:\Users\你的用户名\.codex\config.tomlmacOS / Linux 常见位置：
~/.codex/config.toml配置完成后，彻底关闭 Codex 再重新打开。
Claude Code 通常填写根地址：
https://api.longcc.edu.kg配置文件常见位置：
Windows: C:\Users\你的用户名\.claude\settings.json
macOS/Linux: ~/.claude/settings.json常见配置项如下：
Base URL: https://api.longcc.edu.kg/v1
API Key: 使用 LongCC 后台生成的 API Key如果客户端要求选择模型，请确认该模型在你的 LongCC 分组中可用。
配置成功后应满足两点：
如果客户端能回复但后台没有记录，说明它可能还在走官方接口、旧账号或其它中转地址。