OpenAI 客户端

安装并配置 ChatGPT App、Codex CLI 和 Codex 桌面端。

前置条件

Codex CLI 需要 Node.js(安装时自带 npm);图形客户端无需额外环境。

1. 安装

安装 Codex CLI:

Windows PowerShell
npm install --global @openai/codex
macOS / Linux
npm install --global @openai/codex

需要图形客户端时,从 OpenAI 官方下载页安装 ChatGPT App 或 Codex 桌面端。Linux 使用 Codex CLI。

2. 手动配置

在目标系统上编辑 config.toml

保留 config.toml 中已有的 sandbox、MCP、项目和桌面端设置,只添加或更新下面的顶层 model_providermodel_providers.GetRun

config.toml
model_provider = "GetRun"

[model_providers.GetRun]
name = "GetRun"
base_url = "https://api.get-apikey.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "sk-xxxxx-xxx"

sk-xxxxx-xxx 替换为自己的 GetRun API Key。

Windows

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
New-Item -ItemType Directory -Force -Path $codexHome | Out-Null
notepad (Join-Path $codexHome "config.toml")

粘贴上方配置并保存。

macOS

CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
open -e "$CODEX_DIR/config.toml"

粘贴上方配置并保存。

Linux

CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
${EDITOR:-vi} "$CODEX_DIR/config.toml"

粘贴上方配置并保存。

3. 重启

完全退出 ChatGPT App、Codex CLI 或 Codex 桌面端,关闭并重新打开终端,然后重新启动要使用的客户端。

4. 确认回复

只发送一次消息确认:

codex exec --skip-git-repo-check "只回复 OK"

Codex CLI 返回 OK 即表示配置完成。图形客户端则新建会话并发送“只回复 OK”。

本页内容