集成

Codex CLI

让 Codex CLI 以官方半价调用 GPT 模型：在 config.toml 中把 Half Off Dev 加为模型供应商、设置密钥并选择模型。

Codex CLI 允许在 ~/.codex/config.toml 里注册额外的模型供应商。把 Half Off Dev 加进去，Codex 的 OpenAI Responses API 请求就会发到这里，GPT 模型按官方价格的一半计费，Codex 的其他配置都不用改。开始前请先创建 API 密钥。

注册供应商#

在 ~/.codex/config.toml 中加入：

~/.codex/config.toml

model = "gpt-6.1-sol"
model_provider = "halfoff"

[model_providers.halfoff]
name = "Half Off Dev"
base_url = "https://halfoff.dev/v1"
env_key = "HALFOFF_API_KEY"
wire_api = "responses"

密钥本身不写进文件，Codex 会从 env_key 指定的环境变量里读取：

Shell

export HALFOFF_API_KEY="ho-..."
codex

旧版配置

新版 Codex 不再接受 wire_api = "chat"。如果你的配置抄自旧教程，请改成 "responses"。

或者从控制台导入#

在 API 密钥页面选择 接入客户端 → Codex CLI，即可拿到已填好密钥的这段配置。用 CC Switch 一键导入 会在 CC Switch 桌面应用中添加 Half Off Dev 供应商并预设模型（需先安装 CC Switch）。新建的密钥会自动出现在对话框里；已有的密钥请粘贴完整内容，因为 Half Off Dev 只保存哈希。

模型#

这里的 Responses API 只提供 GPT 模型，请使用 gpt-* 开头的 ID。config.toml 里的 model 是默认模型，codex -m <model> 可以在单次会话中临时换一个。所有 ID 见模型列表。

提示缓存#

Codex 每个会话都会发送 prompt_cache_key。Half Off Dev 据此把同一会话的每一轮都留在持有缓存的渠道上，重复的上下文就按缓存输入价计费。详见提示缓存。

常见报错#

现象	处理方法
`401` `Missing API key`	密钥没有发到 Half Off Dev。在运行 `codex` 的 shell 里 export `HALFOFF_API_KEY`，并确认 `env_key` 写的正是这个变量名。
`401` `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或新建一个。
`404` `not served in responses format`	Responses API 只提供 GPT 模型。把 `model` 改成 `gpt-*` 开头的 ID。
`404` `Unknown endpoint /responses`	`base_url` 缺少 `/v1`。改成 `https://halfoff.dev/v1`。
Codex 拒绝 `wire_api = "chat"`	改为 `wire_api = "responses"`。
`402`	余额已用完，或密钥达到消费上限。见余额与计费。

其他状态码见错误码。