Skip to content

Codex 接入 ​

在数域 AI 的「API Key」列表点击「使用API Key」,根据你的电脑选择 Windows / Mac,查看网站生成的 Codex 配置。

Mac:config.toml 与 auth.json 配置示例

截图中的示例账号没有额度,无法用于模型调用。以自己API Key的「使用API Key」窗口生成的配置为准。

修改前先备份 ​

先退出 Codex,再备份 config.toml 和 auth.json,然后修改。 如果原来没有这些文件,可以直接新建。已有文件不要直接覆盖,先保留可恢复的副本。

默认文件位置:

系统配置目录
Mac~/.codex/
Windows%USERPROFILE%\.codex\

如果自行设置过 CODEX_HOME,请使用该目录。可以把两个文件复制到一个带日期的备份文件夹;也可以在终端执行下面的命令,备份目录内会保留原文件名:

bash
codex_dir="${CODEX_HOME:-$HOME/.codex}"
backup_dir="$codex_dir/backup-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$backup_dir"
chmod 700 "$backup_dir"
for file in config.toml auth.json; do
  if [ -f "$codex_dir/$file" ]; then
    cp -p "$codex_dir/$file" "$backup_dir/$file"
  fi
done
printf '备份目录:%s\n' "$backup_dir"

两个配置文件分别修改什么 ​

config.toml:请求地址与模型 ​

这个文件决定 Codex 使用哪个提供商、哪个模型,以及向哪里发起请求。

  • 将网站生成的 TOML 配置合并到 config.toml。
  • model_provider、model 等顶层设置放在所有 [分节] 之前。已有同名设置时修改原值,不要重复添加。
  • model_provider 的值需要与对应 [model_providers.名称] 一致。
  • 本站 base_url 为 https://ai.datazone.tech/v1,wire_api 为 responses。
  • model 使用当前API Key支持的模型名称;网站生成内容中的其他设置一并核对,保留原有的项目设置。

auth.json:API Key ​

这个文件保存模型调用的认证信息。将网站生成的 auth.json 内容填入对应文件,使用自己的 API Key:

json
{
  "OPENAI_API_KEY": "替换为自己的 API Key"
}

文件名必须是 auth.json,不能保存成 auth.json.txt。内容使用合法 JSON,最后一项不要加逗号。

保存并启动 ​

保存两个文件后,重新启动 Codex,选择配置中的模型并发送一句简单的提问。需要先验证API Key和模型时,可使用 Curl 接口验证。

如果需要恢复原配置,先退出 Codex,将备份中的 config.toml 和 auth.json 复制回原目录,再重新启动。

数域 AI · 使用指南