Codex 配置

还没安装 Codex？请先完成环境检查，再回来配置。

准备好在 AI66 创建的 API Key，下面三种方法任选一种即可。还没有 Key，请先看快速开始。

前两种方法需要安装 CC Switch。点击对应系统的卡片进入下载页，在最新版本的 Assets 中选择安装包；文件名中的版本号以下载页为准。

Windows 选择文件名以 Windows.msi 结尾的安装包，双击安装。macOS 选择文件名以 macOS.dmg 结尾的安装包，打开后将 CC Switch 拖入「应用程序」；该安装包同时支持 Apple 芯片和 Intel 芯片。

⚡ CC Switch 一键导入

安装并打开 CC Switch（一键导入）

使用上方下载卡片安装 CC Switch，然后打开应用。

找到 API 密钥导入入口

API 密钥行操作菜单中的 CC Switch 导入入口

选择 Codex 和主模型

弹窗里的「应用」默认是 Claude，请改选 Codex。然后将「主模型」选为 gpt-6-astra。

CC Switch 导入弹窗中选择 Codex 应用

导入并启用

点击弹窗中的「打开 CC Switch」。浏览器询问是否打开 CC Switch 时，确认打开；进入 CC Switch 后点击「确认导入供应商配置」，选中刚导入的供应商，再点击「启用」。供应商卡片上显示「使用中」，才说明已切换成功。

CC Switch 会写入 ~/.codex/config.toml 和 ~/.codex/auth.json，其中 ~ 表示你的用户主目录。

启动 Codex 验证（一键导入）

关闭之前运行的 Codex，在 Windows PowerShell 或 macOS「终端」中输入 codex 并按回车。发送一句「请只回复 OK」，收到回复后即可开始使用。

🚀 CC Switch 手动配置

安装并打开 CC Switch（手动配置）

使用上方下载卡片安装 CC Switch，然后打开应用。

添加 Codex 供应商

在左侧栏选择「Codex」，点击右上角「+」（添加供应商），打开添加供应商窗口。

填写 AI66 配置

「供应商名称」填写 AI66；「API 请求地址」填写以下内容：


https://api.ai66.app/v1

「API Key」粘贴你在 AI66 复制的完整 Key；「模型」填写 gpt-6-astra。

窗口中还会显示 config.toml 和 auth.json 编辑器。应用前，对照「手动修改配置文件」标签中的示例核对配置：推理强度为 high，接口为 responses，并保留 requires_openai_auth = true。

保存并启用

保存供应商，选中刚添加的 AI66，再点击「启用」。供应商卡片上显示「使用中」，才说明已切换成功。CC Switch 会将配置写入 ~/.codex/config.toml 和 ~/.codex/auth.json。

启动 Codex 验证（手动配置）

关闭之前运行的 Codex，在 Windows PowerShell 或 macOS「终端」中输入 codex 并按回车。发送一句「请只回复 OK」，确认能收到回复。

🔧 手动修改配置文件

先关闭正在运行的 Codex。如果下面的文件已有内容，请先复制一份备份，然后清空文件全部内容，再粘贴下方对应内容——不要在原有内容后面追加，否则新增的配置可能落入已有的表（如信任目录记录）里而静默失效，或让 auth.json 变成非法 JSON。

Windows

打开配置目录（Windows）

打开文件资源管理器，在地址栏输入 %USERPROFILE%\.codex 并按回车。如果提示目录不存在，先打开 %USERPROFILE%，再新建名为 .codex 的文件夹。

创建或打开配置文件（Windows）

先在资源管理器开启“显示文件扩展名”，避免文件被存成 config.toml.txt。Windows 11 可在「查看 → 显示 → 文件扩展名」中开启；Windows 10 可在「查看」中勾选「文件扩展名」。

在 .codex 文件夹中，用记事本打开或新建 config.toml 和 auth.json。新建文件另存为时，将「保存类型」设为「所有文件」，编码选择 UTF-8，确保文件名分别为 config.toml 和 auth.json，末尾没有 .txt。如果文件已有内容，先全选（Ctrl + A）并删除，替换全部内容，再粘贴下方对应内容并保存。

两种系统使用相同的文件内容。下面的 ~/.codex/ 在 Windows 中对应 %USERPROFILE%\.codex\。将 auth.json 中的整个占位文字 sk-你在 AI66 创建的 Key 替换为你复制的完整 Key，保留两侧的英文双引号。

~/.codex/config.toml


model_provider = "ai66"
model = "gpt-6-astra"
model_reasoning_effort = "high"
 
[model_providers.ai66]
name = "AI66"
base_url = "https://api.ai66.app/v1"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json


{
  "OPENAI_API_KEY": "sk-你在 AI66 创建的 Key"
}

保存两个文件后，在 Windows PowerShell 或 macOS「终端」中输入 codex 并按回车。发送一句「请只回复 OK」，确认能收到回复。遇到问题可查看 Codex 常见问题。