配置教程

Codex API Key 配置教程:环境变量、Base URL 与本地开发设置

配置的核心是让当前工具能读到正确的 API Key 和匹配的接口地址。

信任声明:本站为非官方中文教程站,OpenAI 官方账号、API Key、计费与模型权限请以 OpenAI 官方平台为准;中转站接入请以 DKAI 控制台实时配置为准。

推荐配置方式

优先使用系统或用户级环境变量,其次是工具官方支持的本地配置文件。不要把 Key 写进前端代码、公开 Markdown、截图或 GitHub 仓库。

如果使用官方 Key,Base URL 可保持工具默认值或设置为官方接口;如果使用中转站 Key,请以中转站控制台“使用密钥”给出的 Base URL 为准。

Windows PowerShell 示例

下面示例会写入当前 Windows 用户环境变量。执行后请重启 PowerShell、Codex CLI、VSCode 或 Desktop App,让新变量生效。

macOS / Linux 示例

临时测试可以在当前终端 export;长期使用建议写入 shell 配置文件,并注意文件权限。

排查顺序

先确认 Key 来源和 Base URL 是否匹配,再确认当前终端是否能读取环境变量,最后检查客户端是否覆盖了独立配置。

如果报 401,多半是 Key 无效或接口地址不匹配;如果报模型不存在,检查模型权限、模型名称和中转站分组。

配置示例

PowerShell

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的Key", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.openai.com/v1", "User")

macOS / Linux

export OPENAI_API_KEY="sk-你的Key"
export OPENAI_BASE_URL="https://api.openai.com/v1"

中转站占位示例

export OPENAI_API_KEY="dkai-你的中转站Key"
export OPENAI_BASE_URL="https://控制台显示的接口地址/v1"

常见问题

设置环境变量后为什么还不生效?

很多客户端只在启动时读取变量。请关闭并重新打开终端、VSCode 或桌面应用。

OPENAI_BASE_URL 和 API_BASE_URL 是一回事吗?

不同工具变量名可能不同。请以你使用的 Codex 客户端说明为准,必要时同时检查工具内的配置页面。

可以把 Key 放到 .env 文件吗?

本地开发可以,但必须加入 .gitignore,并限制文件权限。生产环境建议使用密钥管理服务。

需要国内 API 中转站配置?

注册 DKAI 中转站,创建专用 Key,并按控制台脚本配置 Codex CLI、Desktop 或 VSCode。

注册 DKAI 中转站