Codex 配置文件接入
推荐使用配置文件方式让 Codex 接入 WorkFreeAI。填写 API Key 后复制命令到终端执行即可。
本页使用 WorkFreeAI 自己的接口地址，不使用第三方文档里的 base URL。填写你的 API Key 后，复制对应系统的命令到终端执行即可。
开始前确认
- 先在 WorkFreeAI 控制台创建一个 API Key。
- 电脑里需要有 Node.js 18 或更高版本。
- API Key 只在当前页面生成命令使用，不会上传到服务器，也不会保存在浏览器里。
Windows
打开 PowerShell。如果还没有安装 Codex CLI，可以先执行安装命令。
npm install -g @openai/codex --registry=https://registry.npmmirror.com/
PowerShell 配置命令
填写 API Key 后复制下面的命令，在 PowerShell 中执行。
# 目标目录
$dir = Join-Path $env:USERPROFILE ".codex"
# 创建目录（存在不报错）
New-Item -ItemType Directory -Path $dir -Force | Out-Null
# 写 auth.json（UTF-8 无 BOM，覆盖）
$auth = @'
{
"OPENAI_API_KEY": "<PASTE_YOUR_WORKFREE_API_KEY>"
}
'@
[System.IO.File]::WriteAllText(
(Join-Path $dir "auth.json"),
$auth,
(New-Object System.Text.UTF8Encoding($false))
)
# 写 config.toml（UTF-8 无 BOM，覆盖）
$config = @'
model_provider = "workfreeai"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true
enableRouteSelection = true
[model_providers.workfreeai]
name = "workfreeai"
base_url = "https://freeworkai.top"
wire_api = "responses"
'@
[System.IO.File]::WriteAllText(
(Join-Path $dir "config.toml"),
$config,
(New-Object System.Text.UTF8Encoding($false))
)macOS
打开终端。如果还没有安装 Codex CLI，可以先执行安装命令。
npm install -g @openai/codex --registry=https://registry.npmmirror.com/
macOS 配置命令
填写 API Key 后复制下面的命令，在终端中执行。
# 目标目录
dir="$HOME/.codex"
mkdir -p "$dir"
# 写 auth.json（覆盖）
cat > "$dir/auth.json" << 'EOF'
{
"OPENAI_API_KEY": "<PASTE_YOUR_WORKFREE_API_KEY>"
}
EOF
# 写 config.toml（覆盖）
cat > "$dir/config.toml" << 'EOF'
model_provider = "workfreeai"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true
enableRouteSelection = true
[model_providers.workfreeai]
name = "workfreeai"
base_url = "https://freeworkai.top"
wire_api = "responses"
EOFLinux
打开终端。如果还没有安装 Codex CLI，可以先执行安装命令。
npm install -g @openai/codex --registry=https://registry.npmmirror.com/
Linux 配置命令
填写 API Key 后复制下面的命令，在终端中执行。
# 目标目录
dir="$HOME/.codex"
mkdir -p "$dir"
# 写 auth.json（覆盖）
cat > "$dir/auth.json" << 'EOF'
{
"OPENAI_API_KEY": "<PASTE_YOUR_WORKFREE_API_KEY>"
}
EOF
# 写 config.toml（覆盖）
cat > "$dir/config.toml" << 'EOF'
model_provider = "workfreeai"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true
[model_providers.workfreeai]
name = "workfreeai"
base_url = "https://freeworkai.top"
wire_api = "responses"
EOF验证是否成功
配置完成后，在终端输入 codex 启动。如果 Codex 能正常回复，并且你能在 WorkFreeAI 控制台看到调用记录，就说明配置成功。
常见问题
- codex 命令不存在：通常是 Codex CLI 没有安装成功，或者安装后没有重新打开终端。
- 提示认证失败：通常是 API Key 复制不完整、填错，或者这个 Key 已经被删除。
- 已经配置过 Codex：执行上面的命令会重写 ~/.codex/config.toml，建议先备份原配置。