Codex

配置位置

Codex CLI 与 Codex 的 VS Code 扩展使用运行环境中的 Codex 配置。默认目录为 ~/.codex，设置了 CODEX_HOME 时以它为准。WSL、远程主机和容器需要在各自环境配置。

config.toml

将以下服务商配置合并到现有文件，保留项目与安全设置。model 填写要调用的完整型号，该型号需支持 Responses 及业务所需的工具能力。

model_provider = "yunqi"
model = "客户选择的完整 GPT 模型 ID"

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

在启动 Codex 的进程环境中设置 YUNQIAI_API_KEY，无需将 Key 写入 TOML。此自定义 provider 使用 API Key，不启用仅适用于官方登录的认证选项。修改服务商配置时保留原有 auth.json。

model_reasoning_effort 的可用值见型号页。gpt-6-astra 不支持 none / minimal；省略该设置时，服务和客户端使用默认推理配置。

VS Code

在扩展实际运行的环境中设置用户目录和环境变量，重启后确认 provider、model 和请求 URL。已打开的 VS Code 通常不会继承外部终端后来设置的变量。

若同时使用 CC Switch，请检查其写入的文件是否覆盖了手工设置。认证失败时，确认扩展进程能读取 env_key 指定的变量；排查日志和截图中需隐藏密钥。

检查接入

先发送一次 Responses 文本请求，再检查一次文件或目录的只读工具调用。若文本正常、工具失败，请保留脱敏后的请求结构和错误，核对客户端的工具字段。此配置的 wire_api 保持 responses。

字段定义见 Codex 官方配置参考，YunQi 地址和模型 ID 按本页填写。