💻 Codex 安装与配置教程（适用于 Windows 系统）

## 🧩 一、安装与卸载

✅ 安装 Codex

在 PowerShell 或 CMD（命令提示符） 中执行：

winget install codex

如果提示找不到 winget，请确保你已安装 Windows 包管理器（App Installer）。

❌ 卸载 Codex

winget uninstall codex

## 🧽 二、清除配置文件

⚠️ 分开复制，一行一个命令，一次运行一个。

rmdir /s /q "%USERPROFILE%\.codex"
del "%APPDATA%\codex" /f /q

（上面命令会删除 Codex 的配置与缓存文件）

## ⚙️ 三、配置 Codex 环境变量

1️⃣ 编辑 Codex 主配置文件

在命令行中执行：

notepad %USERPROFILE%\.codex\config.toml

在打开的文件中，复制以下内容（无需修改）：👇

model_provider = "crs"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://ktapi.cc/openai"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

保存后关闭文件即可（Ctrl + S 保存，Ctrl + W 关闭）。

2️⃣ 编辑认证文件

执行以下命令打开：

notepad %USERPROFILE%\.codex\auth.json

复制以下内容（无需修改）：👇

{
  "OPENAI_API_KEY": null
}

💡 注意：

这里不直接填写密钥，而是通过系统环境变量来管理安全性。

## 🔐 四、设置环境变量

✅ 方法一：命令行（永久设置（推荐）

📍 PowerShell 方式

setx CRS_OAI_KEY "cr_xxxxxxxxxx"

*运行完成后重新打开终端或 VSCode 即可生效。*

📍 系统界面方式
	1.	打开「控制面板」 → 「系统」 → 「高级系统设置」
	2.	点击「环境变量」
	3.	在“用户变量”中点击“新建”
	•	变量名：CRS_OAI_KEY
	•	变量值：cr_xxxxxxxxxx
	4.	点击确定，关闭所有窗口。

## 🧪 五、验证是否配置成功

打开新的命令提示符（CMD 或 PowerShell）输入：

echo %CRS_OAI_KEY%

✅ 如果输出你的密钥（例如 cr_xxxxxxxxxx），说明配置成功！

## 🧼 六、删除环境变量（如需清理）

永久删除（从系统变量中移除）：

setx CRS_OAI_KEY ""

## 📝 七、配置检查与建议

项目                                             检查命令                                                    说明
检查 Codex 是否安装                  codex --version                                         显示版本号即代表成功安装
检查配置文件是否存在                dir %USERPROFILE%\.codex                  应能看到 config.toml 与 auth.json
检查环境变量是否生效                echo %CRS_OAI_KEY%                           显示 Key 表示成功

**✅ 总结
	•	Windows 使用 %USERPROFILE%\.codex\ 存放配置文件
	•	CRS_OAI_KEY 环境变量存放 API 密钥
	•	可通过 setx 设置永久环境变量，set 临时使用
	•	清理时只需删除 .codex 文件夹和环境变量即可**