CC Use

专为 Claude Code / Codex CLI 打造的桌面配置管理工具。不同于通用的 API 管理平台，CC Use 只做一件事：让你更高效地管理和使用 CLI。

English

🎉 2.0 重大更新：已从 Electron 完全重写为 Tauri + Rust！核心优势：更可靠的自动更新机制

从 1.x 迁移？ 数据会自动迁移 → 迁移指南

从 0.x (cc-switch) 迁移？ 请参阅 从 cc-switch 迁移

截图

仪表盘	密钥管理

项目管理	统计

设置

功能

• 供应商与密钥管理 - 在「密钥」页面统一管理供应商和 API 密钥，每个密钥可同时支持 Claude Code 和 Codex CLI，支持额度查询（NewAPI / 自定义接口），支持快速复制密钥配置
• 项目管理 - 创建项目并绑定供应商、密钥和 CLI 类型，支持在项目卡片上快速切换绑定
• 一键启动 - 点击项目即启动终端，自动注入环境变量，直接进入 CLI
• 本地代理 - 内置代理服务器，通过 session token 中转请求，开启后可实现费用追踪和热切换
• 费用追踪 - 代理模式下自动记录每次请求的 Token 用量和费用
• 统计分析 - 仪表盘展示今日费用、请求量、每日趋势、Top 密钥/项目；统计页提供按密钥/供应商/项目/模型的详细分析和请求明细
• 系统托盘 - 关闭窗口时最小化到托盘，代理服务持续运行；托盘菜单支持代理控制和最近项目快速启动
• 自动更新 - 应用内检测并下载新版本，支持下载进度显示（tauri-plugin-updater 签名校验）
• CLI 配置管理 - 支持全局配置和密钥级别的 CLI 配置（JSON），启动时自动合并注入
• 国际化 - 中文 / 英文界面
• 深色模式 - 亮色 / 深色主题切换
• 代码规范 - 集成 ESLint + Prettier，统一代码风格

安装

从 Releases 下载对应平台的安装包：

平台	格式
macOS	.dmg
Windows	.exe (NSIS) / .msi

使用方式

1. 添加供应商和密钥

进入「密钥」页面：

1. 点击「添加供应商」，填写名称、Base URL，选择图标，可选配置 Token 和余额查询
2. 在供应商分组下点击「添加密钥」，填写密钥值，选择支持的类型（Claude Code / Codex CLI），可选配置额度查询和 CLI 配置

2. 创建项目

进入「项目」页面，点击「添加项目」：

1. 填写项目名称，通过浏览按钮选择项目文件夹路径
2. 选择绑定的供应商和密钥（级联选择器）
3. 选择 CLI 类型（Claude Code / Codex CLI）

创建后可在项目卡片上快速切换绑定的密钥或 CLI 类型。

3. 启动终端

在「项目」页面或「仪表盘」的最近项目中，点击打开按钮即可启动终端。应用会自动启动代理并注入环境变量：

• Claude Code: 设置 ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY
• Codex CLI: 设置 OPENAI_BASE_URL + OPENAI_API_KEY

4. 代理控制

在「项目」页面或「设置」页面可以开关本地代理。代理开启后：

• 请求经过本地代理中转，使用 session token 替代真实密钥
• 自动记录每次请求的 Token 用量和费用
• 支持不重启终端热切换密钥

关闭代理后将无法记录使用量。

工作原理

CC Use 支持两种工作模式：

直连模式 - 终端直接使用真实密钥连接 API 供应商。

代理模式 - 开启本地代理后，请求经过代理中转：

CLI → localhost:12345 (代理) → 实际 API 供应商

代理使用 session token 替代真实密钥，实现：

• 不暴露真实 API 密钥给终端环境
• 自动记录每次请求的 Token 用量和费用
• 支持不重启终端热切换密钥

从源码构建

# 安装依赖
pnpm install

# 开发模式
pnpm dev

# 构建生产版本
pnpm build

# 构建开发版本（用于测试）
pnpm build:dev

# Rust 测试
cd src-tauri && cargo test

# 类型检查
pnpm typecheck

# 代码检查
pnpm lint

# 代码格式化
pnpm format

技术栈

• 框架: Tauri 2.x + Vite
• 后端: Rust (axum, rusqlite, tokio)
• 前端: React 18 + TypeScript
• UI: Ant Design 6 + Tailwind CSS 4
• 状态管理: Zustand
• 数据库: SQLite (rusqlite)
• 代理: Axum + Hyper
• 国际化: i18next + sys-locale

支持平台

• macOS (Apple Silicon / Intel)
• Windows (x64)

⚠️ 注意：Windows 版本目前尚未经过充分测试，可能存在兼容性问题。如遇到问题，欢迎提交 Issue。

License

MIT