Codex

Codex 是 OpenAI 推出的编程 Agent，支持命令行和 VS Code 插件。通过自定义 Provider，可以让 Codex 使用 DataEyesAI 的模型。

准备

配置项	值
Base URL	`https://studio.dataeyes.ai/v1`（需要 `/v1`）
API Key	您的模型 API Key，通过环境变量 `DATAEYES_API_KEY` 传入
推荐模型	`gpt-6-astra`、`gpt-6-luna`、`gpt-6.1-sol`

备注

Codex 使用 OpenAI Responses 协议（/v1/responses），请选择 GPT-6 系列模型。

1. 安装 Codex

需要 Node.js 18 或更高版本。安装后运行 codex --version 确认。

2. 编写配置文件

打开或新建 ~/.codex/config.toml（Windows 为 C:\Users\<用户名>\.codex\config.toml），写入：

model_provider = "dataeyes"
model = "gpt-6-astra"
preferred_auth_method = "apikey"
disable_response_storage = true

[model_providers.dataeyes]
name = "DataEyesAI"
base_url = "https://studio.dataeyes.ai/v1"
env_key = "DATAEYES_API_KEY"
wire_api = "responses"

字段	说明
`model_provider`	指向下方定义的 `dataeyes`
`model`	默认模型，可在会话中用 `/model` 切换
`base_url`	DataEyesAI 地址，必须以 `/v1` 结尾
`env_key`	从哪个环境变量读取 API Key
`wire_api`	固定为 `responses`

3. 设置 API Key

macOS / Linux

Windows（PowerShell）

如需长期生效，写入 ~/.zshrc 或 ~/.bashrc。

4. 验证

进入任意项目目录运行 codex，输入「总结一下当前目录的结构」。能正常输出即接入成功。也可以用非交互方式快速测试：

在 VS Code 中使用

Codex 的 VS Code 插件与命令行共用 ~/.codex/config.toml 和环境变量。完成上述配置后，在扩展市场安装 Codex 插件即可直接使用。

常见问题

提示认证失败（401）

提示 404 或模型不存在

响应异常或工具调用失败

准备#

1. 安装 Codex#

2. 编写配置文件#

3. 设置 API Key#

4. 验证#

在 VS Code 中使用#

常见问题#

准备

1. 安装 Codex

2. 编写配置文件

3. 设置 API Key

4. 验证

在 VS Code 中使用

常见问题