Codex CLI 配置指南

Codex CLI 配置指南

💡 原文中文,约1200字,阅读约需3分钟。
📝

内容提要

本文介绍为 Codex CLI 配置 Ace Data Cloud 的步骤:先在 Ace Data Cloud 应用列表获取 API Key,再用 npm 全局安装 @openai/codex;随后在 macOS/Linux 或 Windows PowerShell 中设置环境变量 ACEDATACLOUD_API_KEY,并编辑 ~/.codex/config.toml,添加 acedatacloud provider、base_url 及读取密钥的命令(Windows 改用 PowerShell 命令);最后进入项目运行 codex,用 /model 确认 Provider 并选择模型。若提示缺少 Key 或出现 401,需检查环境变量并重启终端和 Codex。

🔎

延伸解读

配置的关键在于密钥读取方式

文章没有让用户把 API Key 直接写进 config.toml,而是通过 auth.command 在运行时读取环境变量。macOS/Linux 用 sh 执行 echo,Windows 用 PowerShell 的 Write-Output。这样做的好处是密钥不落在配置文件里,但前提是环境变量必须在启动 Codex 的终端会话中可见,因此设置后需要重新打开终端。

跨平台配置的差异点

macOS/Linux 与 Windows 的差异集中在三处:设置环境变量的命令分别是 export 和 setx;配置文件路径分别是 ~/.codex/config.toml 和 %USERPROFILE%\.codex\config.toml;auth.command 的写法也不同。照搬另一平台的命令容易导致读取不到密钥,配置时应按当前系统选择对应写法。

启动后需手动确认 Provider 与模型

配置中只指定了 model_provider 为 acedatacloud,没有写死具体模型。进入项目运行 codex 后,需要用 /model 确认 Provider 显示为 acedatacloud,再选择模型。这意味着模型选择发生在启动之后,而不是配置文件阶段;若 Provider 不对,应先回到配置检查,而不是直接选模型。

401 与缺少 Key 的排查顺序

文章给出的故障信号是提示缺少 Key 或返回 401,排查方向是确认环境变量已设置,并完全退出后重新打开终端和 Codex。这说明问题多出在环境变量未生效或会话未刷新,而不是配置项本身。按“先查变量、再重启终端与 Codex”的顺序处理,比反复修改 config.toml 更直接。

❓

Q&A

如何获取 Ace Data Cloud 的 API Key 用于 Codex CLI?

打开 Ace Data Cloud 应用列表,进入可用的应用并复制 API Key。

Codex CLI 的安装命令是什么?

使用 npm 全局安装:npm install -g @openai/codex。

在 macOS 或 Linux 上如何设置 ACEDATACLOUD_API_KEY 环境变量?

在终端执行 export ACEDATACLOUD_API_KEY="你的 API Key"。如需长期生效,将这一行加入 ~/.zshrc 或 ~/.bashrc。

Windows PowerShell 中如何设置 ACEDATACLOUD_API_KEY?

使用 setx ACEDATACLOUD_API_KEY "你的 API Key",设置后重新打开终端。

如何配置 ~/.codex/config.toml 以使用 Ace Data Cloud 作为 provider?

编辑 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml),添加以下内容: model_provider = "acedatacloud" [model_providers.acedatacloud] name = "acedatacloud" base_url = "https://api.acedata.cloud/v1" [model_providers.acedatacloud.auth] command = "sh" args = ["-c", "echo $ACEDATACLOUD_API_KEY"] Windows 将最后两行改为: command = "powershell" args = ["-NoProfile", "-Command", "Write-Output $env:ACEDATACLOUD_API_KEY"] 无需填写 model;已有其他配置可以保留,不要重复创建同名 provider。

启动 Codex 后如何确认 Provider 并选择模型?

进入项目目录运行 codex,然后在 Codex 中运行 /model,确认 Provider 为 acedatacloud,再选择需要的模型。

遇到提示缺少 Key 或 401 错误该怎么办?

确认环境变量已设置,并完全退出后重新打开终端和 Codex。

🏷️

标签

➡️

继续阅读