Windows：Codex 终端版

本页使用原生 Windows PowerShell，并将配置保存在当前用户目录中。

在 Windows 上使用 Codex 终端版

Codex 通过自定义 Provider 调用悠然 AI 的 Responses API，并从用户环境变量读取个人 API Key。

1. 确认适用方式

   适合希望在终端中使用 Codex 处理本地代码，同时通过悠然 AI 管理模型额度的用户。

2. 安装 Codex

   打开 PowerShell，运行 OpenAI 官方独立安装器。

   PowerShell复制

   irm https://chatgpt.com/codex/install.ps1 | iex

   查看 Codex 官方仓库

3. 验证安装

   PowerShell复制

   codex --version

4. 创建悠然 AI API Key

   为当前设备创建独立 Key，后续通过 YOURAN_API_KEY 环境变量提供给 Codex。

   打开访问密钥页面

5. 查询可用模型

   从实时返回的 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

6. 保存 API Key 并打开配置文件

   先保存用户级环境变量，再打开 ~/.codex/config.toml。

   PowerShell复制

   [Environment]::SetEnvironmentVariable("YOURAN_API_KEY", "<YOURAN_API_KEY>", "User")
   $env:YOURAN_API_KEY = "<YOURAN_API_KEY>"
   New-Item -ItemType Directory -Force "$HOME/.codex" | Out-Null
   notepad "$HOME/.codex/config.toml"

7. 写入 Provider 配置

   根级字段必须位于 Provider 表之前，将 API Key 和模型 ID 占位符替换为真实值。

   TOML复制

   model = "<MODEL_ID>"
   model_provider = "youran"
   
   [model_providers.youran]
   name = "悠然 AI"
   base_url = "https://youran-ai.du-fu.com/api"
   env_key = "YOURAN_API_KEY"
   wire_api = "responses"

8. 发起第一次请求

   PowerShell复制

   codex "请只回复：连接成功"

   Codex 会通过 youran Provider 调用 https://youran-ai.du-fu.com/api/responses。

9. 遇到问题

   确认配置位于用户级 ~/.codex/config.toml，并检查 YOURAN_API_KEY 在当前终端中可见。

   前往故障排查