主题
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:
Bashbrew install node node --versionLinux(Debian / Ubuntu):
Bashcurl -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
Windows
1. 安装 Node.js(需 18+)与 Codex CLI
- 前往 Node.js 官网 下载安装 LTS 版本。
- 按 Win + R 输入
powershell打开 PowerShell,检查版本并安装 Codex CLI:
PowerShell
node --version
npm install -g @openai/codex --registry=https://registry.npmmirror.com/
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'
3. 终端验证
PowerShell 中输入 codex 启动,发一句「您好!」,能正常回复即终端配置成功。

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

Windows 商店下载(免外网): 打开 Microsoft Store,搜索
chatgpt或Codex直接安装。
3. 启动与测试
打开 Codex App,输入「你好」测试,能正常回复即可。
改完配置后如何让 Codex App 生效
修改 config.toml 或 auth.json 后,只关掉客户端窗口不会重新加载配置。请在系统托盘(Windows 右下角 / macOS 顶部菜单栏)图标上右键彻底退出 Codex App,再重新打开。
