Unexpected status 503 Service Unavailable Codex

Quick fix

配置 v2ray 等代理工具绕过局域网流量，解决 Codex 访问 cc-switch 本地路由时的 503 报错。

Symptom

报错原文复制

Unexpected status 503 Service Unavailable: Unknown error, url: http://127.0.0.1:15721/v1/responses

Cause

在使用 cc-switch 为 Codex 开启本地路由时，如果系统开启了 v2ray 等代理工具，代理可能会拦截发往 127.0.0.1 的本地请求，导致 Codex 无法连接本地服务并报 503 Service Unavailable 错误。此外，部分用户在使用 NVIDIA NIM 接口时遇到了变体错误：由于上游接口不支持 /v1/responses 路径，cc-switch 转发请求时会收到上游返回的 404 Not Found 错误。

Fix

1. 1

   打开 v2ray 或其他代理工具的路由设置，添加绕过局域网（Bypass LAN）和大陆域名的规则，确保发往 127.0.0.1 的本地请求不被代理拦截。

Affected Versions

ToolCodex

Version0.136.0

PlatformsmacOSWindows

Source Issues

本页汇总自 2 个真实 issue

• #3673Unexpected status 503 Service Unavailable: Unknown error, url: http://127.0.0.1:15721/v1/responses
• #6315unexpected status 503 Service Unavailable: Unknown error, url: http://127.0.0.1:12000/v1/responses且模型名称为自定义

FAQ

为什么关闭代理后 503 错误消失，但 curl 测试却失败了？

因为访问外部 API 本身需要代理。直接关闭代理会导致外部请求失败。正确做法是保持代理开启，但设置代理工具绕过局域网（127.0.0.1），让本地流量直连，外部流量走代理。

使用 NVIDIA NIM 时报错 404 Not Found 是怎么回事？

这是由于 NVIDIA 等部分上游提供商的 API 不支持 Codex 调用的 /v1/responses 端点。cc-switch 在转发请求时收到了上游的 404 错误，这属于接口兼容性问题。

相关问题

auth.json又填充了已有账号的auth.json Codex升级到 v3.17.0+，并关闭「非接管切换时保留官方登录」；auth.json 被旧账号/旧 key 覆盖时，先备份再升级验证。22 issues mergedcodex deepseek无法选择模型 cc-switchCodex 桌面端在没有官方 ChatGPT 登录态时会强制隐藏第三方自定义模型：先登录一次官方 ChatGPT，再在 cc-switch 开启「切换第三方时保留官方登录」并重启 Codex 即可恢复模型列表。5 issues merged在实际使用中只显示200K上下文窗口了 - Claude Code在 `~/.claude/settings.json` 中将默认模型改为带 `[1m]` 后缀的变体，或在会话中手动执行 `/model claude-opus-4-8[1m]` 以激活 1M 上下文。5 issues merged