常见问题
先看报错里有没有数字（如 401、403、404、429）和英文关键词，在下面的表里对照着找。还是解决不了，把报错截图（先把密钥打码）发给客服。
安装时的问题
| 现象 | 怎么办 |
|---|---|
macOS 提示 command not found: claude 或 command not found: codex |
运行 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc，再重开终端 |
| Windows 提示"无法将 claude 项识别为 cmdlet、函数……" | 安装完要关掉 PowerShell 重新打开。还不行，按 Claude Code 页 的提示把路径加进系统 |
| Windows 提示"在此系统上禁止运行脚本" | 用本指南给的命令原样运行；Codex 的安装命令已经带了 -ExecutionPolicy ByPass |
| 安装命令卡住不动，或下载失败 | 检查网络，换个网络再试；公司网络可能拦截了下载 |
启动后要求登录
| 现象 | 怎么办 |
|---|---|
| Claude Code 启动后要选登录方式 / 要登录 Anthropic | 配置文件没写对。在终端运行 cat ~/.claude/settings.json（Windows：Get-Content $env:USERPROFILE\.claude\settings.json），对照 写配置 检查地址和密钥 |
| Codex 启动后要求登录 ChatGPT | 配置文件没被读到。检查 ~/.codex/config.toml 是否存在，开头三行（model_provider 等）是不是在文件最上面，requires_openai_auth = false 是否还在 |
| Claude Code 桌面版还是只有登录页 | 重新打开 Developer → Configure Third-Party Inference… 检查配置，点 Save & Restart |
小贴士
Claude Code 如果确认配置没问题、仍然要求登录，可以再加一个保险设置：打开（没有就新建）用户文件夹下的 .claude.json 文件，确保里面有 "hasCompletedOnboarding": true 这一项，然后重新启动。
报错代码对照
| 报错里有 | 意思 | 怎么办 |
|---|---|---|
401、INVALID_API_KEY、Invalid API key |
密钥不对 | 回网站「API 密钥」页重新复制，确认填的是自己的密钥，不是 sk-你的密钥 这几个字，前后没有多余空格 |
401、API_KEY_DISABLED |
密钥被禁用了 | 网站「API 密钥」页，在这把密钥那一行点「启用」 |
403、INSUFFICIENT_BALANCE、billing_error |
余额不足 | 到网站「兑换」页充值 |
403、API_KEY_EXPIRED |
密钥过期 | 新建一把密钥，重新写配置 |
403、ACCESS_DENIED、Your IP is |
密钥开了 IP 限制 | 网站「API 密钥」页编辑这把密钥，关掉「IP 限制」 |
403、GROUP_DISABLED、not assigned to any group |
密钥的分组不能用了 | 在密钥列表里给它换一个分组 |
404、model_not_found、is not available for this group |
你的分组里没有这个模型 | 换成分组里有的模型（Claude Code 用 /model 换；Codex 改配置里的 model 和 review_model） |
404 page not found（只有这一行字） |
地址写错了 | Claude Code / Claude Code 桌面版填 https://demo.aiplayer.club，结尾不要 /v1；Codex 填 https://demo.aiplayer.club/v1 |
429、rate_limit、Concurrency limit、Too many |
请求太多太快 | 等一两分钟再试 |
429、QUOTA_EXHAUSTED、限额已用完 |
密钥设置的额度或限额用完了 | 网站「API 密钥」页编辑这把密钥，调高或关掉额度限制 |
502、503、529、overloaded、upstream_error |
服务端临时故障 | 稍等几分钟再试；一直不好请联系客服 |
其他问题
改了配置，但好像没生效？
退出工具（命令行版输入 /exit 或连按两次 Ctrl + C；桌面版彻底退出），关掉终端窗口，重新打开再试。
想换一把密钥？ 重新做一遍对应工具的「写配置」那一步，命令会覆盖旧配置。
一把密钥能同时给几个工具用吗？ 能。但建议每个工具单独一把，方便在「使用记录」里分清花费。
怎么看花了多少钱？ 网站左侧「使用记录」里有每次调用的明细和费用；右上角显示当前余额。