返回工具目录
桌面客户端

Codex Desktop

一键接入:运行脚本后重启桌面端即可使用

/v1/responses一键接入docs/ai-gateway-editor-codex-desktop.md
创建 API Key
Base URLhttps://api.4stoken.cn
鉴权方式Authorization: Bearer sk-...
协议/v1/responses
Download

下载安装教程

先安装工具本体,再运行 4SToken 配置脚本。Windows 与 macOS / Linux 分开操作。

安装前准备
准备已安装 Codex Desktop
准备已创建 Portal Client Key
准备目标 Codex 菜单模型名已在 Gateway 配置映射
Windows
1下载并安装 Codex Desktop
2运行本页 PowerShell 脚本
3完全退出 Codex Desktop 后重新打开
macOS / Linux
1下载并安装 Codex Desktop
2运行本页 macOS / Linux 脚本
3完全退出 Codex Desktop 后重新打开
Install

配置命令

将命令中的 YOUR_API_KEY 替换成你的 Client Key。

macOS / Linux
curl -fsSL https://4stoken.cn/docs/scripts/codex-desktop.sh | GATEWAY_BASE_URL='https://api.4stoken.cn' bash -s -- YOUR_API_KEY
Windows PowerShell
$f = Join-Path $env:TEMP 'codex-desktop.ps1'; Invoke-WebRequest -Uri 'https://4stoken.cn/docs/scripts/codex-desktop.ps1' -OutFile $f -UseBasicParsing; powershell -NoProfile -ExecutionPolicy Bypass -File $f -ApiKey YOUR_API_KEY
Verify

配置检查

按顺序检查:先测接口连通,再做模拟调用,最后回到具体软件核对配置是否真正生效。

连通性检查

先确认 Key、Base URL 与模型列表接口可达。

执行模型列表查询,确认返回 200 且能看到可用模型
curl https://api.4stoken.cn/v1/models -H "Authorization: Bearer YOUR_API_KEY"

模拟调用

绕开客户端先打一次最小请求,确认网关协议与模型路由正确。

执行最小请求,确认没有 401、403、404、模型不存在或无路由错误
curl https://api.4stoken.cn/v1/responses -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"model\":\"gpt-5.5\",\"input\":\"hello\"}"

其他

回到具体软件内确认配置文件、界面设置或重启步骤已经生效。

完全退出 Codex Desktop 后重新打开
在客户端内发起一次对话或代码任务
Models

模型映射

Codex 模型名系统实际模型
gpt-5.5gpt-5.5
gpt-5.4gpt-5.4
gpt-5.4-minigpt-5.4-mini
gpt-5.4-nanogpt-5.4-nano
gpt-5.3-codexgpt-5.3-codex
gpt-5.1-codexclaude-opus-4-6
gpt-5.3-codex-xhighclaude-opus-4-8
Notes

接入边界

  • 脚本仅修改本机工具配置文件,可通过上方源码链接审计。
  • 执行前可设置 GATEWAY_BASE_URL 覆盖默认网关地址。
  • GET /v1/realtime 未开放,不影响编程工具接入。