Codex 接入

Codex 通过自定义模型提供方接入 Lumoswitch。当前配置使用 Responses API，因此配置 API 必须支持相应输出。

设置 Access Key

export LUMOSWITCH_API_KEY="your-lumoswitch-access-key"

将环境变量写入 shell 配置后，需要重新打开终端，或者执行 source ~/.zshrc。

编辑配置文件

打开 ~/.codex/config.toml，加入：

model = "your-public-model-name"
model_provider = "lumoswitch"
 
[model_providers.lumoswitch]
name = "Lumoswitch"
base_url = "https://your-gateway.example.com/v1"
env_key = "LUMOSWITCH_API_KEY"
wire_api = "responses"

如果文件中已经存在顶层 model 或 model_provider，请修改原值，不要重复声明同一个 TOML 键。

启动与验证

codex

进入会话后发送一个最小请求。若 Codex 提示找不到环境变量，可先验证：

test -n "$LUMOSWITCH_API_KEY" && echo "key loaded"

常见问题

• wire_api 必须是 responses，否则 Codex 的请求格式可能与配置 API 不一致。
• base_url 应包含 /v1，不要填写具体的 /responses 路径。
• 使用 GUI 或桌面启动器时，它可能不会继承终端环境变量；应从已加载变量的终端启动。
• 更新配置后请完全退出并重新启动 Codex。