ccMesh

轻量级跨平台 AI 代理网关桌面应用。

<a href="https://linux.do/"><img src="https://img.shields.io/badge/Linux.do-Community-2b6de8?style=flat-square" alt="Linux.do"></a>
<img src="https://img.shields.io/github/v/release/VkRainB/ccMesh?label=version&color=blue" alt="version" />
<img src="https://img.shields.io/badge/license-Apache--2.0-green" alt="license" />
<a href="https://github.com/VkRainB/ccMesh/releases"><img alt="Downloads" src="https://img.shields.io/github/downloads/VkRainB/ccMesh/total?style=flat-square&color=6366f1&label=downloads"></a>
<a href="https://github.com/VkRainB/ccMesh/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/VkRainB/ccMesh?style=flat-square&color=yellow&label=stars"></a>






<img src="https://img.shields.io/badge/Windows-0078D6?style=flat-square&logo=windows&logoColor=white" alt="Windows" />
<img src="https://img.shields.io/badge/macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS" />
<img src="https://img.shields.io/badge/Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux" />







<a href="https://github.com/VkRainB/ccMesh">GitHub</a>
·
<a href="https://github.com/VkRainB/ccMesh/releases/latest">下载</a>
·
<a href="https://github.com/VkRainB/ccMesh/raw/v0.2.0/docs/guides/auto-update-and-release.md">更新与发布</a>
·
<a href="https://github.com/VkRainB/ccMesh/raw/v0.2.0/README.en.md">English</a>

ccMesh 是基于 Tauri 2 + Rust + React 19 的桌面端 AI 代理网关：在本机统一接入 Claude / OpenAI / Codex 等多类上游，提供协议转换、模型映射、端点轮换与熔断、请求统计与配置管理等能力。支持 Windows、macOS、Linux。

界面预览

仪表盘：代理状态、Token 概览与实时请求监控	端点管理：多端点、模型映射与连通性测试
配置文件：Claude Code / Codex 渠道化管理	统计：用量汇总与端点维度分析
同步：配置备份、恢复与导出	设置：全局代理、UA 与系统选项
深色主题界面

功能特性

仪表盘

• 本地代理服务启停与端口状态一览
• 今日 Token 用量与请求概览
• 实时请求监控：模型、耗时、首字延迟、Token 明细

端点管理

• 多端点 CRUD、拖拽排序、列表/网格视图
• 支持 claude（直通）、openai（转换）、codex（Responses） 三类转换器
• 模型清单维护、入站/出站模型映射、连通性测试
• 按模型过滤的轮换与熔断，避免无关端点被误伤

配置文件

• 以「渠道」管理 Claude Code settings.json 与 Codex auth.json + config.toml
• 端点写入 / 自定义写入双模式，表单与 JSON 双向联动
• 保存渠道与应用覆写分离，应用前自动备份

统计与同步

• 按应用、端点、模型维度查看历史用量
• 配置与数据备份、恢复、导出

设置

• 全局出站代理、Claude/Codex CLI User-Agent
• 应用内自动更新（GitHub Releases）

安装

最新安装包见 Releases。应用支持通过内置更新器拉取新版本（详见 docs/guides/auto-update-and-release.md）。

Windows

下载 *-setup.exe（NSIS）或 *.msi，双击安装即可。

macOS（当前为未签名版本）

由于暂未配置 Apple 开发者签名与公证，首次打开可能被 Gatekeeper 拦截。推荐：

1. 将 ccMesh.app 拖入「应用程序」
2. 右键 ccMesh →「打开」→ 再次确认「打开」

若提示「已损坏」，可在终端执行：

xattr -dr com.apple.quarantine /Applications/ccMesh.app

Linux

按发行版选择安装包：

• AppImage（推荐）

bash chmod +x ccMesh_*.AppImage ./ccMesh_*.AppImage

• deb（Debian/Ubuntu）

bash sudo apt install ./ccMesh_*_amd64.deb

• rpm（Fedora/RHEL）

bash sudo dnf install ./ccMesh-*.x86_64.rpm

_{Linux 桌面运行预览}

从源码构建

环境要求

• Rust stable — https://rustup.rs
• Node.js LTS、pnpm 10+
• 各平台 Tauri 构建依赖 — https://tauri.app/start/prerequisites/

开发

pnpm install
pnpm tauri dev      # 启动桌面开发环境
pnpm test           # 前端单测

生产构建

pnpm tauri build

各平台额外依赖：

• Windows：MSVC 工具链 + WebView2
• macOS：Xcode Command Line Tools（通用二进制）
• Linux（Ubuntu/Debian 构建机）：

bash sudo apt-get install -y \ libwebkit2gtk-4.1-dev \ libayatana-appindicator3-dev \ librsvg2-dev \ patchelf

本地 pnpm tauri build 若开启 updater 签名产物，需配置 TAURI_SIGNING_PRIVATE_KEY 等环境变量，详见 docs/guides/auto-update-and-release.md。

检查

pnpm check:front
pnpm check:rust

技术栈

Tauri 2、Rust、axum、reqwest（rustls）、SQLite、React 19、TypeScript、Vite、TanStack Query、Tailwind CSS v4、shadcn/ui、CodeMirror 6。

社区支持

学 AI，上 L 站：LinuxDO

许可证

ccMesh 采用 Apache License 2.0 开源协议。

Star History

  <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=VkRainB/ccMesh&type=Date" />