YesAI

菜单

Administrator
发布于 2026-07-11 / 11 阅读
0

自定义配置 Codex（Windows）

适用范围：Windows 版 Codex 客户端或 Codex CLI。配置前请确认你的 YesAPI 账户已开通对应模型。

一、准备 YesAPI 密钥

  1. 登录 YesAPI 控制台。
  2. 进入控制台左侧“API密钥”页面，创建一个令牌。
  3. 填写名称，选择分组，即可点击“保存更改”。
  4. 复制令牌并妥善保存。不要把令牌发到群聊、工单截图或公开文档中。

二、配置 Codex

按 Win + R，输入下面的命令并回车：

notepad %USERPROFILE%\.codex\config.toml

如果文件已有内容，建议先备份。然后把下面配置合并到文件中：

model_provider = "yesapi"
model = "gpt-5.6-terra"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
windows_wsl_setup_acknowledged = true

[model_providers.yesapi]
name = "YesAI YesAPI"
base_url = "https://api.lyyes.cn/v1"
wire_api = "responses"
env_key = "YESAPI_API_KEY"
requires_openai_auth = false
supports_websockets = false

注意：

  • model_provider、model 等顶层配置必须写在所有 [表名] 之前。
  • 同一个配置项不要重复出现；如果原文件已有 model 或 model_provider，请修改原值。
  • 自定义 provider 必须配置在用户文件 %USERPROFILE%\.codex\config.toml 中，不能只写到项目目录的 .codex\config.toml。
  • 模型名称以控制台当前开放的模型为准。如果账户没有 gpt-5.6-terra 或 gpt-5.6-sol，请改成控制台实际提供的模型名称。

三、设置环境变量

打开 PowerShell，执行：

[Environment]::SetEnvironmentVariable(
    "YESAPI_API_KEY",
    "请替换成你的YesAPI令牌",
    "User"
)
$env:YESAPI_API_KEY = "请替换成你的YesAPI令牌"

检查当前 PowerShell 是否已经读取到密钥：

if ($env:YESAPI_API_KEY) { "YESAPI_API_KEY 已设置" } else { "YESAPI_API_KEY 未设置" }

不要使用会直接打印完整密钥的命令截图求助。

四、重启并测试

  1. 完全退出 Codex 客户端，包括后台进程。
  2. 重新打开 Codex。
  3. 新建一个任务，发送“请回复：连接成功”进行测试。

用户级环境变量只会被新启动的程序读取，因此仅关闭当前任务或刷新页面通常不够。

常见问题

提示 401 或 Unauthorized

密钥无效、已过期或环境变量没有被新进程读取。重新创建令牌、再次设置环境变量，然后完全退出并重开 Codex。

提示 model not found 或 404

当前账户没有该模型，或者 YesAPI 渠道没有正确映射模型名称。请在控制台确认可用模型，并联系管理员检查模型映射和 /v1/responses 接口。

提示 429

通常表示额度不足、令牌限额、渠道限流或上游拥堵。请检查账户余额、令牌额度和渠道状态。

普通对话正常，但 Review 失败

review_model = "gpt-5.6-sol" 要求账户也能调用该模型。可以改成与 model 相同，或暂时删除 review_model。

自动审批时报模型错误

自定义 provider 可能没有映射 Codex 自动审批使用的内部模型。建议使用：

approval_policy = "on-request"
approvals_reviewer = "user"

除非服务端已经验证兼容，否则不建议在面向所有客户的默认配置里使用 approvals_reviewer = "auto_review"。

可选：工作区安全和联网配置

下面配置与 YesAPI 接入本身无关，只控制 Codex 执行命令时的权限：

sandbox_mode = "workspace-write"
approval_policy = "on-request"
approvals_reviewer = "user"

[sandbox_workspace_write]
network_access = true

请勿使用 network_access = "enabled" 代替上述表配置；当前官方配置参考使用的是 [sandbox_workspace_write] 下的布尔值。

disable_response_storage 也不在当前公开的 Codex 配置参考中，不建议把它作为客户教程的必填项。服务端是否留存请求数据，应以 YesAPI 站点及上游渠道的数据政策为准。

恢复 OpenAI OAuth 登录

打开 %USERPROFILE%\.codex\config.toml，删除整个 [model_providers.yesapi] 配置段，并把顶部配置改为：

model_provider = "openai"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
windows_wsl_setup_acknowledged = true

如果尚未登录 OpenAI，在客户端选择登录，或在终端执行：

codex login

完成 OAuth 登录后，完全退出并重开 Codex。原来的 YESAPI_API_KEY 环境变量可以保留，不会在 model_provider = "openai" 时使用；不再需要时也可以删除：

[Environment]::SetEnvironmentVariable("YESAPI_API_KEY", $null, "User")
Remove-Item Env:YESAPI_API_KEY -ErrorAction SilentlyContinue