Open Code Go Tools

ocgt — Claude Code 与 Codex 的桌面客户端与本地代理

ocgt（OpenCode Go Tools）主要是为 OpenCode Go 套餐（opencode.ai/go）打造的桌面客户端与本地代理：默认上游就是 OpenCode Go，内置针对 OpenCode Go 的额度看板，让 Claude Code 和 Codex 直接接到你的 OpenCode Go 订阅上。

同时它也支持其他 OpenAI / Anthropic 兼容的上游供应商——作为一个本地 HTTP 代理，它在 Anthropic、OpenAI Chat Completions、OpenAI Responses 三种协议之间做转换，让原本只认某一种协议的客户端也能接到任意兼容供应商上。

界面提供中英双语，覆盖供应商与账号管理、模型配置、流量与额度监控、会话查看、跨设备同步，以及 Claude Code / Codex 的客户端接入配置。当前版本 v4.0.3。
English: docs/README.en-US.md

它解决什么问题

- 把 Claude Code 和 Codex 接到 OpenCode Go 订阅上，并在同一个界面里看 OpenCode Go 的额度用量（Rolling / Weekly / Monthly）——这是它的主要用途。
- Claude Code 只说 Anthropic 协议，Codex 只说 OpenAI Responses 协议，而很多第三方供应商（DeepSeek、Kimi、MiniMax、Qwen 等）只提供 OpenAI Chat Completions 接口。ocgt 在中间做协议转换，让这些客户端和供应商互通。
- 一个供应商配一套账号池，某个账号被限流、鉴权失败或额度耗尽时自动切换到下一个，不用手动改配置。
- Claude 和 Codex 各自维护当前生效的上游，互不干扰。

功能

协议转换与请求路由

- 按当前供应商的协议自动选择转发方式：Anthropic 上游走 /v1/messages，OpenAI 上游走 /v1/chat/completions，原生 Responses 上游直接透传 /v1/responses。
- Codex 的 Responses API 请求会被完整翻译：工具定义、tool_choice（auto / none / required / 指定函数）、parallel_tool_calls、多轮工具调用的续传，以及推理摘要。
- 非视觉模型会自动清洗掉图片内容，避免上游报错。

供应商与账号

- Claude 和 Codex 分别选择各自当前生效的上游供应商。
- 同一供应商下可维护多个账号 / API Key，按账号分别查询额度。
- 账号轮换：某账号遇到 5xx、网络错误、鉴权失败或限流时，按策略切换到账号池里的下一个（连续 3 次失败进入 30 秒冷却）。
- 模型级故障转移：请求的模型不可用时，沿配置的 fallback 链依次尝试候选模型。
- 熔断器：某个模型连续失败到阈值后短暂熔断，避免对已知故障上游反复打请求。
- 令牌桶限流与 RPM 限制，按客户端 IP 生效。
- 配置保存后热重载，无需重启进程。

模型配置

- 每个供应商可配置默认模型、对外通告的模型列表、fallback 模型、message 模型和别名。
- 支持从上游 /v1/models 同步模型列表。

Codex 接入

- 一键写入用户级 ~/.codex/config.toml：provider id 使用 Codex Desktop 兼容的 custom，显示名为 ocgt。
- 根级 model_provider = "custom" 与 model = "..." 决定 Codex 的默认请求走向。
- 生成 ~/.codex/ocgt-model-catalog.json，写入当前 Codex 供应商的模型目录（默认模型、模型列表、fallback / message 模型、别名，以及可获取到的上游 /v1/models）。
- 改配置后重启 Codex CLI / App 生效。Codex App 的选择器可能仍只显示…