Linux

1）先装 Node.js / npm（不同发行版命令不同）。

2）安装与验证：

sudo npm install -g @openai/codex
codex --version

配置星光API

Codex CLI 会读取你的配置文件：一般在 ~/.codex/（Windows 也是用户目录下的 .codex）。创建两份文件：

auth.json：放密钥

config.toml：放模型与网关配置

auth.json（把 sk-xxx 换成星光API Key）

{"OPENAI_API_KEY": "sk-xxx"}

config.toml


model_provider = "xgapi"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.xgapi]
name = "xgapi"
base_url = "https://api.xgapi.top/v1"
wire_api = "responses"

macOS / Linux 配置命令

创建文件：

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

编辑 auth.json（粘贴同样的 JSON）与 config.toml。要保证上下一致：model_provider = "xxx" 要和 [model_providers.xxx] 的段名一致。

配置改完一定要“重启终端”

关闭终端/重启终端后再启动 codex，让配置生效。

CodeX安装配置教程(Linux)

Linux#

配置星光API#

macOS / Linux 配置命令#

配置改完一定要“重启终端”#

Linux

配置星光API

macOS / Linux 配置命令

配置改完一定要“重启终端”