前言：本文是直接针对本地配置文件更改的做法，使用环境变量读取key；如果条件允许都去用cc switch配（真的好使）

1. Codex 配置文件

在 Windows 中，Codex 的用户配置目录为：

%USERPROFILE%\.codex

通常对应：

C:\Users\你的Windows用户名\.codex

打开目录中的config.toml 配置文件

覆盖原有文本，写入以下配置（env_key = "AZURE_OPENAI_API_KEY" 这里不要改）：

model = "你的 Azure 部署名"
model_provider = "azure"
model_reasoning_effort = "medium"

[model_providers.azure]
name = "Azure"
base_url = "https://你的资源名.openai.azure.com/openai"
env_key = "AZURE_OPENAI_API_KEY"
query_params = { api-version = "2025-04-01-preview" }
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

示例配置

项目	值
Azure 资源名	my-aoai-resource
模型部署名	gpt-5.3-codex
API Key 环境变量名	AZURE_OPENAI_API_KEY

则配置文件应写为：

model = "gpt-5.3-codex"
model_provider = "azure"
model_reasoning_effort = "medium"

[model_providers.azure]
name = "Azure"
base_url = "https://my-aoai-resource.openai.azure.com/openai"
env_key = "AZURE_OPENAI_API_KEY"
query_params = { api-version = "2025-04-01-preview" }
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

---

2. 设置 Windows 用户环境变量

将 API Key 保存到 Windows 用户环境变量中。

1. 打开开始菜单。
2. 搜索：

环境变量

1. 打开：

编辑账户的环境变量

1. 在“用户变量”区域点击“新建”。
2. 填写：

变量名：AZURE_OPENAI_API_KEY
变量值：你的 Azure Foundry API Key

1. 点击“确定”保存。

3. 重启 Codex Windows 客户端

完成配置后，需要让 Codex Windows 客户端重新读取配置和环境变量。确保完全退出 Codex Windows 客户端。

 验证配置是否生效

重新打开 Codex Windows 客户端后，应直接进入对话界面，无需登陆，可以尝试让 Codex 执行一个简单任务，如果能够正常响应，说明 Azure provider 配置基本生效。