Claude Science 是 Anthropic 推出的 AI Agent 科研平台，可以协助完成文献检索与分析、数据处理、图表生成和论文写作等工作。

CSSwitch 让你不必订阅 Claude，也能在 Science 中使用自己的第三方模型。填入 API Key，选择服务商，剩下的交给 CSSwitch。简单来说，它之于 Claude Science，就像 CC Switch 之于 Claude Code。

Science 需要登录才能正常启动，但启动之后，推理请求发往哪里由环境变量 ANTHROPIC_BASE_URL 决定。

CSSwitch 会把这个地址指向本地代理。代理收到请求后，会移除 Science 附带的 OAuth 信息，换成你的第三方 API Key；如果服务商使用不同的接口格式，代理还会负责协议转换，最后把请求发给你选择的模型。

Science 启动所需的登录状态则由 CSSwitch 在隔离环境中生成。这套本地登录只负责让 Science 启动，不参与后续推理，也不会接触你真实的 Claude 登录信息。

Claude Science（隔离环境 · 本地登录）
   │  ANTHROPIC_BASE_URL=http://127.0.0.1:<port>/<secret>
   ▼
csswitch_proxy.py（移除原有凭证、注入第三方 Key、按需转换协议）
   ▼
DeepSeek 原生 Anthropic 端点  /  通义千问等 OpenAI 兼容端点

CSSwitch 的名字和产品形态参考了 CC Switch，后者是一款使用 Tauri 和 Rust 开发的 Claude Code API 服务商切换工具。CSSwitch 的部分交互设计也借鉴了 CC Switch，在此表示感谢。两个项目彼此独立，不存在从属或背书关系。

• 装好就能用：新建一条第三方配置、填入 API Key、设为当前，点击「一键开始」，CSSwitch 会自动启动代理和隔离环境，并打开已经完成本地登录的 Science。虚拟登录由 Rust 原生实现，不需要另外安装 Node.js。
• 重复点击也不会打乱状态：「一键开始」会先检查当前运行状态。窗口关了就重新打开，代理停了就重启代理，隔离环境没启动就补上。它不会反复生成登录身份，也不会把正在使用的会话切换到其他组织。发现连接异常时，还会先检查并尝试自动恢复。
• 随时切回官方 Claude：如果你有 Claude 订阅，可以在面板顶部切换到「官方 Claude」。切换后，CSSwitch 不会再启动代理或隔离环境，也不会干预你的官方登录。
• 保留模型原生能力：DeepSeek 通过原生 Anthropic 端点接入，不需要额外转换协议，可以更完整地保留 Thinking 和工具调用等能力。
• 自己挑模型，显示也不含糊：每个服务商都能在下拉里选择我们维护的主流模型，也可以直接填写任意模型名。填好后，Science 顶部的模型选择器会显示你选择的真实模型名（例如 glm-5.2），而不是笼统的 claude。
• 启用前会校验 Key：把一条配置「设为当前」或修改正在生效的连接时，CSSwitch 会先发一条最小请求验证 Key，通不过就自动回退、不会谎报已生效。（新建配置只保存、不联网，验证留到启用那一步。）
• 方便检查更新：可以从面板直接打开 GitHub Releases，查看和下载新版本。

• 不读取真实登录凭证：Science 启动所需的登录状态由 CSSwitch 在本地生成。你的 ~/.claude-science 不会被复制、修改或删除。
• 不干扰真实 Science：隔离环境拥有独立的 HOME、端口和数据目录，不会占用真实 Science 使用的 8765 端口。程序也为真实数据目录和端口设置了保护措施，一旦发现可能发生冲突，就会停止操作。
• API Key 只保存在本机：密钥以 0600 权限保存在 ~/.csswitch，并通过环境变量传给子进程，不会写入命令行参数或日志。界面只显示经过遮盖的末四位。
• 代理只接受本机请求：代理仅监听回环地址，并通过路径 Secret 验证请求。传入请求中的 Authorization 和 x-api-key 会先被移除，不会被原样转发给第三方服务商。

在面板里「＋ 新建」一条配置并选择来源即可，同一家也能保存多套（不同 Key / 不同模型）：

每个服务商都可以在下拉里选择我们维护的主流模型，也可以直接填写任意模型名；填好后，Science 顶部的模型选择器会显示你选择的真实模型名（例如 glm-5.2），而不是笼统的 claude。本地 Ollama 等更多来源仍在计划中，见下方「更新计划」。

开始之前，请先安装 Claude Science，并确认系统中有 python3。虚拟登录已经由 Rust 原生实现，不需要安装 Node.js。

