操作前准备
- 已创建 API Key，密钥分组提供支持 Responses 的文本模型，余额或额度可用。
- 已准备一个你允许 Codex 读取的项目目录。首次验证可使用空目录。
- 使用 npm 安装时，先安装受支持的 Node.js 与 npm；其他方式见 Codex 官方安装说明。
配置步骤
1
安装并确认命令可用
在终端执行：能显示版本号后继续。若提示找不到命令，重新打开终端，检查 npm 全局命令目录是否在
PATH 中。2
准备密钥和模型 ID
登录 aibal.ai，在 API 密钥列表中打开 使用密钥，选择 Codex。复制当前分组支持的文本模型 ID。下面的
YOUR_AVAILABLE_MODEL_ID 是占位符，必须替换。3
编辑用户级 config.toml
打开
~/.codex/config.toml；Windows 原生环境对应 %USERPROFILE%\.codex\config.toml。如果设置过 CODEX_HOME，请使用该目录下的配置。文件不存在时先创建目录和文件，已存在时先备份并合并以下字段。model_provider 和 model 是顶层字段，放在第一个 [表名] 之前；不要重复声明已经存在的同名字段或 [model_providers.aibal]。保留你的其他设置。提供商配置应写入用户级文件，不要放到项目仓库的 .codex/config.toml。4
在启动终端中设置密钥
推荐在当前终端隐藏输入密钥，避免把密钥直接写入命令历史。以下 Bash/Zsh 写法会要求你粘贴密钥，输入时不显示字符：Windows PowerShell：环境变量只对当前终端及其启动的程序生效。关闭终端后需重新设置，也可由可信的密码管理器注入。不要把真实密钥写入项目文件。
5
启动新会话并验证
在准备好的项目目录执行 收到正常回答后，回到 aibal.ai 的 使用记录，核对这次调用的时间、密钥和模型。测试调用也可能产生费用。
codex。按提示确认项目信任范围，然后发送：配置字段说明
如果控制台为你的分组提供模型目录文件或专用地址，请同时按 使用密钥 的说明保存目录文件，并使用其给出的完整路径与模型 ID。不要把其他分组的配置混在一起。
常见问题
提示缺少 AIBAL_API_KEY
确认你在设置变量的同一个终端启动codex。从 Dock、开始菜单或另一个终端启动的程序不一定继承该变量。本页面向 CLI，不保证桌面应用直接继承终端配置。
仍出现 ChatGPT 登录或请求走向其他服务
检查model_provider = "aibal" 是否位于顶层、用户级配置是否生效，以及是否被其他配置管理工具覆盖。不要把本教程的 env_key 方式与其他教程的 auth.json 登录方式混用。
模型未找到或请求报错
把占位模型替换为当前密钥支持的完整 ID。检查该分组是否支持 Responses、Base URL 是否重复带/v1，以及密钥额度。更多错误处理见接入概览。
修改配置后旧会话没有变化
结束旧的 Codex 进程，在配置生效的终端重新启动。若使用 CC Switch，后续在同一个供应商配置中维护，避免手工文件和工具配置来回覆盖。能直接让 Codex 生成图片吗
文本模型接入成功不代表内置图像工具自动使用同一网关。支持客户端图片执行器时，可按文生图的 Codex 使用说明在控制台选择 API Key Mode，保存完整配套配置并重启客户端；不要与本页的env_key 片段混用。也可以按该页明确调用图片 API 并保存结果。具体图片工具能力取决于客户端与分组；视频参考文生视频。