常见问题

网络与报错码

代理干扰、429、503、529 和超时，按报错内容对号入座。

浏览器能打开 2api.dev，终端里却连不上

报错类似 ConnectionRefused、ECONNRESET、Unable to connect to API。终端不一定走系统代理，或者代理变量指向了已经关掉的端口。

能直连 2api.dev 的话，让它绕过代理：代理软件里加一条 2api.dev 直连规则，或者设置 NO_PROXY=localhost,127.0.0.1,2api.dev。
必须走代理的话，在同一个终端里设置 HTTPS_PROXY 和 HTTP_PROXY。Claude Code 可以直接写进 settings.json 的 env。
用 curl 在同一个终端里跑一次自检命令确认。
用 magpie 或 CC Switch 路由模式时，代理软件不能拦截 127.0.0.1。

看报错里的说明属于哪一种：

报错内容	意思	怎么办
`Concurrency limit exceeded`	同时进行的请求太多（开了很多会话或子代理）	少开几个会话，稍后重试
`requests-per-minute limit exceeded`	每分钟请求数超限	等一会儿再试
`All available accounts are currently rate-limited`	上游暂时限流	稍后重试，或换个模型
`daily usage limit exceeded`	月卡当天额度用完	等第二天 0 点，或改用余额
`api key 日限额已用完`、`额度已用完`	Key 上你自己设的限额	在「API 密钥」里改限额

上游这个模型暂时忙不过来，客户端这边改配置解决不了。稍等几分钟再试，或者用 /model 换一个模型。持续很久请联系客服。

偶尔超时可以直接重试。大请求每次都 504，是服务端超时，请记下时间联系客服。Claude Code 可以把 API_TIMEOUT_MS 调到 900000，Codex 可以调大 stream_idle_timeout_ms。