Codex 如何配置 API Key？新手完整教程

大家好，我是 Codex 中文网的站长宇哥。

这篇文章主要聊「Codex 如何配置 API Key？新手完整教程」。很多新手刚开始使用 Codex 时，最容易卡在安装、登录、模型、API、MCP、cc-switch 和本地配置这些环节。其实大多数问题都有固定排查路径，只要按顺序检查，就能少走很多弯路。

适合谁看

这篇文章适合下面几类朋友：

• 正在学习 Codex 的开发者；
• 想把 Codex 用到真实项目里的用户；
• 想接入 DeepSeek、GLM、Qwen、OpenRouter 等模型的用户；
• 想用 cc-switch 管理多模型路由的用户；
• 遇到 Codex 登录、配置、报错问题的人；
• 想系统学习 AI Coding 工具链的人。

核心思路

在处理 Codex 相关问题时，不要只盯着一个命令。建议先把链路拆开：

Codex CLI
  ↓
本地配置
  ↓
账号 / API Key
  ↓
API Base URL
  ↓
模型服务
  ↓
网络环境

只要其中一个环节不对，就可能导致登录失败、401、429、模型不存在、请求超时或者工具不可用。

API Key 配置方式

推荐使用环境变量，不要把 Key 写进公开仓库。

Mac / Linux：

export OPENAI_API_KEY="你的 API Key"

Windows PowerShell：

setx OPENAI_API_KEY "你的 API Key"

配置后重新打开终端，再运行：

echo $OPENAI_API_KEY

配置建议

如果你使用的是第三方平台，可以给不同平台设置不同环境变量，比如 DEEPSEEK_API_KEY、GLM_API_KEY、OPENROUTER_API_KEY。

建议检查清单

操作完成后，建议你按下面清单检查一遍：

Codex 是否能正常启动
当前账号或 API Key 是否正确
Base URL 是否写成 API 地址
模型名是否和平台一致
终端环境变量是否生效
网络和代理是否正常
配置文件是否被误删或写错

常见误区

1. 把官网地址当成 API 地址

这是最常见的问题。官网地址、控制台地址、文档地址都不是 API Base URL。

2. 模型名自己随便写

模型名一定要从服务商控制台或文档复制，尤其是中转平台，不同平台可能有自己的模型别名。

3. Key 写进公开仓库

API Key 不要提交到 GitHub，建议使用环境变量或本地配置。

4. 一出错就重装

大多数 Codex 问题不需要重装，先查配置、Key、Base URL、网络和认证文件。

推荐操作习惯

我建议你养成这几个习惯：

每次改配置前先备份
每次换模型后先做简单测试
重要项目一定用 Git 管理
不要一次让 AI 大面积改代码
遇到报错先复制完整错误信息

总结

「Codex 如何配置 API Key？新手完整教程」这个问题，本质上还是 Codex 配置链路的问题。你只要按账号、Key、Base URL、模型名、网络、配置文件这个顺序排查，大多数问题都能定位出来。

Codex 中文网后面会继续更新 Codex、Claude Code、MCP、cc-switch、国产模型接入和 AI Coding 实战教程。如果你正在学习 AI 编程，可以收藏本站，后面会持续整理更多可复现的教程。