Rust · 项目报告

SuperJJ007/CSSwitch

帮你的 Claude Science 一键接入你自己的 API:DeepSeek / 通义千问 / 智谱 GLM / Kimi / MiniMax / 小米 MiMo / 硅基流动 / OpenRouter / 任意 OpenAI·Anthropic 兼容端点

已完成 打开 GitHub
S
313星标
38Fork
21Issue
MIT许可证

分析结果

项目分析

CSSwitch 是一款面向 macOS Apple Silicon 的 Claude Science 第三方模型接入工具。它通过本地代理和隔离环境,让用户在 Claude Science 中使用自己的 API Key 调用 DeepSeek、通义千问、智谱 GLM、Kimi、MiniMax、小米 MiMo、硅基流动、OpenRouter 或任意 OpenAI/Anthropic 兼容端点,而不直接使用 Anthropic 的推理服务。项目使用 Rust + Tauri 2 开发,提供菜单栏/桌面界面、一键启动、配置管理、Key 校验、本地代理、协议转换和隔离登录环境等能力。

适用领域 AI 工具 / 大模型 API 代理 / Claude Science 增强工具 / 科研 Agent 工作流 / macOS 桌面应用 / LLM Provider 切换 / OpenAI/Anthropic 协议兼容 / 本地代理与 API 转发
配置难度 中等。普通 macOS 用户可以通过 dmg 安装和图形界面完成基本使用,但仍需要理解 API Key、模型服务商、兼容端点和 Gatekeeper 放行等概念。若要调试代理、协议转换或自定义端点,则需要一定的 Rust、Tauri、Python、HTTP API 和大模型协议经验。
商业价值 对个人科研用户和 AI 工具爱好者具有较高实用价值,可以降低 Claude Science 的模型使用门槛,并让用户根据价格、速度、上下文长度和模型能力自由选择第三方服务商。对企业或商业产品而言,该项目的技术思路有参考价值,例如多模型路由、本地代理、凭证隔离和桌面端配置管理;但由于其与 Claude Science 登录和请求机制深度耦合,并存在潜在服务条款和合规风险,不建议未经法律评估直接用于商业化或大规模团队部署。
01

技术亮点

  • 提供图形化界面,适合不想手动设置环境变量和代理脚本的用户。
  • 支持多个主流第三方模型服务商,包括 DeepSeek、通义千问、GLM、Kimi、MiniMax、小米 MiMo、硅基流动和 OpenRouter。
  • 支持任意 OpenAI/Anthropic 兼容端点,扩展性较好。
  • DeepSeek 使用原生 Anthropic 端点接入,尽量保留 Thinking 和工具调用能力。
  • 设为当前配置前会先发送最小请求验证 API Key,失败则不会切换,减少误配置。
  • 一键开始具备状态检查和恢复逻辑,代理停了会重启,窗口关闭会重新打开。
  • 与真实 Claude 账号数据隔离,不读取或修改用户真实 ~/.claude-science 数据。
  • API Key 不写入命令行参数或日志,界面仅显示遮盖后的末四位。
  • 代理只监听回环地址,并移除传入请求中的 Authorization 和 x-api-key,降低凭证泄露风险。
  • MIT 许可证,方便个人学习、二次开发和审计。
02

目标用户

  • 希望在 Claude Science 中使用国内外第三方模型的研究人员
  • 没有 Claude 订阅但有 DeepSeek、Qwen、GLM、Kimi 等 API Key 的用户
  • 需要在科研场景中进行文献分析、数据处理、图表生成、论文写作的学生和科研工作者
  • 想降低 Claude Science 使用成本的个人开发者
  • 需要测试不同大模型在 Claude Science 中表现的 AI 应用开发者
  • 熟悉 macOS、API Key 和大模型服务商配置的技术用户
03

