客户端接入
用一个 Half Off Dev 密钥，让 Claude Code、Codex CLI、Gemini CLI、Cherry Studio、DeepChat、AionUI 等客户端以半价调用模型。
只要客户端允许修改 API base URL，就能接入 Half Off Dev，它发出的每个请求都按官方价格的一半计费。要改的永远是两项：接入地址和密钥；提示词、设置和使用习惯都不用动。开始前请先创建一个 API 密钥。
选择你的客户端#
每篇指南完整覆盖一个客户端：配置文件或命令、该选哪些模型，以及常见报错的处理。
使用 Anthropic Messages 协议。两个环境变量或 settings.json 即可，提示缓存照常生效。
使用 OpenAI Responses API 和 GPT 模型。在 config.toml 中加一段供应商配置。
使用 Gemini API。两个环境变量。
桌面聊天客户端。OpenAI 兼容供应商，可一键导入。
桌面聊天客户端。OpenAI 兼容供应商，可一键导入。
桌面聊天客户端。OpenAI 兼容供应商，可一键导入。
任何支持自定义 OpenAI 端点的应用、框架或库。
官方 OpenAI、Anthropic 和 Google Gen AI SDK，含 Python 与 Node.js 示例。
让控制台帮你填好#
在 API 密钥页面，每个密钥都有一个 接入客户端 按钮（刚创建的密钥旁边是 接入客户端…）。点开后的对话框里，上面每个客户端的配置都已填好你的密钥，还附带一键导入入口：
- Claude Code、Codex CLI、Gemini CLI： 用 CC Switch 一键导入 会在 CC Switch 桌面应用中添加 Half Off Dev 供应商，模型也一并设好。需要先安装 CC Switch。
- Cherry Studio、DeepChat、AionUI： 在 应用 中打开 会直接在该应用里添加 Half Off Dev 供应商。需要先安装对应应用。
刚创建的密钥会自动出现在对话框中。如果是之前创建的密钥，需要自己粘贴完整密钥：系统只存了哈希，Half Off Dev 无法再次显示它。
base URL 怎么填#
取决于客户端使用的 API 格式，与选用的模型无关：
| API 格式 | 使用方 | Base URL |
|---|---|---|
| Anthropic Messages | Claude Code、Anthropic SDK | https://halfoff.dev |
| OpenAI Chat Completions 与 Responses | Codex CLI、OpenAI SDK、OpenAI 兼容应用 | https://halfoff.dev/v1 |
| Gemini | Gemini CLI、Google Gen AI SDK | https://halfoff.dev |
| OpenAI 兼容的“API 地址”字段 | Cherry Studio、DeepChat、AionUI | https://halfoff.dev（应用会自动补上 /v1） |
出错时#
| 现象 | 处理方法 |
|---|---|
401 Missing API key | 密钥没有发到 Half Off Dev。检查变量名，并确认它是在启动客户端的同一个 shell 里 export 的。 |
401 Invalid or revoked API key | 密钥输错、被截断或已吊销。重新粘贴，或新建一个。 |
404 Model '...' is not available | 模型 ID 不存在。从 GET /v1/models 或模型列表复制。 |
404 Unknown endpoint | 客户端请求了 Half Off Dev 不提供的 API，例如 embeddings。请改用 Chat Completions、Responses、Anthropic Messages 或 Gemini 格式。 |
404 且路径里有 /v1/v1/ | 客户端会自己加 /v1。地址填 https://halfoff.dev 即可。 |
402 | 余额已用完，或密钥达到消费上限。见余额与计费。 |
各客户端特有的报错见对应指南，所有状态码见错误码。