Codex 桌面版

macOS / Linux Windows

先在本机写好 Codex 的终端配置，桌面 App 会读同一份文件。配好后再下载 Codex App 做测试。

Codex 走 GPT 协议，base_url 填 https://aicode.cat/v1，要加 /v1。

先到 创建 API Key 拿一把 Key。终端配置目录是 ~/.codex/（Windows 在用户目录下的 .codex）。

终端完整配置成功后，即可使用 Codex App。若还没装 Codex CLI，先按 Codex（终端） 装好 @openai/codex，再写下面的配置。

1. 终端配置 Codex

macOS

1. 安装 Node.js

先确认本机有 Homebrew。没有的话，打开该页，复制安装命令执行。安装 Homebrew 时有一部分资源在海外，需要设置 TUN 代理。

装好后用 Homebrew 安装 Node.js（已经安装可以跳过）：

brew install node

验证安装：

node --version

出现版本号即成功。需要 Node.js 18+。

2. 创建配置文件

Key 在 用户仪表盘密钥页 创建。把 在这里替换成你的_API_KEY 换成你的 Key。model 以控制台为准：

dir="$HOME/.codex"
mkdir -p "$dir"

cat > "$dir/auth.json" << 'EOF'
{
  "OPENAI_API_KEY": "在这里替换成你的_API_KEY"
}
EOF

cat > "$dir/config.toml" << 'EOF'
model_provider = "codex"
model = "gpt-5.5"

[model_providers.codex]
name = "codex"
base_url = "https://aicode.cat/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
EOF

echo "配置完成"

验证是否写成功：

cat "$HOME/.codex/auth.json"
cat "$HOME/.codex/config.toml"

应看到 base_url = "https://aicode.cat/v1"。

3. 验证安装

终端输入 codex 启动，在对话框里输入「您好！」。能正常回复，再到 密钥页 / 控制台能看到调用，即配置成功。

Linux

1. 安装 Node.js

已经安装可以跳过：

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

验证安装：

node --version

出现版本号即成功。需要 Node.js 18+。

2. 创建配置文件

Key 在 用户仪表盘密钥页 创建。把 在这里替换成你的_API_KEY 换成你的 Key。model 以控制台为准：

dir="$HOME/.codex"
mkdir -p "$dir"

cat > "$dir/auth.json" << 'EOF'
{
  "OPENAI_API_KEY": "在这里替换成你的_API_KEY"
}
EOF

cat > "$dir/config.toml" << 'EOF'
model_provider = "codex"
model = "gpt-5.5"

[model_providers.codex]
name = "codex"
base_url = "https://aicode.cat/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
EOF

echo "配置完成"

验证是否写成功：

cat "$HOME/.codex/auth.json"
cat "$HOME/.codex/config.toml"

应看到 base_url = "https://aicode.cat/v1"。

3. 验证安装

终端输入 codex 启动，在对话框里输入 您好！。能正常回复，再到 密钥页 / 控制台能看到调用，即配置成功。

以下是 Windows

Windows

1. 安装 Node.js

前往 Node.js 官网 下载并安装 LTS 版本（已经安装可以跳过）。

验证安装：

node --version

出现版本号即说明 Node 已装好。需要 Node.js 18+。

2. 创建配置文件

Key 在 用户仪表盘密钥页 创建，步骤见 创建 API Key。

按 Win + R，输入 Powershell，打开 PowerShell（建议以管理员身份运行）并执行。把 在这里替换成你的_API_KEY 换成你的 Key。model 以 主站控制台 为准：

$dir = Join-Path $env:USERPROFILE ".codex"

New-Item -ItemType Directory -Path $dir -Force | Out-Null

$auth = @'
{
  "OPENAI_API_KEY": "在这里替换成你的_API_KEY"
}
'@
[System.IO.File]::WriteAllText(
  (Join-Path $dir "auth.json"),
  $auth,
  (New-Object System.Text.UTF8Encoding($false))
)

$config = @'
model_provider = "codex"
model = "gpt-5.5"

[model_providers.codex]
name = "codex"
base_url = "https://aicode.cat/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
'@
[System.IO.File]::WriteAllText(
  (Join-Path $dir "config.toml"),
  $config,
  (New-Object System.Text.UTF8Encoding($false))
)

验证是否写成功：

Get-Content "$env:USERPROFILE\.codex\auth.json"
Get-Content "$env:USERPROFILE\.codex\config.toml"

应看到 OPENAI_API_KEY 和 base_url = "https://aicode.cat/v1"。

3. 验证安装

PowerShell 中输入 codex 启动：

在对话框里输入「您好！」打个招呼。能正常回复，再到 密钥页 / 控制台能看到调用，即终端配置成功。失败先看 常见报错。

2. 下载 Codex App

下载页面需要能访问外网。

打开 https://developers.openai.com/codex/app，按你的系统选择对应安装包。

Windows 也可以不走外网下载：左下角搜索「windows 商店」，打开 Microsoft Store。

搜索 chatgpt：

下载即可。

3. 测试

下载完成后打开 Codex App，输入「你好」测试，能正常回复即可。失败先看 常见报错。