| name | codex-provider-switch |
| description | 在服务器上切换 Codex CLI 使用用户自己的 OpenAI/ChatGPT 账号、本地 CPA/CLIProxyAPI 账号池或实验室 OpenAI-compatible endpoint。用户要求指向 CPA、实验室、切回官方账号、配置 profiles/providers、查看当前后端时使用。 |
Codex Provider Switch
默认值
- Codex 配置文件：
~/.codex/config.toml
- 官方 provider ID：
openai
- CPA provider ID：
cpa
- CPA Base URL：
http://127.0.0.1:8317/v1
- CPA 模型：
gpt-5.4-mini
- CPA API key 来源：
~/.config/cli-proxy-api/config.yaml
- 实验室 provider ID：
lab
- 实验室 Base URL：
http://10.176.60.8:8080
- 实验室模型：
gpt-5.4-mini
- 实验室 API key 来源：
CODEX_LAB_API_KEY 或 ~/.config/codex-provider-switch/lab-openai-api-key
安全选择
默认使用 profile 方式选择 provider。这样不会修改 Codex 全局默认配置，即使 CPA 或官方登录不可用，也不会把后续 Codex 调用卡在错误 provider 上。
用户想从菜单选择时，使用交互命令：
codex-swich
codex-switch 也可用，是正确拼写的别名。
codex-provider cpa
codex-provider lab
codex-provider official
codex-provider setup
codex-provider commands
codex-provider status
这些短命令应位于 ~/.local/bin/，并指向 skill 自带脚本。如果短命令不存在，直接使用脚本路径：
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py cpa
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py lab
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py official
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py setup
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py commands
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py status
cpa、lab、official、setup 模式会维护 [profiles.cpa]、[profiles.lab]、[profiles.official] 和托管 provider blocks。除非显式传入 --set-default，否则不会修改顶层 model_provider 或 model。
交互菜单前三个启动选项会以 codex --profile cpa、codex --profile lab 或 codex --profile official 启动 Codex，不修改全局默认配置。
如果只想本次启动选择 provider：
codex --profile cpa
codex --profile lab
codex --profile official
只有用户明确要求普通 codex 命令全局切换时，才使用 --set-default：
codex-provider cpa --set-default
codex-provider lab --set-default
codex-provider official --set-default
--legacy-switch 只用于兼容旧行为，会立即修改全局默认 provider。
验证
验证 CPA 前，先确保 CLIProxyAPI 正在运行：
~/.codex/skills/cliproxyapi-service/scripts/start-cliproxyapi.sh
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py cpa
codex --profile cpa exec --skip-git-repo-check --sandbox read-only '只回复：cpa ok'
验证实验室 provider：
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py lab
codex --profile lab exec --skip-git-repo-check --sandbox read-only '只回复：lab ok'
验证官方 ChatGPT/OpenAI：
~/.codex/skills/codex-provider-switch/scripts/switch-codex-provider.py official
codex login status
codex --profile official exec --skip-git-repo-check --sandbox read-only '只回复：official ok'
安全要求
- 不要打印完整 OAuth token、refresh token 或
auth.json。
- CPA 和实验室 API key 视为敏感信息。可以说明 key 存在，但除非用户明确要求，不要复述 key。
- 优先使用
codex --profile cpa、codex --profile lab 或 codex --profile official，不要优先修改顶层默认配置。
- 修改用户真实配置前，必须保留带时间戳的备份。
- 除非用户明确要求全局默认切换，不要传入
--set-default 或 --legacy-switch。
