Home → Guides → 把 Claude 桌面端和 Codex 指到 APICLAN

把 Claude 桌面端和 Codex 指到 APICLAN

Q: 该填的地址，以及 /v1 那条规矩

所有请求都必须落在以 /v1 开头的路径上。至于你要不要在客户端里手动把 /v1 打进去，取决于客户端 —— 有的会自己补，有的不会。我们收到的「连不上」里，大多数就是栽在这一处。 填反了，请求会在边缘直接 404，意味着它根本没到网关，也不会出现在你的用量日志里 —— 所以「日志里什么都没有」本身就是症状。地址末尾不要带斜杠。

桌面客户端自己的设置里没有填 base URL 的地方，这份配置由 CC Switch 替你写。下面是该填什么，以及几乎所有配置失败都出在的那两件事。

开始之前

你需要一个有余额的账号和一把 API 密钥。在控制台的「API 密钥」里创建：先选你要调用的厂商 —— Claude 桌面端选 Anthropic，Codex 选 OpenAI —— 再选要从哪个分组扣费。分组决定你的价格，每个模型多少钱见价格页。

一把密钥只属于一个分组。给文本模型建的密钥调不了图片模型，反过来也一样；这种情况返回的是模型 404，而不是权限错误。两边都要就建两把。某把密钥究竟能调什么，永远以带着它请求 GET /v1/models 的结果为准。

该填的地址，以及 /v1 那条规矩

所有请求都必须落在以 /v1 开头的路径上。至于你要不要在客户端里手动把 /v1 打进去，取决于客户端 —— 有的会自己补，有的不会。我们收到的「连不上」里，大多数就是栽在这一处。

客户端	请求地址填什么
Claude Desktop (via CC Switch)	`https://apiclan.us/v1`
Codex / ChatGPT desktop app	`https://apiclan.us/v1`
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	`https://apiclan.us/v1`
Cursor, Cline, Roo Code	`https://apiclan.us/v1`
Claude Code	`https://apiclan.us`
Anthropic SDK	`https://apiclan.us`

填反了，请求会在边缘直接 404，意味着它根本没到网关，也不会出现在你的用量日志里 —— 所以「日志里什么都没有」本身就是症状。地址末尾不要带斜杠。

Codex：现在装在 ChatGPT 桌面客户端里

Codex 已经并入 ChatGPT 桌面客户端。Windows 在微软商店搜 ChatGPT 安装；macOS 到 OpenAI 官网下载。命令行版 Codex 的配置方式相同。

在 CC Switch 里给 Codex 添加一个供应商，粘贴密钥，请求地址填 https://apiclan.us/v1。启用它，然后完全退出 Codex —— 不是关掉窗口 —— 再重新启动。配置只在启动时读取，还在跑的实例会继续用旧设置，看上去就像什么都没生效。

如果你不想用 CC Switch，宁愿直接改配置文件，base URL 和密钥放在哪，都写在快速上手里。

Claude 桌面客户端

先从 claude.com 装好 Claude 桌面客户端，然后在 CC Switch 里配置供应商：

打开 CC Switch，选择 Claude 桌面端，添加新供应商。
名称随便起，把 APICLAN 的密钥粘进 API Key 一栏。
请求地址填 https://apiclan.us/v1 —— 客户端会自己在后面补 /messages。末尾不要带斜杠。
保存，然后启动 Claude 桌面客户端，选一个模型。

如果 CC Switch 让你在「直连」和「模型映射」之间选，先看下一节再决定。这个选项决定了模型选择器能不能用。

模型选择器报网关错误时

提示「连接正常，但供应商拒绝了请求」，问题几乎总是出在模型名上，而不是密钥。桌面客户端发的是它内置的那套模型标识，而网关只能提供上游账号真正有的模型。

解决办法是用模型映射而不是直连：把客户端里的条目映射到本网关实际提供的模型名上。只有当供应商恰好认识客户端发来的那些标识时，直连才成立。

带着你的密钥请求 GET /v1/models，拿到可以映射的那份清单。这份清单是按你这把密钥所在的分组算出来的，是针对你账号的真实答案，不是一份通用目录。

切回官方账号

没有任何东西被永久覆盖。在 CC Switch 里重新启用官方供应商，重启客户端，桌面应用就回到你的订阅上。两套可以一直留着随时切 —— 这里的余额是预付的、不过期，暂时不用的那套留着也不花钱。

还是不行的话

返回 404，用量日志里什么都没有 —— 地址错了。对照上面的表看这个客户端要不要 /v1，并去掉末尾的斜杠。
返回 401 —— 密钥没真正带进请求里。重新粘一次；它很长，复制少了一截和填错的表现一模一样。
同一把密钥，别的模型都行就某一个不行 —— 那个模型在另一个分组里。选对分组再建一把密钥；改权限是解决不了的。

还是卡住？把失败的模型名和大致时间发到 support@apiclan.us，有真人看。

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.