跳转到正文
ThinkWatch
开始输入以搜索文档。
Lite 2026.10.7 已发布→

Claude Code、Codex 等 AI 客户端的本地网关

客户端只需接入一次,此后更换上游或模型无需改动客户端配置。每个请求的费用与去向都有记录;发出前可替换其中的 API 密钥,中转站在回答中塞入的危险工具调用也可以在客户端执行前拦下。支持 macOS、Windows 与 Linux,MIT 开源。

其他平台与安装方式
ThinkWatch Lite · 实时流量
已发布
支持平台
macOS 12 及以上(Apple silicon)
Windows 10 21H2 及以上(x64、ARM64)
Linux(x86_64、aarch64)
界面语言
英文、简体中文
更新
应用自动更新;通过 Homebrew 安装的随 Homebrew 更新
许可证
MIT,免费开源

一键接入,或按说明配置

  • Claude Code
  • Codex
  • Claude Desktop
  • opencode
  • Pi
  • oh-my-pi
  • Grok Build
  • Qwen Code
  • Hermes Agent
  • Cursor
  • Zed
  • Aider
  • DeepSeek Harness
  • Continue
  • Antigravity CLI

一个请求,经过网关的四站。

01路由

按规则分流,失败自动换

按模型、工具、图片、扩展思考等条件把请求分给不同上游。回答开始前上游出错时自动换用下一个,同一会话固定使用同一上游,提示缓存保持有效。标题生成、预热等辅助请求可在本地应答,不占用额度。

路由页:从密钥经路由与策略组到上游的链路图,下方逐条列出每条路由的规则

02防护

防范中转站:替换密钥,切断恶意工具调用

API 密钥、私钥、连接串口令、身份证号与银行卡号可在请求发出前换成占位符,中转站拿不到原值;回答中的工具调用若是下载即执行或外发凭据,可在客户端执行之前切断。夹带指令的隐藏字符可以删除,提示注入可以拒绝;三项防护出厂只记录、不改动请求,可逐项切换到「替换」「切断」或「处置」。

安全页日志:请求发出前替换的凭据(其中一条由自定义规则命中)、被切断的下载即执行工具调用,以及记录在案的隐藏字符、删除命令与注入指令,每条都注明所属请求的密钥、客户端、模型与上游

03追溯

每个请求都可追溯

请求详情给出命中的规则、尝试过的每个上游、API 格式转换,以及费用的计算依据。已结束的请求可以重放到另一个上游,并排对比两次回答;全部请求记录都可以搜索,包括请求与回答的内容。

流量页:逐条列出请求的密钥、模型、上游、首 token 时间、总耗时、token 与费用,标出格式转换、密钥脱敏与被拦截的请求,其中一条由网关在本地应答

04费用

费用如实计算

按模型与上游统计 token、费用、缓存节省、首 token 时间与生成速度。估算的金额单独标注,无法计价的请求单独计数,不按零计入;价格每日按 LiteLLM 公开价更新,也可以使用自定义价目表。

概览页(最近 7 天):token 83.1M、费用 $68.11(含估算 $0.441,13 条无法计价)、请求 1,339 次(失败 11 次),均与上一个 7 天对比;按模型分层的 token 趋势,并标出存在失败的时段;以及按 token 排序的模型列表

还有这些,都在一个应用里。

菜单栏、托盘与系统通知

macOS 菜单栏显示今日 token 与费用,订阅额度将尽时变为橙色,用完后变为红色。点开的菜单给出网关状态、各项额度及重置时间与进行中的请求,不打开主窗口即可复制网关地址或默认密钥。Windows 与 Linux 的托盘提供相同的菜单。

12

款一键接入 · 另有 3 款按说明配置

一次接入,随时切换

一键接入 Claude Code、Codex、opencode 等十二款客户端,写入前预览改动、备份原文件,随时可以还原;Windows 上 WSL 中的 Claude Code 与 Codex 同样支持。此后切换上游只在网关中完成,客户端无需改配置或重启。

多种上游,接口互转

API 密钥、Amazon Bedrock、ChatGPT 与 Z.ai 账号、OpenRouter 等中转服务以及本机 Ollama 均可作为上游,订阅额度与重置时间一并显示。Anthropic、OpenAI、Gemini 接口之间自动转换,Codex 也能使用只支持 Chat Completions 的模型。

MCP 页:Claude Code、Claude Desktop、Cursor、Codex、opencode、Antigravity CLI 与 Zed 中配置的 MCP 服务器并列显示,标出第三方远程服务器与两个客户端间配置不一致的服务器;共扫描 11 个文件,发现高、中、低风险各一项

扫描 MCP、技能与钩子

十三款客户端的 MCP 服务器集中显示,标出第三方远程服务器与各客户端之间不一致的配置,可以在客户端之间复制或移除。客户端配置、技能、钩子与项目指令中的隐藏字符、提示注入、危险命令与过宽权限会被找出,出现新发现时发送通知。

每个客户端一把密钥

接入客户端时为它生成专用密钥,流量与费用按客户端分开统计。每把密钥可单独设置路由、可见模型、并发上限,以及按请求次数、token 或费用计的用量上限,更换后的新密钥自动写入客户端配置。

