常见问题
其他客户端
Base URL 写法、Cherry Studio、Cursor、CC Switch、magpie 和 Claude Desktop 的常见问题。
报 404，或者地址里出现 /v1/v1
Section titled “报 404，或者地址里出现 /v1/v1”客户端自己会拼 /v1，你又写了一次。按工具对照：
| 工具 | Base URL |
|---|---|
| Claude Code、Claude Desktop、Anthropic SDK | https://2api.dev |
| Codex | https://2api.dev/v1 |
| OpenAI SDK、OpenClaw、ClawX、Cursor | https://2api.dev/v1 |
| Cherry Studio | https://2api.dev |
地址末尾不要带 /chat/completions、/messages 这些路径。
Cherry Studio 获取模型列表失败
Section titled “Cherry Studio 获取模型列表失败”- API 地址只填
https://2api.dev，看地址框下面的预览是不是.../v1/chat/completions。 - 列表拉不出来，点「添加」手动填模型名。
- 用的是 GPT 分组的 Key，提供商类型选 OpenAI。
提示 only allows Claude Code clients 或 Client not allowed
Section titled “提示 only allows Claude Code clients 或 Client not allowed”这个分组只允许官方客户端（Claude Code 或 Codex）调用，Cherry Studio、Cursor 这类第三方客户端会被拒绝。请在官方客户端里用；需要在第三方客户端用 GPT，请用 GPT 分组的 Key。如果是 Codex 本身被拒绝（codex_version_too_low），升级 Codex。
Cursor 怎么接
Section titled “Cursor 怎么接”见 其他 OpenAI 兼容客户端。在 Cursor 里用 GPT，更推荐装 Codex 插件。
CC Switch 点「导入到 CCS」没反应
Section titled “CC Switch 点「导入到 CCS」没反应”本机没装 CC Switch，或者浏览器没允许打开 ccswitch:// 链接。先确认 CC Switch 能正常启动，再点一次导入，浏览器弹窗时选「允许」。
CC Switch 切换后不生效，或者插件和 MCP 配置没了
Section titled “CC Switch 切换后不生效，或者插件和 MCP 配置没了”magpie 测试返回 503 或 502
Section titled “magpie 测试返回 503 或 502”- 503 并提示只允许 Claude Code 客户端：分组限制，Claude Code 里实际使用不受影响。
- 502：多半是代理软件拦了本机地址，给
127.0.0.0/8和::1加直连规则。 - 更多见 magpie 注意事项。
Claude Desktop 找不到第三方推理入口
Section titled “Claude Desktop 找不到第三方推理入口”先确认开了 Help → Troubleshooting → Enable Developer Mode，再找 Developer → Configure third-party inference。还是没有，说明当前版本或账号环境不支持，先用 Claude Code。更多情况见 Claude Desktop。