# AI-Switch

**Repository Path**: hujunwei-dev/aibox

## Basic Information

- **Project Name**: AI-Switch
- **Description**: No description available
- **Primary Language**: Rust
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-27
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI-Switch

> 让每一个 AI 工具，都能用上任何模型。

AI-Switch 是一款桌面应用，解决了一个所有 AI 工具用户都会遇到的痛点：**不同工具绑定不同服务商，模型和 API Key 管理混乱**。它通过本地代理技术，让你的 Claude Code、Codex、OpenCode 等工具真正实现"一个入口，任意模型"。

## 为什么需要 AI-Switch

如果你同时使用多个 AI 编程工具，你一定经历过这些场景：

- Claude Code 只认 Anthropic 的 API，你想用国产模型？不行
- Codex CLI 要求 OpenAI 格式，你用的是智谱/DeepSeek？要自己折腾配置
- 每换一个工具，就得重新设置 API Key、Base URL、模型名
- 多个项目要用不同模型，配置改来改去容易出错
- Ollama 跑本地模型，工具怎么接入？又是一堆配置

**AI-Switch 解决了所有这些问题**。

## 核心能力

### 万物皆可代理 — 任意模型驱动任意工具

AI-Switch 内置两个本地代理服务器：

| 代理 | 输入格式 | 输出格式 | 支持的工具 |
|------|---------|---------|-----------|
| Claude 代理 | Anthropic Messages API | OpenAI Chat Completions | Claude Code |
| Responses 代理 | OpenAI Responses API | OpenAI Chat Completions | Codex CLI |

这意味着：
- **Claude Code 可以用智谱 GLM、DeepSeek、Ollama、任何兼容 OpenAI 格式的模型**
- **Codex CLI 可以连接不支持 Responses API 的服务商**（代理自动做格式转换）
- 切换模型只需在界面上点一下，代理实时生效，无需重启

### 一站式模型管理

在模型中心统一管理所有 API 配置：
- 添加服务商（OpenAI、Anthropic、Ollama、本地模型、自定义）
- 一键测试连通性，自动检测可用模型列表
- 启用/禁用配置，延迟和状态一目了然
- API Key 安全存储在本地，不出网络

### 项目级模型配置

不同项目可以用不同模型：
- 项目关联应用后，可单独指定模型，不影响全局默认
- 启动项目时自动注入正确的 API 配置和环境变量
- 例如：项目 A 用 Claude Code + DeepSeek，项目 B 用 Codex + 智谱 GLM

### 应用中心

内置支持主流 AI 工具，一键安装和启动：
- **Claude Code** — Anthropic AI 编程终端
- **Codex** — OpenAI AI 编程 CLI
- **OpenCode** — 开源 AI 编程助手
- **Cursor** — AI 代码编辑器
- **Hermes**、**OpenClaw** 等

每个应用可独立关联模型配置，启动时自动完成所有环境设置。

### 维修中心

内置 AI 对话界面，直接在应用内与模型交互：
- 选择任意已启用的模型配置
- 支持流式输出和思考过程展示
- 保存对话历史
- 也可以作为安装工具的辅助——点击"安装"按钮时，提示词自动带入聊天框

### 多主题 & 中英双语

- **3 种主题风格**：简洁风格、Claude 风格、IDEA 深色风格
- 中英文自由切换
- 终端偏好设置（CMD / PowerShell）

## 技术架构

AI-Switch 基于 **Tauri 2 + React + Rust** 构建：

- **前端**：React 18 + TypeScript + Zustand + Tailwind CSS，轻量高效
- **后端**：Rust 编写的 Tauri 插件，Axum HTTP 代理服务器，零延迟本地转发
- **代理**：纯 Rust 实现的 API 格式转换，请求实时翻译转发，支持流式响应
- **数据**：全部本地 JSON 存储，不上传任何数据到云端

代理服务器完全在本地运行（localhost），你的 API Key 和对话内容只在你的机器和上游服务商之间传输，AI-Switch 本身不收集任何数据。

## 快速开始

### 前置要求

- Node.js 18+
- Rust 工具链（rustup）
- Tauri 2 CLI

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

### 构建安装包

```bash
npm run build
```

输出 MSI 安装包（Windows）或 DMG（macOS）。

### 独立代理模式（无 GUI）

适合服务器或 CI 环境：

```bash
# 静态模式：指定上游
ai-switch --claude-proxy --upstream-url <url> --api-key <key> --model <model>

# 动态模式：从模型配置文件实时读取
ai-switch --claude-proxy --config-dir <path> [--port <port>]
```

## 使用流程

1. **添加模型** — 在模型中心填入服务商的 API 地址和 Key，点击"测试连通"确认可用
2. **关联应用** — 在应用中心为每个工具选择要使用的模型配置
3. **一键启动** — 点击"启动"，AI-Switch 自动配置代理和环境变量，工具直接可用
4. **切换模型** — 随时更换关联的模型，下次启动自动生效

## 支持的服务商

AI-Switch 支持所有兼容 OpenAI Chat Completions 格式的服务商，包括但不限于：

- OpenAI / Azure OpenAI
- Anthropic
- 智谱 AI (GLM)
- DeepSeek
- 月之暗面 (Moonshot / Kimi)
- 阿里云通义千问
- Ollama（本地模型）
- 任何 OpenAI 兼容的私有部署

## 许可证

Apache License 2.0