路由试算:cursor 密钥以 OpenAI Chat Completions 格式请求 claude-sonnet-5;gemini 规则未命中并说明原因,catch-all 规则命中,请求交给费用最低优先的策略组,依次尝试 relay 与 anthropic,并转换为 Anthropic Messages

改规则前先试算

试算给出请求会命中哪条规则、前面的规则为何未命中,以及将依次尝试哪些上游。不发出请求,也不产生费用。

系统通知

网关停止转发、远程连接断开、额度用完、凭据失效、代理无法连接、配置未能生效、危险工具调用被切断,以及客户端配置中出现可疑内容时,应用发送系统通知。

插件改写请求与回答

简短的 JavaScript 插件让请求与回答适应具体的使用场景;应用自带两个插件,分别用于指定回答语言、在 WSL 与 Windows 之间转换路径。插件在没有网络与文件访问的沙箱中运行,只能读取和改动权限中声明的部分,看到的是占位符而不是密钥;每一处改动都记录在请求上,并与客户端发来的内容一样经过各项防护的检查。

连接远程 core

服务器上的 ThinkWatch Core

网关也可以作为 systemd 服务部署在 Linux 服务器上,为网络中的客户端提供服务。应用连接后,在同样的页面中查看与管理服务器的流量、费用和配置,本机的客户端也可以一步改为指向服务器的网关。

控制连接经 Noise 握手加密与认证,不涉及证书。应用同一时间只连接一个 core,连接服务器期间本机数据原样保留。

添加远程连接:名称 homelab、地址 192.168.1.40、控制端口与密钥,测试连接成功,显示 core 版本与网关地址 192.168.1.40:8788
连接到 homelab 时侧栏底部的连接菜单:本机(本地 core 已停止)、已选中的 homelab、build-server,以及添加和管理连接的入口
在侧栏底部切换连接。
连接到 homelab 时的客户端页,顶部说明此处修改的是这台 Mac 上的客户端配置,使其指向 homelab 的网关 192.168.1.40:8788,服务器上的客户端不受影响
客户端页修改的是这台电脑上的客户端。

架构

应用负责界面,网关是 ThinkWatch Core

Lite 不含路由、转发与计费逻辑,这些都在 ThinkWatch Core 中;core 随应用在本机运行,也可以部署在 Linux 服务器上。

桌面应用

ThinkWatch Lite

  • 主窗口、菜单栏与托盘
  • 启动并守护本机的 core
  • 或连接服务器上的 core

网关

ThinkWatch Core

  • 路由、故障转移与格式转换
  • 费用核算与请求记录
  • 三项安全防护

上游

模型服务

  • Anthropic、OpenAI、Gemini API
  • Amazon Bedrock 与登录的账号
  • 中转服务与本机模型

控制通道在 macOS 与 Linux 上是 unix socket,在 Windows 上是本机回环端口,连接服务器时是 TCP 端口;每条连接都经 Noise 握手加密与认证。

安装

下载 ThinkWatch Lite

网关随应用一同安装,无需另装其他组件。

需要 macOS 12 及以上,Apple silicon 芯片。

Homebrew

推荐

由 Homebrew 负责安装与升级。

$ brew install --cask thinkwatchproject/tap/thinkwatch-lite

磁盘映像

下载后打开,把应用拖入「应用程序」即可,之后应用自动更新。

下载磁盘映像

版本 2026.10.7 · 21.0 MB · sha256 校验值

应用未经 Apple 公证。用磁盘映像安装时,若首次打开被拦下,在「系统设置 › 隐私与安全性」中点「仍要打开」;通过 Homebrew 安装无需这一步。

需要 Windows 10 21H2 及以上,x64 或 ARM64。

安装程序

为所有用户安装,之后应用自动更新。

版本 2026.10.7 · x64 16.8 MB · ARM64 14.4 MB · sha256 校验值 (x64) · sha256 校验值 (ARM64)

绿色版(ZIP,免安装):x64 · ARM64

安装程序与绿色版均未经代码签名。SmartScreen 显示「Windows 已保护你的电脑」时,依次点「更多信息」「仍要运行」。安装需要管理员权限;缺少 WebView2 时安装程序会自动下载,绿色版则给出下载页面。

需要 Ubuntu 22.04、Debian 12、Fedora 36 或更新的发行版,x86_64 或 aarch64。

一键安装

推荐

按本机架构下载 AppImage,核对 sha256 后放入 ~/Applications 并启动。

$ curl -fsSL https://github.com/ThinkWatchProject/ThinkWatch-Lite/releases/latest/download/install.sh | sh

AppImage

下载后允许执行(chmod +x)再打开。

版本 2026.10.7 · x86_64 101 MB · aarch64 97.1 MB · sha256 校验值 (x86_64) · sha256 校验值 (aarch64)

需要 fuse3 软件包中的 fusermount3,多数桌面系统已自带。手动下载的 AppImage 应放在当前用户可写的目录(如 ~/Applications),以便自动更新;GNOME 上显示托盘图标需要 AppIndicator 扩展。

MIT 许可证

允许使用、修改和再分发。

在 GitHub 上查看