codex-provider-switch

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。