Windows 配置 Codex CLI:PowerShell、环境变量与常见路径¶
直接结论:Windows 先确认 Codex CLI 实际读取的配置目录,再用 PowerShell 设置会话级变量,避免把 Key 写进项目文件。
配置顺序¶
- 在 PowerShell 查看 CLI 版本和帮助,确认当前配置字段。
- 在用户配置目录创建或编辑
config.toml。 - 用会话级环境变量完成最小请求。
- 关闭并重新打开终端,确认变量没有被旧会话缓存。
- 运行只读任务,再测试写入和工具权限。
PowerShell、Windows Terminal、Git Bash 和 WSL 的环境变量作用域不同。不要把 PowerShell 语法直接复制到 Bash。
排错¶
- 找不到配置:确认用户目录、文件名和 TOML 语法;
- 401:检查新终端是否继承变量;
- 404:复制服务端公开模型 ID;
- 工具失败:先使用只读权限和空测试工作区。