# Codex 插件自定义模型配置

## GitLab 文件

插件文件已经放在 GitLab 项目的 `codex/windows/vscode/latest` 目录：

- `Run-CodexPluginSetup.ps1`
- `CodexPluginCompanyPackage.zip`

压缩包内只包含模型目录和补丁脚本，不包含 `auth.json`、API Key 或其他授权信息。

## Windows 同事执行

在 Windows PowerShell 中执行下面一条命令：

```powershell
irm 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/windows/vscode/latest/Run-CodexPluginSetup-Remote.ps1' | iex
```

命令会先备份本机 `models.json`（如果存在），再用公司提供的 `models.json` 覆盖本机模型目录；文件不存在时会自动创建。随后更新本机 `model_catalog_json` 和默认模型，并修改当前 `openai.chatgpt` 扩展的模型筛选逻辑。Provider、服务地址、本机登录状态和授权信息不会被覆盖。

## 配置完成后

完全退出所有 VS Code 窗口，再重新打开 VS Code。只执行 `Developer: Reload Window` 不会重新加载已缓存的扩展资源。模型菜单应显示：

- `Dev S 0.56X`（`dev-s-0.56x`）
- `Dev T 0.56X`（`dev-t-0.56x`）
- `Dev L 0.56X`（`dev-l-0.56x`）
- `Dev 0.55X`（`dev-0.55x`）
- `Dev 0.54X`（`dev-0.54x`）
- `Dev M 0.54X`（`dev-m-0.54x`）

如果 GitLab Raw 地址返回 HTML 页面而不是 ZIP，入口脚本会停止并提示检查发布路径。

## macOS 同事执行

完全退出 VS Code 后，在 macOS 终端中执行：

```sh
curl -fsSL 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/macos/vscode/latest/Run-CodexPluginSetup.sh' | sh
```

该入口会更新 `~/.codex/models.json` 和 `~/.codex/config.toml`，并修改当前 `openai.chatgpt` 插件的模型筛选逻辑。默认插件目录是 `~/.vscode/extensions`；如果使用 VS Code Insiders，可先设置 `CODEX_VSCODE_EXTENSIONS="$HOME/.vscode-insiders/extensions"`。要求系统已有 `curl` 和 `python3`。

## 恢复官方模型

如果需要恢复官方模型目录和插件原始筛选逻辑，完全退出 VS Code 后执行：

Windows：

```powershell
irm 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/windows/vscode/latest/Run-CodexOfficialRestore-Remote.ps1' | iex
```

macOS：

```sh
curl -fsSL 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/macos/vscode/latest/Run-CodexOfficialRestore.sh' | sh
```

命令会备份并移除 `model_catalog_json`，将默认模型设置为 `gpt-5.5`，并使用插件目录中的 `.company-original` 文件恢复原始资源。恢复后必须完全退出并重新打开 VS Code。