配置要求

  • 需要至少一个第三方模型服务商的 API Key,例如 DeepSeek、Qwen、GLM、Kimi、MiniMax、MiMo、硅基流动或 OpenRouter。
  • 如使用自定义端点,需要提供兼容 OpenAI 或 Anthropic 协议的 base URL、模型名和鉴权信息。
  • API Key 保存在本机 ~/.csswitch 目录下,配置文件及备份使用 0600 权限。
  • CSSwitch 会将 ANTHROPIC_BASE_URL 指向本地代理地址,代理监听 127.0.0.1 并使用路径 Secret 校验请求。
  • 需要允许应用启动本地子进程和浏览器打开 Claude Science。
  • 运行时依赖 python3,因为当前代理实现仍包含 csswitch_proxy.py。
  • 真实 Claude Science 数据目录 ~/.claude-science 不会被复制、修改或删除;CSSwitch 使用独立 HOME、端口和数据目录。
04

适用场景

  • 在 Claude Science 中通过 DeepSeek API 进行科研分析和写作辅助
  • 将通义千问、智谱 GLM、Kimi、MiniMax 等模型接入 Claude Science
  • 在不同第三方模型之间快速切换,比较响应质量、成本和工具调用能力
  • 使用自定义 OpenAI 兼容或 Anthropic 兼容端点接入私有模型服务
  • 在不修改真实 Claude Science 登录数据的情况下,启动隔离环境进行实验
  • 为科研 Agent 工作流探索更低成本或更本地化的大模型替代方案
05

部署与配置

  • 确认设备为 macOS Apple Silicon,目前 README 标注仅支持 arm64。
  • 先安装 Claude Science。
  • 确认系统中可用 python3;虚拟登录由 Rust 原生实现,不需要 Node.js。
  • 从 GitHub Releases 下载最新的 CSSwitch_*.dmg。
  • 打开 dmg 后将 CSSwitch 拖入“应用程序”。
  • 由于当前版本未经过 Apple 公证,首次启动需要右键应用并选择“打开”,或在“系统设置 → 隐私与安全性”中选择“仍要打开”。
  • 打开 CSSwitch,顶部选择“第三方模型”。
  • 点击“+ 新建”,选择服务商,填写自己的第三方 API Key 和模型配置。
  • 创建配置后,在列表中点击“设为当前”,CSSwitch 会先校验 API Key。
  • 点击“一键开始”,程序会启动本地代理、写入隔离登录状态、启动隔离环境并打开 Claude Science。
06

风险与注意事项

  • 项目涉及 Claude Science 登录状态模拟、本地生成登录状态和请求重定向,可能触及 Anthropic 服务条款、版权法规或 DMCA §1201 等合规问题,商用和公开部署需谨慎。
  • 当前版本未经过 Apple 公证,首次启动需要绕过 Gatekeeper,普通用户可能有安全顾虑。
  • 目前仅支持 macOS Apple Silicon,Intel Mac、Windows、Linux 用户无法直接使用官方构建。
  • 部分功能依赖 Claude Science 内部行为和环境变量机制,如果 Anthropic 修改客户端或接口,工具可能失效。
  • Anthropic 托管的远程 MCP 服务无法在本地登录模式下使用,例如 pubmed、clinical-trials、chembl、biorxiv 等。
  • Qwen 等 OpenAI 兼容接口需要协议转换,可能存在流式输出、工具调用、消息格式不完全兼容的问题。
  • DeepSeek 少数情况下可能将工具调用作为普通文本返回,导致 Science 工作流中断,README 中也提到相关兜底仍在验证。
  • 当前代理仍依赖 python3,增加了一定运行环境复杂度。
  • 日志中可能包含敏感信息,用户提交 issue 前需要自行清理 API Key 和令牌。
  • 第三方模型产生的推理费用由用户自行承担,错误配置或长任务可能带来额外成本。

历史记录

热榜历史快照

2026-07-09 第30名 新收录 · github_search
2026-07-08 第30名 新收录 · github_search
2026-07-07 第25名 新收录 · github_search
2026-07-06 第21名 新收录 · github_search
2026-07-05 第25名 新收录 · github_search