# Xuai Codex provider installer

这套脚本把 Codex 的用户级配置切换到你提供的 Xuai provider：

```toml
model_provider = "custom"
model = "gpt-6-astra"
model_reasoning_effort = "medium"
disable_response_storage = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.xuai.chat/v1"
```

脚本只改写这些受管字段和 `[model_providers.custom]` 表，其他 Codex 设置、MCP 配置和项目配置会保留。首次运行会把原来的 `config.toml` 备份到：

```text
~/.codex/backup-xuai/config.toml
```

再次运行可选择恢复。恢复会用安装前的备份覆盖当前 `config.toml`，因此脚本会先要求输入 `y` 确认。

## 使用方式

本项目将脚本发布到 `https://setup.xuai.chat/`。

Windows PowerShell：

```powershell
irm https://setup.xuai.chat/install-xuai-codex.ps1 | iex
```

macOS / Linux：

```bash
bash <(curl -fsSL https://setup.xuai.chat/install-xuai-codex.sh)
```

也可以下载后审阅再运行：

```powershell
irm https://setup.xuai.chat/install-xuai-codex.ps1 -OutFile .\install-xuai-codex.ps1
powershell -ExecutionPolicy Bypass -File .\install-xuai-codex.ps1
```

```bash
curl -fsSLo install-xuai-codex.sh https://setup.xuai.chat/install-xuai-codex.sh
bash install-xuai-codex.sh
```

脚本要求用户已经运行过 Codex，使 `~/.codex`（或 `CODEX_HOME` 指向的目录）存在。`requires_openai_auth = true` 表示使用 Codex 已有的 OpenAI 身份认证；脚本不会读取、询问或上传 API Key。

安装后需要完全退出并重新打开 Codex。脚本不会生成 `models.json`：这里使用的 `gpt-6-astra` 由 Codex 的模型目录或当前客户端提供元数据，脚本只负责 provider 路由和本地配置。如果客户端明确提示缺少模型元数据，再针对该客户端版本补充 catalog，不应凭空猜测上下文或工具能力。

官方配置参考：<https://learn.chatgpt.com/docs/config-file/config-reference>