必须通过环境变量设置openai_api_key和openai_base_url,否则报“missing api key”或“unauthorized”错误;需用codex config show --path确认实际配置路径,并验证环境变量是否被正确读取。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让 Codex CLI 正确调用国内第三方 API 中转站,必须通过环境变量提供密钥和基础地址,否则会出现“Missing API key”或“Unauthorized”错误。这一步不完成,后续所有配置都无效。
确认 Codex 当前读取的配置路径
先执行命令确认 Codex 实际加载的是哪个 config.toml:
codex config show --path
输出结果会明确告诉你当前生效的配置文件路径,例如 C:\Users\Alice\.codex\config.toml 或 /Users/bob/.codex/config.toml。不要凭记忆或搜索找文件,必须以该命令输出为准。
设置 OPENAI_BASE_URL 和 OPENAI_API_KEY(通用兼容方式)
这是最简、最高优先级的配置方式,适用于绝大多数 OpenAI 兼容中转站(如 51relay、147AI、Wecode 等),无需修改 config.toml。
方法一:PowerShell(Windows 临时会话)
$env:OPENAI_API_KEY="sk-abc123xxx"
$env:OPENAI_BASE_URL="https://api.your-proxy.com/v1"
方法二:Bash/Zsh(macOS/Linux 临时会话)
export OPENAI_API_KEY="sk-abc123xxx"
export OPENAI_BASE_URL="https://api.your-proxy.com/v1"
【注意】临时设置只在当前终端窗口有效。关闭窗口后失效,必须重新设置。
永久配置环境变量(Windows 系统级)
第一步:打开系统环境变量编辑器
按下 Win + S → 输入“环境变量” → 点击“编辑系统环境变量” → 在弹出窗口右下角点击“环境变量(N)…”按钮
第二步:新增用户变量
在“用户变量”区域点击“新建” → 变量名填 OPENAI_API_KEY → 变量值填你的实际密钥(不含引号)→ 再新建一个变量名 OPENAI_BASE_URL → 变量值填完整接口地址(必须以 /v1 结尾)
第三步:重启所有已打开的 PowerShell 或 CMD 窗口
旧窗口不会自动读取新变量,必须关闭重开。新开窗口后运行 echo $env:OPENAI_API_KEY(PowerShell)或 echo %OPENAI_API_KEY%(CMD)验证是否生效。
永久配置环境变量(macOS/Linux)
① 打开终端,判断你当前 shell 类型:
echo $SHELL
② 根据结果编辑对应配置文件:
如果是 /bin/zsh(macOS Catalina 及以后默认),执行:
echo 'export OPENAI_API_KEY="sk-abc123xxx"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.your-proxy.com/v1"' >> ~/.zshrc
③ 重新加载配置:
source ~/.zshrc
④ 验证是否写入成功:
echo $OPENAI_API_KEY
如果返回空值,说明写入路径错误或未 source。检查 ~/.zshrc 文件末尾是否真有这两行 export,且没有拼写错误或多余空格。
验证环境变量是否被 Codex 正确读取
运行以下命令:
codex completions create --model gpt-4o --prompt "hi" --max-tokens 10
如果返回 JSON 响应体(含 content 字段),说明环境变量已生效;
如果报错 Error: Unauthorized,说明密钥无效或未加载;
如果报错 Error: Get "https://api.openai.com/...": dial tcp: lookup api.openai.com,说明 OPENAI_BASE_URL 未生效,Codex 仍在走官方地址。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