1. 从最新的 Release 下载 CSSwitch_*.dmg，然后把 CSSwitch 拖入「应用程序」。由于当前版本尚未经过 Apple 公证，第一次启动时请右键应用并选择「打开」。
2. 打开 CSSwitch，保持顶部选择「第三方模型」，点「＋ 新建」，选择来源、粘贴自己的第三方 API Key，点「创建」。密钥只保存在本机 ~/.csswitch 目录下（config.json 及其滚动 / 迁移备份，均为 0600 权限），不会离开你的电脑。
3. 在列表里点这条配置的「设为当前」。CSSwitch 会先校验 Key 再启用，通不过会提示、不会切换。
4. 点击「一键开始」。CSSwitch 会依次启动代理、写入本地登录状态、启动隔离环境，并在浏览器中打开 Science。

你只需要准备自己的第三方 API Key，其余步骤由 CSSwitch 自动完成。

如果应用被 Gatekeeper 拦截，可以右键选择「打开」，或者前往「系统设置 → 隐私与安全性」并点击「仍要打开」。当前版本仅支持 Apple Silicon（arm64）。

命令行用法、构建和测试步骤见 docs/DEVELOPMENT.md 与 desktop/README.md。各版本的具体变化见 CHANGELOG.md。

以下内容是后续计划，不代表已经上线，也不构成时间承诺。欢迎通过 Issue 或 PR 参与完善。

更广泛的模型与 API 支持

• 支持更多第三方服务商与本地模型，例如本地 Ollama 等。
• 让原生直连（DeepSeek/Qwen）也能走自定义 base_url 与模型，并支持自定义鉴权请求头。
• 在界面中编辑各服务商的模型映射和展示名称。

多学科的 Skill / MCP 支持

• 面向社会学、政治学和计算机科学等学科，整理开箱即用的 Skill 与 MCP 服务器清单。
• 提供可以一键配置的学科工具包，覆盖统计分析、文献获取、数据可视化和问卷量表处理等工作。
• 结合 Science 的工具调用和代码执行能力，为不同学科提供研究工作流模板。

体验与工程

• 为 DeepSeek 增加工具调用兜底。少数情况下，DeepSeek 会把工具调用作为普通文本返回，导致 Science 无法继续执行；相关方案正在验证，目前默认关闭。
• 为 Qwen 实现真正的流式协议转换，缩短首个 Token 的等待时间。DeepSeek 当前已经采用原生流式透传。
• 继续减少运行时依赖：计划使用 Rust（axum）重写代理并移除 Python。虚拟登录对 Node.js 的依赖已在 v0.1.4 中移除。
• 提供 Intel（x86_64）和 Universal 构建，并评估正式签名与 Apple 公证。
• 在面板中加入日志查看、用量统计和更快捷的服务商切换入口。

遇到问题或有新的想法，欢迎在 GitHub 提交反馈，方便持续跟踪和集中讨论：

• 报告问题：新建 Bug 反馈，也可以点击面板右下角的「反馈 / 报 bug」。
• 提出功能建议：新建功能建议，告诉我们你希望支持的模型或 API。
• 附上日志：面板中的「日志」链接会打开 ~/.csswitch/logs/，其中包含 proxy.log 和 sandbox.log。日志可以帮助定位问题，但提交前请务必删除其中的 API Key 和令牌。

CSSwitch 不包含自动遥测或崩溃上报，也不会在后台上传你的数据。只有你主动提交的反馈，才会离开本机。

• 本项目仅供个人学习与研究使用，使用风险由用户自行承担。
• 推理请求会通过本地代理发送到你自行付费的第三方模型，不使用 Anthropic 的推理服务。用于启动 Science 的登录状态在本地生成，不包含真实的 Anthropic 凭证。
• Science 启动时仍会尝试访问内置的 Profile 和 Account 接口（api.anthropic.com、claude.ai）。代理会直接终止这些请求并返回「未登录」，因此这里不使用「完全不接触 Anthropic」之类的绝对表述。
• 使用本地登录时，Anthropic 托管的远程 MCP 服务无法使用，包括 pubmed、clinical-trials、chembl 和 biorxiv 等位于 *.mcp.claude.com 的服务。这些服务需要真实的 Anthropic 授权，Science 会在加载失败后自动跳过；日志中出现 load failed (skipped) 属于正常现象。本地内置的 bio-tools MCP 不受影响。
• 对 Science 登录令牌加密格式的分析，以及在本地生成登录状态的实现，可能涉及相关服务条款和版权法规，例如美国《数字千年版权法》DMCA §1201。具体规定是否适用、是否存在豁免，应由专业人士判断。
• 本项目与 Anthropic 不存在从属、合作或背书关系。推理费用由用户向所选的第三方服务商支付。
• 软件按「现状」提供，不作任何形式的担保。

MIT。