客户端集成Windows

Codex

为 Codex 配置 OpenAI 兼容模型

1安装 Codex

打开 PowerShell，安装 Codex CLI。

npminstall -g @openai/codex

2创建 config.toml

如果 .codex 目录还不存在，先创建目录，然后打开配置文件。

mkdirC:\Users\<用户名>\.codex

notepadC:\Users\<用户名>\.codex\config.toml

先备份现有文件，再合并以下字段，不覆盖其他服务商或项目配置。示例模型由客户替换为选定型号；同一个 TOML 表不能重复声明。

C:\Users\<用户名>\.codex\config.toml

model = "gpt-5.6-sol"model_provider = "yunqi"model_reasoning_effort = "high"model_verbosity = "high"cli_auth_credentials_store = "file"[model_providers.yunqi]name = "YunQi AI"base_url = "https://www.yunqiai.chat/v1"requires_openai_auth = truewire_api = "responses"

3创建 auth.json

用记事本打开 API Key 文件。

notepadC:\Users\<用户名>\.codex\auth.json

此方式会切换登录身份；先备份原文件。把 YOUR_API_KEY 换成控制台 API Key。若使用下方 env_key 方式，不需要修改 auth.json。

C:\Users\<用户名>\.codex\auth.json

{  "auth_mode": "apikey",  "OPENAI_API_KEY": "YOUR_API_KEY"}

4启动 Codex

进入你的项目目录后运行 Codex。后续更换模型时，直接修改 config.toml 中的 model。

codex

VS Code、WSL 与远程环境

配置要放在实际运行 Codex 的环境。Windows 本机用户目录为 %USERPROFILE%；macOS、Linux、WSL 或 SSH 主机为该环境的 ~。WSL 不会自动使用 Windows 用户目录中的配置。

VS Code 使用 Remote SSH、WSL 或容器时，先确认扩展运行在本地还是远程，再修改对应环境的配置。更新环境变量后完全退出并重新启动 VS Code 和客户端；在集成终端中设置变量，不会反向更新已启动的扩展进程。

保留现有项目设置。检查项目级配置、系统环境变量和组织策略是否覆盖用户配置；不要为排查连接问题关闭工具权限或安全检查。

环境变量鉴权

也可使用以下 provider 配置，从运行进程的 YUNQIAI_API_KEY 读取密钥，保留原有 auth.json。不要同时设置 requires_openai_auth = true 或其他 Bearer token 鉴权字段。

config.toml · env_key

model = "gpt-5.6-sol"
model_provider = "yunqi"

[model_providers.yunqi]
name = "YunQi AI"
base_url = "https://www.yunqiai.chat/v1"
env_key = "YUNQIAI_API_KEY"
wire_api = "responses"

由系统凭据管理或私有启动环境注入变量。PowerShell 当前会话写法为 $env:YUNQIAI_API_KEY = "YOUR_API_KEY"；Bash 为 export YUNQIAI_API_KEY="YOUR_API_KEY"。不要把真实密钥留在共享脚本或 Shell 历史中。

配置字段参考：Codex 配置参考。