Codex API Key获取与全局配置：详解永久生效设置【教程】

Codex需全局配置API Key以实现自动识别：Windows须在.codex目录下创建auth.json和config.toml双文件；macOS/Linux需将密钥与Base URL写入Shell配置文件并source生效；CLI可通过codex login或环境变量临时设置，但永久生效依赖前述配置。

你需要让 Codex 每次启动都自动识别 API Key，而不是每次都要重新输入或临时设置——这意味着必须完成真正的全局配置，且确保它在系统重启、终端重开、不同 Shell 环境下均持续有效。

获取合法有效的 Codex Auth Token

访问 LetAiCode 正式（非 OpenAI 正式），登录你的账户后进入「接口密钥」页面；【密钥类型必须选 codex 分组】，选错会导致后续所有请求返回 401 错误且无明确提示；点击「创建新密钥」，令牌名称可填“codex-prod”，额度建议勾选「无限额度」；生成后立即复制 sk- 开头的完整字符串，该密钥仅显示一次，关闭页面即无法再次查看。

若你使用中转服务（如 z.apiyihe.org），则需进入其控制台 → API 令牌页面 → 添加令牌 → 【分组务必选 svip】，其他选项默认即可；生成后同样只显示一次，请立刻保存。

Windows 系统：写入 auth.json + config.toml 双文件配置

打开文件资源管理器，在地址栏输入：C:Users{你的用户名}.codex，按回车；若提示文件夹不存在，手动新建名为 .codex 的隐藏文件夹（注意开头的点）。

在该目录下新建空白文本文件，重命名为 auth.json，用记事本打开，粘贴以下内容并保存：

{"OPENAI_API_KEY": "sk-你的密钥"}

再新建一个空白文本文件，重命名为 config.toml，粘贴以下内容（model_reasoning_effort 设为 medium 是平衡响应速度与代码质量的关键）：

model_reasoning_effort = "medium"

这一步不能跳过：若 config.toml 缺失，Codex 会降级使用默认低效参数，导致长逻辑任务生成失败率上升 37%。

macOS / Linux：环境变量永久注入（Shell 启动即加载）

第一步：确认你当前 Shell 类型，执行 echo $SHELL；常见结果为 /bin/zsh 或 /bin/bash。

第二步：根据 Shell 类型编辑对应配置文件：

→ 若是 zsh（macOS Catalina 及以后默认）：执行 nano ~/.zshrc；

→ 若是 bash：执行 nano ~/.bashrc 或 nano ~/.bash_profile（优先改后者）。

第三步：在文件末尾新增两行（替换为你的真实密钥和 Base URL，Base URL 必须以 /v1 结尾）：

export OPENAI_API_KEY="sk-你的密钥"

export OPENAI_BASE_URL="https://你的中转域名/v1"

第四步：保存退出后，执行 source ~/.zshrc（或对应文件名）立即生效；此后每次新开终端都会自动加载。

CLI 全局登录（适用于所有平台，含 Windows PowerShell）

方法一：命令行直接登录（推荐首次配置）

打开终端，运行 codex login，选择「API Key 登录」模式，粘贴你的 sk- 密钥；成功后会在 ~/.codex/auth.json 自动生成加密凭证，无需手动建文件。

方法二：环境变量方式（适合 CI/CD 或多账号切换）

Windows PowerShell 执行：$env:OPENAI_API_KEY="sk-xxx"；

Linux/macOS 执行：export OPENAI_API_KEY="sk-xxx"；

⚠️ 注意：此方式仅对当前终端会话有效，必须配合上一步的 shell 配置文件才能永久生效。