Skip to content

Codex 桌面版 ​

Codex 桌面 App 直接读取本机 ~/.codex/(Windows 为 %USERPROFILE%\.codex\)下的终端配置文件。先在终端装好 Codex CLI 并验证通过,再打开桌面 App 即可直接使用。

  • 协议与地址: OpenAI Responses 协议,base_url 填 https://aicode.cat/v1(要加 /v1)。
  • 前置准备: 先到 创建 API Key 拿一把绑定了 OpenAI / Codex 分组的 Key。

1. 终端安装与配置 Codex ​

macOS / Linux ​

1. 安装 Node.js(需 18+)与 Codex CLI ​

  • macOS: 先装 Homebrew,再装 Node.js:

    Bash
    brew install node
    node --version
  • Linux(Debian / Ubuntu):

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

安装 Codex CLI(已装过可跳过):

Bash
npm install -g @openai/codex --registry=https://registry.npmmirror.com/

2. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key(model 以 主站控制台 为准):

Bash
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-6.1"

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

echo "配置完成"

核对配置(只检查字段和地址,不打印 Key):

Bash
grep -q '"OPENAI_API_KEY"' "$HOME/.codex/auth.json" && echo 'OPENAI_API_KEY=<已设置>'
grep '^base_url' "$HOME/.codex/config.toml"

核对配置

3. 终端验证 ​

终端输入 codex 启动,发一句「您好!」,能正常回复即说明配置生效。

终端打招呼

Windows ​

1. 安装 Node.js(需 18+)与 Codex CLI ​

  1. 前往 Node.js 官网 下载安装 LTS 版本。
  2. 按 Win + R 输入 powershell 打开 PowerShell,检查版本并安装 Codex CLI:
PowerShell
node --version
npm install -g @openai/codex --registry=https://registry.npmmirror.com/

node --version

2. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key,在 PowerShell 执行:

PowerShell
$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-6.1"

[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))
)

核对配置:

PowerShell
if (Select-String -Path "$env:USERPROFILE\.codex\auth.json" -Pattern 'OPENAI_API_KEY') { 'OPENAI_API_KEY=<已设置>' }
Select-String -Path "$env:USERPROFILE\.codex\config.toml" -Pattern '^base_url'

Windows 核对配置

3. 终端验证 ​

PowerShell 中输入 codex 启动,发一句「您好!」,能正常回复即终端配置成功。

终端打招呼

2. 下载 Codex App ​

  • 官网下载(需外网): 打开 https://developers.openai.com/codex/app,按系统下载安装包。

    Codex App 下载页

  • Windows 商店下载(免外网): 打开 Microsoft Store,搜索 chatgpt 或 Codex 直接安装。

    Microsoft Store 搜索下载

3. 启动与测试 ​

打开 Codex App,输入「你好」测试,能正常回复即可。

改完配置后如何让 Codex App 生效

修改 config.toml 或 auth.json 后,只关掉客户端窗口不会重新加载配置。请在系统托盘(Windows 右下角 / macOS 顶部菜单栏)图标上右键彻底退出 Codex App,再重新打开。

Codex App 测试