Codex 接入

Codex 推荐使用 OpenAI Responses API。NexaGW 的 GPT 分组支持对应协议，配置中的 wire_api 固定为 responses。

选择配置方式

手动配置

1. 备份现有配置

复制 ~/.codex/config.toml 到带时间戳的安全位置。若文件尚不存在，记录这一状态，以便回滚时恢复为“不存在”。

2. 安全设置 Key 环境变量

PowerShell
Bash / Zsh

$SecureKey = Read-Host 'Paste the NexaGW API Key' -AsSecureString
$Pointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecureKey)
try {
  $Value = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($Pointer)
  [Environment]::SetEnvironmentVariable('NEXAGW_API_KEY', $Value, 'User')
  $env:NEXAGW_API_KEY = $Value
} finally {
  $Value = $null
  [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($Pointer)
}

IFS= read -r -s NEXAGW_API_KEY
export NEXAGW_API_KEY
printf '\n'

PowerShell 命令会保存到当前用户环境变量；Bash / Zsh 示例只对当前终端生效，持久保存方式见备份、安全与恢复。

3. 编辑 `~/.codex/config.toml`

model = "gpt-5.6-sol"
model_provider = "nexagw"

[model_providers.nexagw]
name = "NexaGW"
base_url = "https://api.nexagwapi.com/v1"
env_key = "NEXAGW_API_KEY"
wire_api = "responses"

若原文件已有其他 provider、MCP、profiles、权限或功能配置，请保留它们，只合并上面的两个根字段和 NexaGW provider 表。

$Headers = @{ Authorization = "Bearer $env:NEXAGW_API_KEY" }
(Invoke-RestMethod https://api.nexagwapi.com/v1/models -Headers $Headers).data.id

curl -fsS https://api.nexagwapi.com/v1/models \
  -H "Authorization: Bearer $NEXAGW_API_KEY"

返回模型列表后，确认其中包含 gpt-5.6-sol。

5. 从新终端启动 Codex

完全退出旧 Codex 进程，打开继承了环境变量的新终端：

codex

切换线路

主线路：

base_url = "https://api.nexagwapi.com/v1"

香港线路：

base_url = "https://api.nexagw.org/v1"

两条线路使用同一个 Key。自动工具可通过 Switch 操作先备份再切换。

场景	模型
日常编码与复杂任务	`gpt-5.6-sol`
均衡速度与质量	`gpt-5.6-terra`
快速任务	`gpt-5.6-luna`
兼容与回退	`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`