主题
语言

Codex Desktop(ChatGPT)

Windows 和 macOS 上 ChatGPT 应用中的 Codex 分步设置:退出 ChatGPT,使用 GetVibe API 密钥、base_url 登录,并验证支出。

现成配置

根据请求从我们的目录生成:包含 API 地址、所有已发布的模型及其上下文和输出限制,以及推荐设置。其中不含密钥。Codex 从 GETVIBE_API_KEY(env_key)读取密钥。单次运行使用低价模型:codex -m <model ID>;使用最高推理强度:codex -c model_reasoning_effort="high"。请删除此文件旧版本遗留的 [profiles.*] 表——只要这些表仍存在,Codex 0.134 及更高版本就会拒绝使用 --profile。

# macOS / Linux
mkdir -p ~/.codex
curl -fsSL https://getvibeapi.com/api/integrations/codex.toml -o ~/.codex/config.toml
# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/codex.toml -OutFile "$HOME\.codex\config.toml"
  • 主模型 — gpt-6.1-sol:具备强大代理能力的编码模型,拥有较大的上下文窗口,价格适中;使用不带限定的 id 可保持跨渠道故障转移。
  • 小型任务 — deepseek-v4.1-flash:最便宜且能力足够、支持 1M 上下文的模型,用于标题、摘要、提交消息和压缩。
  • 启用流式传输,请求超时时间为 600 秒,推理力度为 medium:较长的推理回答需要几分钟,而不使用流式传输会达到等待时限。
  • 所有地方都使用不带 :suffix 的纯模型 ID,这样可以保持自动故障转移到健康通道的功能。
目录会发生变化:出现新模型时,请再次下载该文件。若只保留部分模型,请在 URL 中添加带逗号分隔 ID 的 ?models=。

Codex Desktop 现在位于适用于 Windows 和 macOS 的 ChatGPT 应用中。无需使用终端即可将其连接到 GetVibe API:该应用会读取与 Codex CLI 相同的 config.toml 文件。

1. 安装应用

打开官方 ChatGPT 桌面版页面,选择 macOS 或 Windows,安装并启动应用。在左上角的切换选项中选择 Codex。

Codex Desktop:精确密钥配置

Codex Desktop 是一个 GUI 应用。它必须通过 config.toml 使用 GetVibe,并读取 auth.json 中的密钥,而不能使用当前活动的 ChatGPT 会话。

在 Terminal 中执行的 export 命令不会被已经运行的 GUI 应用继承。因此,在 Terminal 中执行 export OPENAI_BASE_URL 和 export OPENAI_API_KEY 不会配置 Codex Desktop:该应用有自己的环境。
如果 config.toml 包含 requires_openai_auth = true,且应用中存在有效的 Sign in with ChatGPT 会话,Codex 会使用该 OAuth 登录,并将请求发送到 OpenAI,而不是 GetVibe。请退出 ChatGPT,将 GetVibe 密钥放入 auth.json,并使用以下设置。

config.toml

将此代码块保存到 ~/.codex/config.toml。getvibeapi.com 占位符会自动替换。

model = "gpt-5.6-luna"
model_provider = "getvibe"
model_reasoning_effort = "high"

[model_providers.getvibe]
name = "GetVibe API"
base_url = "https://getvibeapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json

将此 JSON 保存到 ~/.codex/auth.json,并将该值替换为你的真实 sk-pv-… 密钥。

{"OPENAI_API_KEY": "PASTE_YOUR_GETVIBE_KEY_HERE"}
不要将 $GETVIBE_API_KEY 放入 auth.json:JSON 不会展开环境变量。不要发布此文件,也不要将其提交到 Git。

完全重启应用

更改 config.toml 或 auth.json 后,请完全退出应用:macOS 按 Cmd+Q;Windows 选择 Exit。仅关闭窗口或使用 Restart daemon 并不足够:应用必须重新读取这两个文件。

打开新的 Codex 聊天,发送一条简短的测试消息,然后在 Dashboard → Usage 中检查是否有新记录。如果没有记录,请求就没有通过 GetVibe。

如果再次出现“403 Country, region, or territory not supported from api.openai.com”,说明密钥未被读取:请检查 auth.json,再次退出 ChatGPT 并完全退出应用。
Codex Desktop + GetVibe API — 无终端配置 | GetVibe API