必须通过环境变量持久化配置api密钥等参数，否则codex cli会报401或“missing api key”；需根据shell类型（zsh/bash/powershell）编辑对应配置文件或设置用户变量，并确保变量名与config.toml中env_key完全一致，最后用source或重启终端生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在终端中让 Codex CLI 正确读取 API 密钥、模型地址等关键参数，必须通过环境变量将其持久化生效，否则每次执行 codex 命令都会报 401 错误或提示“missing API key”。
确认 Shell 类型并定位配置文件
先运行 echo $SHELL 查看当前 Shell：输出 /bin/zsh 就编辑 ~/.zshrc；输出 /bin/bash 就编辑 ~/.bashrc；Windows PowerShell 用户跳至下一节。
这一步不能跳过——写错配置文件会导致环境变量只在当前窗口有效，关掉终端就失效。
macOS / Linux：写入 Shell 配置文件
打开对应配置文件：nano ~/.zshrc（zsh）或 nano ~/.bashrc（bash）。
在文件末尾添加以下三行（按需替换值）：
export OPENAI_API_KEY="sk-xxx"export AI_API_BASE_URL="https://your-api.example/v1"export AI_MODEL="gpt-5.5"
【OPENAI_API_KEY 这个变量名必须和 config.toml 中的 env_key 完全一致】，比如 config.toml 写的是 env_key = "PROVIDER_A_KEY"，那这里就必须用 export PROVIDER_A_KEY="sk-xxx"，拼错一个字母都连不上。
保存后执行 source ~/.zshrc（或 source ~/.bashrc）立即加载新变量。
Windows：PowerShell 一键添加到用户环境变量
方法一（推荐）：在 PowerShell 中直接运行：
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("AI_API_BASE_URL", "https://your-api.example/v1", "User")
[Environment]::SetEnvironmentVariable("AI_MODEL", "gpt-5.5", "User")
方法二：图形界面操作——按 Win + S 搜索“环境变量”，点击“编辑系统环境变量” → “环境变量” → 在“用户变量”里新建三项，名称和值一一对应。
⚠️ 注意：PowerShell 设置后必须关闭并重新打开终端窗口，变量才生效。CMD 或 Git Bash 不会自动继承 PowerShell 的用户级变量。
验证环境变量是否生效
第一步：运行 echo $OPENAI_API_KEY（macOS/Linux）或 echo $env:OPENAI_API_KEY（PowerShell），应显示密钥前缀 sk- 而非空值。
第二步：运行 codex --version 确认 CLI 可执行；再运行 codex status，若返回 ✅ Auth OK 和模型信息，说明环境变量已正确加载。
