Codex 接入 Aekor 平台 GPT-6 Astra 配置教程（Windows/Mac 通用）

很多小伙伴想用 OpenAI Codex 体验最新的 GPT-6 Astra，但受限于官方账单限制或网络环境，希望能直接接入 Aekor 平台（api.aekor.com） 的第三方 API 服务。

其实，Codex 原生支持通过 config.toml 切换自定义模型提供商（Model Provider）。不过如果直接复制别人的整份配置，往往会因为硬编码的用户名、本地缓存哈希路径不同而报错闪退。

今天为大家整理了一份极简、干净的配置教程，无论你是 Windows 还是 Mac，3 分钟即可完成接入并顺手开启省 Token 的实验模式。

第一步：获取并准备 API Key

在开始配置前，请登录你的 Aekor 账号后台，生成属于你的 API 密钥：

接口地址（Base URL）：https://api.aekor.com/v1
API Key： 形如 sk-xxxxxxxxxxxxxxxxxxxxxxxx

（注意：API Key 相当于账号密码，切勿公开泄露或将包含 Key 的配置文件直接分享给他人。）

第二步：根据系统定位配置文件

修改前，请先完全退出后台正在运行的 Codex 客户端。

1. Windows 用户

按下键盘快捷键 Win + R，在弹出的运行窗口中输入以下路径并回车：

%USERPROFILE%\.codex

在打开的文件夹中找到 config.toml。如果此前从未配置过且找不到该文件，可以直接新建一个文本文件，将其命名为 config.toml（注意去掉 .txt 后缀）。

2. Mac (macOS) 用户

打开访达 (Finder)，按快捷键 Command + Shift + G，输入以下路径并前往：

~/.codex

或者在终端直接输入以下命令创建并编辑：

mkdir -p ~/.codex && touch ~/.codex/config.toml

第三步：写入专属配置

使用文本编辑器（如 VS Code、记事本或 Mac 文本编辑）打开 config.toml。

注意：如果你原本已经有正在使用的本地插件或 MCP 工具，只需将以下内容追加到文件末尾，并将开头的 model 和 model_provider 调整一致即可；如果是全新配置，直接覆盖为以下内容：

Windows 专属配置模板

# 默认调用模型与提供商
model = "gpt-6-astra"
model_provider = "aekor"
model_reasoning_effort = "low"
approval_policy = "on-request"
web_search = "live"

# 开启实验性上下文笔记模式（大幅省 Token 并防止遗忘）
[features.context_management]
experimental_mode = true

# Aekor 平台 API 配置
[model_providers.aekor]
name = "aekor"
base_url = "https://api.aekor.com/v1"
api_key = "请替换为你的Aekor_API_Key"
experimental_bearer_token = "请替换为你的Aekor_API_Key"
requires_openai_auth = false
web_search = "live"
supports_websockets = false

# Windows 提权环境推荐
[windows]
sandbox = "elevated"

Mac (macOS) 专属配置模板

# 默认调用模型与提供商
model = "gpt-6-astra"
model_provider = "aekor"
model_reasoning_effort = "low"
approval_policy = "on-request"
web_search = "live"

# 开启实验性上下文笔记模式（大幅省 Token 并防止遗忘）
[features.context_management]
experimental_mode = true

# Aekor 平台 API 配置
[model_providers.aekor]
name = "aekor"
base_url = "https://api.aekor.com/v1"
api_key = "请替换为你的Aekor_API_Key"
experimental_bearer_token = "请替换为你的Aekor_API_Key"
requires_openai_auth = false
web_search = "live"
supports_websockets = false