CSSwitch
starsforks
How to install CSSwitch?
superjj007/csswitch
$git clone https://github.com/SuperJJ007/CSSwitch---
README.md
| 1 | <p align="center"> |
| 2 | <img src="desktop/src-tauri/icons/icon.png" alt="CSSwitch" width="112"> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <strong>README</strong><br> |
| 7 | <a href="./README.md">🇨🇳 中文</a> · |
| 8 | <a href="./README.en.md">🇺🇸 English</a> |
| 9 | </p> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <a href="https://github.com/SuperJJ007/CSSwitch"><img src="https://img.shields.io/badge/GitHub-CSSwitch-181717?style=flat-square&logo=github" alt="GitHub Repository"></a> |
| 13 | <a href="./LICENSE"><img src="https://img.shields.io/github/license/SuperJJ007/CSSwitch?style=flat-square&logo=opensourceinitiative" alt="MIT License"></a> |
| 14 | <a href="https://github.com/SuperJJ007/CSSwitch/releases/latest"><img src="https://img.shields.io/github/v/release/SuperJJ007/CSSwitch?display_name=tag&style=flat-square" alt="Latest Release"></a> |
| 15 | <img src="https://img.shields.io/badge/macOS-Apple%20Silicon-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS Apple Silicon"> |
| 16 | <img src="https://img.shields.io/badge/Tauri-2-24C8DB?style=flat-square&logo=tauri&logoColor=white" alt="Tauri 2"> |
| 17 | </p> |
| 18 | |
| 19 | <p align="center"> |
| 20 | <strong>更自由、流畅的研究体验。</strong> |
| 21 | </p> |
| 22 | |
| 23 | <p align="center"> |
| 24 | CSSwitch 让 Claude Science 接入你自己的模型 API。<br> |
| 25 | 在主流 Provider、Codex 与自定义兼容端点之间自由切换。 |
| 26 | </p> |
| 27 | |
| 28 | > Linux x64 用户可以使用 [CSSwitch v0.8.1 Linux x64 预发布版](https://github.com/SuperJJ007/CSSwitch/releases/tag/v0.8.1-linux-x64)，提供 amd64 `.deb` 安装包。 |
| 29 | |
| 30 | <p align="center"> |
| 31 | <img src="docs/assets/csswitch-v0.8-ui-demo.gif" alt="CSSwitch v0.8 系列界面演示" width="942"> |
| 32 | </p> |
| 33 | |
| 34 | --- |
| 35 | |
| 36 | <p align="center"> |
| 37 | <a href="https://github.com/SuperJJ007/CSSwitch/releases/download/v0.8.1/CSSwitch_0.8.1_aarch64.dmg">下载 v0.8.1</a> · |
| 38 | <a href="#功能介绍">功能介绍</a> · |
| 39 | <a href="#安装与启动">安装与启动</a> · |
| 40 | <a href="#provider-与模型">Provider 与模型</a> · |
| 41 | <a href="#使用-codex">Codex</a> · |
| 42 | <a href="#skill">Skill</a> · |
| 43 | <a href="#mcp">MCP</a> |
| 44 | </p> |
| 45 | |
| 46 | ## 功能介绍 |
| 47 | |
| 48 | | 功能 | 当前状态 | 说明 | |
| 49 | | --- | --- | --- | |
| 50 | | Provider 与模型 | 已支持 | 连接内置 Provider、中转站和自定义兼容端点，自由填写并严格映射 Science 使用的模型。 | |
| 51 | | Codex | 实验功能 | 使用 CSSwitch 独立浏览器登录和账号动态模型目录；默认关闭，不读取或修改原生 `~/.codex` 登录。 | |
| 52 | | Skill | 已支持 | 查看当前 Science 组织中的 Skill，从本地包导入，或让 Agent 从准确的公开 GitHub URL 安装。 | |
| 53 | | MCP | 即将支持 | v0.8.1 尚未提供面向用户的通用 MCP 添加、配置和运行管理；后续版本会继续完善。 | |
| 54 | |
| 55 | ## 社区 |
| 56 | |
| 57 | <p align="center"> |
| 58 | <img src="docs/assets/wechat-group.jpg" alt="CSSwitch 社区微信群二维码" width="420"> |
| 59 | </p> |
| 60 | |
| 61 | ## 安装与启动 |
| 62 | |
| 63 | 需要一台 Apple Silicon Mac、已安装的 [Claude Science](https://claude.com/download)，以及可用的第三方模型 API Key 或 Codex 账号。 |
| 64 | |
| 65 | ### 第一次安装 |
| 66 | |
| 67 | 1. 下载 [`CSSwitch_0.8.1_aarch64.dmg`](https://github.com/SuperJJ007/CSSwitch/releases/download/v0.8.1/CSSwitch_0.8.1_aarch64.dmg)，打开后将 CSSwitch 拖入「应用程序」。 |
| 68 | 2. 确认电脑上已经安装 [Claude Science](https://claude.com/download)，然后打开 CSSwitch。 |
| 69 | 3. 首次打开如被 macOS 阻止，请在 Finder 中右键 CSSwitch，选择「打开」。 |
| 70 | |
| 71 | ### 连接第三方模型 |
| 72 | |
| 73 | 1. 进入「模型连接」，点击「新增配置」。 |
| 74 | 2. 选择一个内置 Provider；使用中转站或自建服务时，选择对应的兼容端点并填写 `base_url`。 |
| 75 | 3. 填写 API Key 和模型名称。默认模型必须填写；高质量、快速和 Fable 模型可以留空，也可以直接填写上游提供的精确模型 ID。 |
| 76 | 4. 保存配置并点击「设为当前」。 |
| 77 | 5. 回到首页，保持「第三方模型」模式，点击「一键开始」。 |
| 78 | 6. Science 打开后，在顶部模型选择器中选择需要的模型。CSSwitch 显示的是你配置的真实模型名。 |
| 79 | |
| 80 | 需要回到原来的 Claude 账号和官方模型时，在首页切换到「官方 Claude」并打开 Science；CSSwitch 会先停止自己管理的第三方链路。 |
| 81 | |
| 82 | ### 使用 Codex |
| 83 | |
| 84 | 1. 进入「设置」，打开「启用 Codex 实验入口」。 |
| 85 | 2. 点击「浏览器登录 Codex」，在系统浏览器完成 CSSwitch 自己的独立授权。 |
| 86 | 3. 登录成功后，Codex 配置会自动出现在「模型连接」中，但不会自动替换当前 Provider。 |
| 87 | 4. 将 Codex 配置「设为当前」，回到首页点击「一键开始」。 |
| 88 | 5. 在 Science 的模型选择器中选择 `Codex / …` 模型。模型列表来自当前账号的动态目录，CSSwitch 不会补造账号中不存在的模型。 |
| 89 | |
| 90 | ### 安装与查看 Skill |
| 91 | |
| 92 | 1. 先通过「一键开始」启动隔离 Science，等待运行状态正常。 |
| 93 | 2. 打开「Skill & MCP」，点击「刷新」查看当前 Science 组织中发现的 Skill、来源和绑定状态。 |
| 94 | 3. 本地包可以点击「导入本地 Skill 包」，选择 `.zip` 或 `.skill`；公开 GitHub Skill 则在 Science 中把准确 URL 交给 Agent，由 CSSwitch connector 完成安装。 |
| 95 | 4. 页面显示“已绑定”后，仍建议在当前 Agent 会话调用对应的 `skill()`，确认它已经实际加载。 |
| 96 | |
| 97 | ## Provider 与模型 |
| 98 | |
| 99 | - **内置 Provider：** DeepSeek、通义千问、智谱 GLM、小米 MiMo、硅基流动、Kimi、MiniMax、OpenRouter。 |
| 100 | - **自定义端点：** Anthropic Messages、OpenAI Chat Completions 和 OpenAI Responses 兼容 API；模型名称可以直接填写，不依赖自动发现。 |
| 101 | - **模型选择：** 普通配置可只填一个模型，也可以分别设置质量、均衡、快速和 Fable。Science 显示真实模型名，不使用 `default` 占位名称。 |
| 102 | - **Codex：** 使用 CSSwitch 独立浏览器登录和动态账号模型目录；不读取或修改原生 `~/.codex` 登录。 |
| 103 | |
| 104 | 不同 Provider 对工具调用、thinking、图片、长上下文和流式输出的支持并不相同。CSSwitch 会严格 |
People who liked this also viewed
6 picksType
- open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)MCP ServersJul 2026
- google_workspace_mcpControl Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace / G Suite MCP Server & CLI ToolMCP ServersJul 2026
- pagerduty-mcp-serverPagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.MCP ServersJul 2026
- ms-365-mcp-serverA Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph APIMCP ServersJul 2026
- GmailManage Gmail end-to-end: send, draft, reply, forward, and bulk-modify or delete messages and threads. Organize your inbox with labels, archiving, and trashing, and retrieve messages, attachments, and profile details on demand. Access and seMCP Serversrecently
- linkedin-mcp-serverOpen-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.MCP ServersJul 2026
