手动配置

如果你希望完全掌控每一步，可以按以下步骤手动安装 Codex 并写入 云策的配置。

第一步：安装 Node.js

Codex CLI 依赖 Node.js 运行时（版本 ≥ 18）。

macOS (Homebrew)

brew install node

Windows (winget)

winget install OpenJS.NodeJS.LTS

Linux (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

node --version   # 应输出 v18.x 或更高
npm --version

第二步：安装 Codex CLI

通过 npm 全局安装 Codex CLI：

npm install -g @openai/codex

验证安装：

codex --version

第三步：创建配置目录

确保 ~/.codex 目录存在：

macOS / Linux

mkdir -p ~/.codex

Windows (PowerShell)

New-Item -ItemType Directory -Force -Path "$HOME\.codex"

第四步：写入配置文件

创建 ~/.codex/config.toml，指定使用云策作为模型提供商：

model_provider = "apikeyfun"

[model_providers.apikeyfun]
name = "apikeyfun"
base_url = "https://yuncezn.com/v1"
wire_api = "responses"
requires_openai_auth = true

第五步：写入认证文件

创建 ~/.codex/auth.json，填入你的 云策 API Key：

{
  "OPENAI_API_KEY": "sk-替换成你的云策密钥"
}

密钥安全

• 请勿将 auth.json 提交至版本控制系统
• 建议在 .gitignore 中加入 .codex/auth.json
• 密钥泄露后请立即前往控制台重置

第六步：重启 Codex CLI

重要

配置写入后，已打开的 Codex CLI 需要重启后才会读取新配置。Codex App 客户端同样会在下次启动时自动读取。

第七步：验证连通性

进入任意项目目录，启动 Codex 并执行只读任务：

cd your-project-folder
codex

在 Codex 中输入：

请只读分析当前项目结构，列出主要目录和入口文件，不要修改任何文件。

若能正常返回结果，说明配置成功。

可选：指定默认模型

如需指定默认使用的模型，可在 ~/.codex/config.toml 顶部添加 model 字段：

model = "gpt-4o"
model_provider = "apikeyfun"

[model_providers.apikeyfun]
name = "apikeyfun"
base_url = "https://yuncezn.com/v1"
wire_api = "responses"
requires_openai_auth = true

常见可选模型：gpt-4o、gpt-4o-mini、o1、o3-mini 等，具体以控制台可用模型列表为准。

故障排查

问题现象	排查方向
command not found: codex	npm 全局安装路径未加入 PATH，检查 npm bin -g 输出
401 unauthorized	API Key 复制不完整或包含空格，重新写入 auth.json
404 model not found	base_url 未带 /v1，或模型名不在平台可用列表中
本地有返回但后台无日志	CLI 走了旧配置，重启 CLI；或 shell 环境变量覆盖了配置文件

更多问题请参考 常见问题。