外观
常见问题
Codex 桌面版和 CLI 应该选哪个
第一次使用建议选择 Codex 桌面版，不需要通过终端安装。已经习惯在终端工作，或需要在脚本中启动 Codex 时，再选择 CLI。
两种方式使用同一个 .codex 配置目录。在本站重新运行一键配置后，请完全退出 Codex Desktop 或 CLI，再重新打开并新建任务。
Codex 桌面版配置后仍然要求登录
先完全退出 Codex 桌面版，而不只是关闭窗口，然后重新打开并新建任务。如果仍然无效：
- 回到API 密钥页面。
- 点击密钥右侧的使用密钥。
- 重新下载并运行一键配置。
- 检查用户目录下是否已经生成
.codex/config.toml。
一键配置运行后没有生效
先关闭所有客户端和终端窗口，再重新打开终端。环境变量只会被新启动的进程读取。
如果仍未生效：
- 确认运行的是刚下载的配置文件。
- 检查脚本是否显示错误。
- 检查用户目录下是否生成对应配置。
- 暂时移走旧配置，重新运行一键配置。
提示找不到 npm
安装 Node.js LTS，安装完成后重新打开终端，再执行客户端安装命令。可以使用 node --version 和 npm --version 检查是否安装成功。
返回 401
通常表示 API 密钥不正确：
- 密钥复制不完整。
- 密钥已被删除或禁用。
- 配置文件中仍然是
sk-your-api-key示例。 - 环境变量中残留了旧 Key。
建议创建一个新密钥，并重新运行一键配置。
返回 403
表示请求已经识别，但当前 API 密钥、分组或账号没有对应模型权限。检查创建密钥时选择的分组，必要时联系站点管理员。
返回 429
常见原因包括：
- 余额或订阅额度不足。
- 并发数已满。
- 达到 RPM 或时间窗口限制。
等待已有请求结束并检查控制台用量。如果持续出现，联系站点管理员确认限制。
Base URL 要不要添加 /v1
不同客户端要求不同。不要统一添加 /v1，优先使用一键配置；手动配置时完整复制对应客户端页面给出的内容。
如果返回 404，首先检查地址中是否出现了两次 /v1，或者是否把完整的 /chat/completions 路径填入了只要求 Base URL 的字段。
手动配置后仍然使用旧服务
客户端可能同时读取用户配置、项目配置和环境变量。按对应客户端页面检查配置位置，并删除或暂时移走指向旧服务的设置。修改后完全退出客户端和终端，再重新打开。
提示模型不存在
模型名称必须与控制台可用模型完全一致，包括大小写、数字和连字符。先复制客户端页面给出的默认模型；如果账号分组没有该模型权限，请改用控制台显示的可用模型。
客户端仍然要求官方登录
通常说明客户端没有读取到本地 API 配置。完全退出客户端，重新打开终端后再启动。如果项目目录中存在客户端配置，也要检查它是否覆盖了用户目录配置。
Windows 双击配置文件被拦截
只运行从本站登录后的 API Key 页面下载的文件。右键文件查看属性，确认来源正确。企业电脑如果禁止运行脚本，请使用页面中的手动配置方式或联系管理员。
怀疑 API 密钥泄露怎么办
立即在API 密钥页面删除或禁用旧密钥，再创建新密钥并重新配置客户端。不要继续使用已经泄露的密钥。