codex-safe-switch 1.0.4

Switch between OpenAI Codex CLI provider configurations (official OpenAI provider, third-party relays, multiple API keys). CLI + Alfred workflow.

codex-safe-switch

中文 | English

在官方 ChatGPT、第三方 relay、多组 API key 之间切换 Codex CLI 配置。

30 秒上手

uv tool install codex-safe-switch
codex-safe-switch

第一次运行会导入你当前的 ~/.codex/config.toml。

之后常用的就三个命令：

codex-safe-switch ls            # 看已有 profiles
codex-safe-switch use myrelay   # 切到 relay / 自定义 provider
codex-safe-switch official      # 切回官方 ChatGPT

保存一个新 profile

先把 Codex 手动配置到能用的状态。比如你已经配好了某个 relay，并确认 codex 能跑。

然后保存：

codex-safe-switch save myrelay

以后就可以这样切回去：

codex-safe-switch use myrelay

第一次用时会怎样

你现在的状态	会发生什么
正在用官方 ChatGPT	自动保存成 official
正在用 relay / 自定义 provider	自动保存成当前 provider 名
登录过 ChatGPT，但当前正在用 relay	先保存当前 relay；以后跑 codex-safe-switch official 回官方
还没有 ~/.codex/config.toml	提示你先配置一次 Codex

codex-safe-switch official 不需要提前存在 official profile。缺少时会自动创建默认官方配置再切换。

它不会碰登录信息

这个工具只切换 provider 配置。

它不会保存、复制或覆盖：

• ~/.codex/auth.json
• ChatGPT 登录 token
• API key 文件
• trusted projects、插件、MCP、TUI 偏好

如果你切到官方后还没登录过 ChatGPT，Codex 会自己提示你登录。

历史会话不见了

通常不是历史丢了，只是历史记录里的 provider 跟当前 provider 对不上。

先看状态：

codex-safe-switch doctor-history

然后切到你想用的 profile，工具会自动对齐历史：

codex-safe-switch use myrelay
# 或
codex-safe-switch official

更多命令

codex-safe-switch              交互选择 profile
codex-safe-switch ls           列出 profiles
codex-safe-switch current      显示当前 profile
codex-safe-switch use <name>   切到指定 profile
codex-safe-switch official     切回官方 ChatGPT
codex-safe-switch save <name>  保存当前 provider 配置
codex-safe-switch show <name>  查看 profile 内容
codex-safe-switch rm <name>    删除 profile
codex-safe-switch restart-codex
                               重启 Codex app/server 进程
codex-safe-switch merge-history --dry-run
                               预览历史修复
codex-safe-switch merge-history
                               修复历史 metadata

use 和 official 可以加 --restart-codex：

codex-safe-switch use myrelay --restart-codex

Alfred

安装后双击 alfred/codex-safe-switch.alfredworkflow 导入，关键词是 cx。

如果 Alfred 找不到命令，先看安装位置：

uv tool dir --bin

然后把 workflow 里的命令路径改成对应的 codex-safe-switch。

文件位置和环境变量

Profiles 默认放在：

~/.codex/profiles/
├── .active
├── .official/
│   └── provider.toml
└── myrelay/
    └── provider.toml

环境变量：

变量	默认值	用途
CODEX_PROFILE_ROOT	~/.codex/profiles	profile 存放位置
CODEX_HOME	~/.codex	Codex 配置目录

relay profile 示例见 examples/relay-profile/provider.toml。

License

MIT