ChatGPT（Codex）CLI 安装与配置 KoalaAPI

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。

配置速查

配置项	填写内容
Base URL	`https://koalaapi.com/v1`
API Key	控制台 → 令牌管理创建的令牌，形如 `sk-...`
模型名称	与控制台【模型广场】完全一致；不同令牌分组可用的模型不同

适用版本

Codex CLI @openai/codex 当前版本（2026-11 核对）

Windows 10/11、macOS 12+、Linux、WSL

需要 Node.js 18 或更高版本（node -v 查看）

一、安装

方式一：npm（全平台通用）

方式二：Homebrew（macOS）

安装完成后新开一个终端验证：

后续升级：

二、配置 KoalaAPI

1. 创建配置文件

配置文件路径为 ~/.codex/config.toml（Windows 为 C:\Users\你的用户名\.codex\config.toml），不存在时手动新建。

# 全局默认配置
model_provider = "koalaapi"
model = "gpt-6.1-sol"          # 名称必须与【模型广场】完全一致

# KoalaAPI 模型供应商
[model_providers.koalaapi]
name = "KoalaAPI"
base_url = "https://koalaapi.com/v1"
env_key = "FOURSAPI_API_KEY"   # 这里填变量名，不要把 key 直接写进来；变量名不能以数字开头
wire_api = "responses"
query_params = {}
request_max_retries = 3
stream_max_retries = 8

说明：

wire_api 用 responses 走 Responses 协议；如果你的分组或工具只支持 Chat Completions，改成 chat。

想换模型，只改 model 一行，或用 codex -m 模型名 临时指定。

2. 写入 API Key

Windows（PowerShell 或 CMD，永久生效）

setx FOURSAPI_API_KEY "sk-你的令牌"

执行后关闭所有已打开的终端窗口，重新打开一个才会生效。

macOS / Linux / WSL

用的是 bash 就写入 ~/.bashrc。

三、验证

（截图待补）

能正常返回内容即配置成功。首次启动会提示登录方式，选择使用 API Key / 环境变量的方式即可，不要走 ChatGPT 账号登录。

四、常见问题

Q：提示 401 / 未授权？
A：环境变量没生效。确认变量名是 FOURSAPI_API_KEY，并且是在设置之后新开的终端里运行。

Q：提示模型不存在？
A：model 必须与【模型广场】里的名称逐字一致；同时确认令牌分组包含该模型。

Q：想临时换模型？

Q：wire_api 选 responses 还是 chat？
A：KoalaAPI 两种都支持。responses 更贴近官方行为，缓存命中更好；接入第三方工具或遇到兼容问题时改用 chat。

为什么推荐用它跑 GPT

Codex CLI 是 OpenAI 官方客户端，缓存由它自己维护，不容易失效。用桌面聊天客户端跑长任务时历史会被反复整理，容易把请求开头改掉，缓存整段失效、账单偏高。怎么选见《客户端怎么选》。

更新于 2026-11　官方文档：https://developers.openai.com/codex/cli

ChatGPT（Codex） CLI 安装与配置 koalaapi

ChatGPT（Codex）CLI 安装与配置 KoalaAPI#

适用版本#

一、安装#

二、配置 KoalaAPI#

1. 创建配置文件#

2. 写入 API Key#

三、验证#

四、常见问题#

为什么推荐用它跑 GPT#