直接运行 codex env inspect 可查看 codex 实际加载的环境变量及其来源与状态；若 openai_api_key 显示 [hidden] 且状态为 active，则已成功注入，否则需按优先级排查 shell 配置、wsl 环境隔离及配置文件生效情况。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在终端里快速确认 Codex 正在读取哪个环境变量、值是否正确、来源是否可信——而不是靠猜或反复重启，更不是盲目修改 config.toml。
直接查看 Codex 实际加载的环境变量
运行以下命令：
codex env inspect
该命令会列出 Codex CLI 当前实际读取到的所有环境变量及其来源（如 system、profile、cli），并标注状态 active 或 inactive。如果 OPENAI_API_KEY 显示为 [hidden] 且状态为 active，说明已成功注入；若显示 missing 或 inactive，则需继续排查。
验证基础环境变量是否存在
方法一：检查 OPENAI_API_KEY 是否被 shell 识别
echo $OPENAI_API_KEY
应完整输出你的密钥（以 sk- 开头）。如果返回空白，说明该变量未被当前 shell 加载。
方法二：过滤全部环境变量中与 Codex 相关的项
env | grep -i "codex\|openai\|acedata"
这条命令能同时捕获 OPENAI_API_KEY、ACEDATACLOUD_API_KEY、CODEX_ENV_MODE 等常见变量。注意观察输出中是否含等号右侧值，以及值前后不能带引号或空格——带引号即为无效格式，Codex 无法解析。
定位变量来源（按优先级排序）
第一步：确认当前终端是否在 WSL 中
uname -a
若输出含 Microsoft 或 WSL 字样，说明你在 WSL 子系统内；否则你仍在 Windows 主机 PowerShell/CMD 中——二者环境变量完全隔离，WSL 内必须单独配置。
第二步：检查 shell 配置文件是否写入正确位置
→ zsh 用户：cat ~/.zshrc | grep OPENAI_API_KEY
→ bash 用户：cat ~/.bashrc | grep OPENAI_API_KEY
→ Windows 系统变量：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中查找 OPENAI_API_KEY
第三步：确认配置文件是否已生效
source ~/.zshrc（或对应文件）
不执行这一步，新增的 export 行永远不生效。Windows 设置后必须重启终端才能读取。
