跳转到内容
悠然 AI 文档

Windows：Codex 桌面版

Codex 桌面体验位于 ChatGPT 桌面应用中。本页不会把悠然 AI API Key 当作 OpenAI 登录凭据使用。

在 Windows 上使用 Codex 桌面版

Codex 桌面体验位于 ChatGPT 桌面应用中，与终端版共享用户级配置，但安装、启动和密钥读取方式不同。

  1. 安装 ChatGPT 桌面应用

    安装适用于 Windows 的 ChatGPT 桌面应用，打开后从产品选择器进入 Codex。

    打开 ChatGPT 官方下载页面

  2. 登录桌面应用

    使用 ChatGPT 账号登录桌面应用。不要把悠然 AI API Key 填入“Sign in another way”或 OpenAI API Key 登录框；该入口只验证 OpenAI Platform Key。

  3. 创建悠然 AI API Key

    在控制台为桌面应用创建独立 Key，便于单独查看请求和撤销权限。

    打开访问密钥页面

  4. 查询可用模型

    从实时返回的 data[].id 中选择模型 ID。

    PowerShell
    $headers = @{ Authorization = "Bearer <YOURAN_API_KEY>" }
(Invoke-RestMethod -Uri "https://youran-ai.du-fu.com/api/models" -Headers $headers).data |
  Select-Object -ExpandProperty id

  5. 为桌面应用保存 API Key

    使用用户级 Windows 环境变量保存 Key。执行后必须完全退出并重新打开 ChatGPT 桌面应用。

    PowerShell
    $secureKey = Read-Host "请输入悠然 AI API Key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
[Environment]::SetEnvironmentVariable("YOURAN_API_KEY", $plainKey, "User")
Remove-Variable secureKey, plainKey

  6. 打开并写入桌面配置

    在桌面应用中打开 Settings → Configuration → Open config.toml。终端、IDE 与桌面应用共享此用户级配置文件。

    Windows 桌面版的 Provider TOML 与 Windows 终端版完全一致，不再重复展示。

    前往 Windows 终端版的 Provider 配置

  7. 重新打开应用并发起请求

    完全退出 ChatGPT 桌面应用后重新打开，选择一个本地文件夹，从产品选择器进入 Codex 并发送“请只回复：连接成功”。

  8. 桌面版功能边界

    悠然 AI Key 只负责自定义模型请求。依赖 ChatGPT 工作区或云端服务的功能仍需要相应的 ChatGPT 账号权限，并不由悠然 AI API Key 解锁。

    查看 Codex 官方配置说明