CC VisionRouter

cc-VisionRouter

中文 | English
让不支持图片的主力模型，也能在 Claude Code 里安全跑长程任务——含图片的请求自动分流到多模态模型，session 不再因为一张图就崩。

这个噩梦你大概率见过

在 Claude Code 里接第三方 API（mimo、各类国产 / 自建模型）跑活，尤其跑长程任务——跑着跑着，蹦出这一行：

任务戛然而止。

根因常常不是"模型不存在"，而是 你的主力模型不支持多模态。可一旦上下文里混进任何图片——你贴的截图、工具返回的图、甚至 /compact 压缩历史时扫到早先的那张图——请求就带着图片打到一个看不懂图的模型上，直接挂。

短对话重开一把就算了。但对长程任务这是灭顶之灾：几十轮、几十万 token 攒起来的上下文，因为一张图全断，没法自动续。这是所有想用三方模型跑 autonomous / 长任务的人共同的噩梦。

我们的思路：按内容分流，你无感

cc-VisionRouter 是夹在 Claude Code 和上游之间的透明代理。它不替你换模型、不打断你的工作流，只做一件事——看每个请求里有没有图片，再决定送给谁：

- 日常编码继续用你最强 / 最省的主力模型，零改变；
- 图片来了自动分流到多模态模型，主力模型永远不会"看到"它看不懂的东西，session 不会因为一张图崩；
- 长任务里 /compact 压缩含图历史也走多模态，不会在自动压缩那一刻爆掉；
- 全程不用手动 /model 切换，模型名翻译、[1m] 后缀、settings 改写还原，代理全包了。

一句话：让你能安心用三方模型跑长任务，图片不再是中断点。

安装
需要 Node.js ≥ 18（用到原生 fetch / Web Streams）。

全局安装（推荐） — 从 npm 装，装完就有 cc-visionrouter 命令：

或直接从 GitHub 装（始终最新，无需等 npm 发版）：

或克隆到本地（开发 / 贡献）：
下文命令以全局安装的 cc-visionrouter 为例；本地跑就把它换成 node cli.mjs。

使用

配置过程中，选择题可选 ← 返回上一级，也可按 Esc 返回；输入框/API Key 框按 Esc 返回上一项。

配置自检：填完会自动用一个最小请求（max_tokens:1）测一遍 baseUrl / key / model 是否真能通，通了才让保存——避免乱填也能存下一个跑不起来的配置。测不通会报具体错误并问你是否仍要保存。

语言

界面自动跟随系统 locale（中文系统显示中文，其它显示英文）。覆盖方式：

- 环境变量：CC_VR_LANG=en（或 zh）
- 交互菜单里选「语言 / Language」即时切换，并记住选择

更多机制

背景任务也走视觉模型：Claude Code 的后台请求（/compact、对话压缩、总结等，即 haiku 档）是在整段历史上跑的，历史里可能含图片。若塞给不支持图片的主力模型会报错、甚至把会话搞崩。所以代理把背景/haiku 请求也路由到视觉模型（多模态、通常更轻），既安全又省 token。背景请求的识别是自动的（探测 Claude Code 的 haiku / small-fast 模型名），无需配置。

模型名自动改写：Claude Code 发来的 model 字段会被直接替换成你配置里的真实模型 id，再转发给上游。你无需关心 Claude Code 那边配的是什么模型名——代理屏蔽了「Claude Code 模型命名」与「上游真实 model id」之间的不一致。

自动剥离 [1m] 等后缀：很多 ccswitch / 国产 1M 模型的配置里模型名带 [1m]（如 mimo-v2.5-pro[1m]）。Claude Code 会对这类后缀做客户端校验，上游若不认识就直接报 “issue with the selected model”（请求都到不了代理）。start 时 cc-VisionRouter 会自动把 ~/.claude/settings.json 里模型字段的 [...] 标记剥掉（原值已备份，stop 时还原）。

内置预设

Claude Code…