haxsd byok

Name: haxsd-byok
Author: haxsd

在 Cursor、Devin、ChatGPT 客户端里的 Codex，以及 Claude Code CLI 与 Claude Desktop 中使用你自己配置的模型：本地模型网关，自带模型库、接管状态和调用记录。

haxsd byok 主界面

为什么用它

不换工作流：继续用 Cursor、Devin、Codex、Claude Code CLI 与 Claude Desktop 的界面和习惯，只把模型推理换成你配置的服务。
模型自己管：地址、API Key、模型 ID 都存在本机；Cursor 还支持官方 / 本地 / 混合三种模型来源，官方模型和自配模型可以同时可用。
成本看得见：每次调用的成败、耗时、Token 用量，以及按参考单价估算的金额，都在本机记录。

模型服务需要自备。Key 与设置保存在本机，请求发往你配置的服务商。

能力	说明
模型库	地址、API Key、模型 ID；支持 OpenAI Chat / Responses 与 Anthropic 协议；带连接测试
Cursor 接入	官方 / 本地 / 混合三种模型来源，含本机代理、本地 CA 与接管状态
Devin 接入	可选本机网关、模型绑定与宿主补丁
Codex 接入	ChatGPT 客户端里的本地 Codex 保留工具、终端、审批、沙箱与任务循环，只替换模型推理；支持 Responses / Chat Completions / Anthropic
Claude 接入	本机 Anthropic 网关（`/v1/messages`），适配 Claude Code CLI 与 Claude Desktop；Desktop 受组织策略托管时只给手工配置引导
调用观测	调用成败、耗时、Token 用量，按参考单价估算金额
桌面管理	中英俄三语、多主题、托盘、应用内教程与签名更新

客户端	接管方式	注意
Cursor	官方 / 本地 / 混合模型来源 + 本地 CA	开启本地或混合模式会结束正在运行的 Cursor，先保存工作；只想让自配模型生效选本地，想让官方模型同时可用选混合
Devin	可选本机网关 + 模型映射	默认关闭，只监听 `127.0.0.1`；改动端口后需重启应用并重新应用宿主补丁
Codex（ChatGPT 客户端）	本机网关 + “应用到 Codex”	保留工具、终端、审批、沙箱与任务循环，只替换推理；默认关闭，只监听 `127.0.0.1`
Claude Code CLI	本机 Anthropic 网关 + 写入 `~/.claude/settings.json` 的 `env`	默认关闭，只监听 `127.0.0.1`；应用后重新打开 Claude Code；已有 Anthropic API Key、Bedrock/Vertex/Foundry 或 `apiKeyHelper` 时拒绝覆盖；存在 `managed-settings.json` 或注册表策略时状态为「受管配置」，不改写
Claude Desktop	本机 Anthropic 网关 + 写入 `%LOCALAPPDATA%\Claude-3p\configLibrary` 的 profile	应用前完全退出 Claude Desktop（含托盘），应用后重新启动；组织策略（HKLM/HKCU）托管时只读并给手工引导，本应用不写策略

系统要求：Windows x64；一个可用的模型服务（OpenAI Chat Completions / Responses 或 Anthropic 兼容接口）。

从 Releases 下载名称含 x64-setup.exe 的安装包并安装。
在「模型」页添加地址、API Key 与模型 ID，选择协议，用「测试」确认可用。
用 Cursor：初始化本地 CA 并按提示信任，再到「Cursor」页选择模型来源。开启本地或混合模式会结束正在运行的 Cursor，先保存工作。
用 Devin：设置模型映射、启用网关并保存，重启应用后按 Devin 接入完成宿主侧。
用 Codex：在「Codex」页选择模型、启用网关并保存，点「应用到 Codex」，然后重新打开客户端或新建会话；详见 Codex 接入。
用 Claude：在「Claude」页选择默认模型、启用网关并保存，然后按客户端应用接管：Claude Code CLI 应用后重新打开 Claude Code；Claude Desktop 需先完全退出（含托盘），应用接管后再启动。详见用户指南。

地址填写、升级、备份与恢复的完整步骤见用户指南。

模型库与连接测试

本地与混合模式会改写 Cursor 的代理配置，切换模式需要重启 Cursor；官方模式不写配置，也不产生调用记录。
本地模式只认识模型库里的模型，不在库里的会被明确拒绝，不会静默走官方模型。
Devin 与 Codex 接入默认关闭，只监听 127.0.0.1；Codex 接入只改写该客户端 config.toml 的受管字段，撤销时恢复，不覆盖登录、MCP、技能或审批设置。
Claude 订阅账号接入（说明）用订阅 OAuth 作为模型来源，可能违反 Anthropic 的条款并导致限流或封号；优先使用 Anthropic API Key。本应用不伪装客户端，也无法保证平台不处罚。
本产品与 haxsd/cursor-byok 使用不同的数据目录、标识与更新渠道，两者互不影响。
本项目与 Cursor、Devin、OpenAI、Anthropic 等厂商无隶属关系。接入会改写客户端本地配置，请自行确认并遵守目标客户端与模型服务商的条款。

Windows 提示“未知发布者”或 SmartScreen 拦截？ 更新包使用本产品自己的 Tauri 更新签名，不等同于 Windows 代码签名。选择「更多信息 → 仍要运行」即可；正式分发版本以 Releases 页为准。
支持哪些模型？ 任何兼容 OpenAI Chat Completions / Responses 或 Anthropic 协议的服务，地址、Key、模型 ID 都由你填。
会上传我的 Key 或调用记录吗？ Key、设置和调用记录保存在本机；请求只发往你配置的模型服务商。
怎么回滚？ 切回官方模式后 Cursor 不再经过本地网关；Codex 侧可撤销“应用到 Codex”，恢复原配置；Claude 侧在对应标签页撤销接管，移除写入 settings.json 的键或 Desktop 的 profile。详细步骤见用户指南。
和 cursor-byok 是什么关系？ 同一作者的两个独立产品，数据目录、标识和更新渠道都不同；本项目在其基础上重做，见 UPSTREAM.md。

开发环境、构建与验证步骤见开发说明；仓库根目录的 Makefile 汇总了常用命令。第三方组件与许可见 THIRD_PARTY_NOTICES.md。

遇到问题先看故障排查，再提 Issue。请提供版本与出错步骤，不要上传 API Key、CA 私钥或整个数据库。