opencc
skill
Basarisiz
Health Uyari
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 38 GitHub stars
Code Basarisiz
- network request — Outbound network request in package.json
- exec() — Shell command execution in src/main/database/hotStore.ts
- fs.rmSync — Destructive file system operation in src/main/database/index.ts
- os.homedir — User home directory access in src/main/database/index.ts
- os.homedir — User home directory access in src/main/export/dataExporter.ts
- spawnSync — Synchronous process spawning in src/main/index.ts
- fs.rmSync — Destructive file system operation in src/main/index.ts
- os.homedir — User home directory access in src/main/index.ts
- process.env — Environment variable access in src/main/index.ts
- network request — Outbound network request in src/main/index.ts
- child_process — Shell command execution capability in src/main/ipc/handlers.ts
- execSync — Synchronous shell command execution in src/main/ipc/handlers.ts
- fs.rmSync — Destructive file system operation in src/main/ipc/handlers.ts
- os.homedir — User home directory access in src/main/ipc/handlers.ts
- process.env — Environment variable access in src/main/ipc/handlers.ts
- network request — Outbound network request in src/main/ipc/handlers.ts
- os.homedir — User home directory access in src/main/logger/index.ts
- os.homedir — User home directory access in src/main/mcp/configManager.ts
- os.homedir — User home directory access in src/main/mcp/mcpService.ts
- Hardcoded secret — Potential hardcoded credential in src/main/mcp/mcpService.ts
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Claude Code / Codex 本地代理与管理桌面端:一个应用同时管好两个 CLI 的代理、模型路由、用量统计与 Skills。支持 Anthropic / OpenAI Chat Completions / Responses 三协议互转。
README.md
OpenCC
📖 项目简介
OpenCC 是一个跨平台桌面应用,把 Claude Code 和 Codex 两个命令行客户端的代理服务、配置与监控收进同一个界面。
不用再手工编辑 ~/.claude/settings.json,也不用为了给 Codex 换一个模型去翻文档——在界面上点几下,两个客户端就能同时跑起来,并且共用一份用量与日志。
支持的客户端
| 客户端 | 接入方式 |
|---|---|
| Claude Code | Anthropic 协议原生接入,支持模型路由与 /model 快速切换 |
| Codex CLI | OpenAI 兼容协议接入,支持 Responses API |
| Claude Desktop | 支持多路由映射与带版本后缀的模型名匹配 |
| 任意上游服务 | 只要提供 Anthropic / Chat Completions / Responses 三种协议之一即可 |
三个协议之间可以互转:Claude Code 发来的 Anthropic 请求能被转发到只支持 OpenAI 协议的模型,反之亦然。
✨ 核心特性
- 🎯 双客户端统一管理 - Claude Code 与 Codex 共用一套代理、一份配置、一个面板
- 🔀 协议互转 - Anthropic / OpenAI Chat Completions / Responses 三者之间自动转换
- 🎛 模型路由 - 按客户端分别指定模型,支持 Claude Desktop 的路由映射与版本化模型名
- 📊 实时监控 - 运行日志、Token 消耗(含缓存命中)、请求耗时与成功率
- 💬 对话历史 - 查看、搜索、导出所有请求记录
- 🔌 MCP 与 Skills - 可视化管理 MCP 服务与 Skill 安装
- 🧪 环境自检 - 启动前检测依赖与上游连通性,给出可执行的修复建议
- 🎨 极简界面 - 浅色/深色主题,跟随系统或手动切换
🚀 快速开始
系统要求
- 操作系统: macOS 10.15 (Catalina) 或更高版本 / Windows 10/11
- Node.js: v16.0.0 或更高版本
- Claude Code: 已安装并配置
安装方式
方式一:下载安装包(推荐)
- 访问 Releases 页面
- 下载最新版本的
OpenCC-x.x.x.dmg(macOS)或OpenCC-x.x.x.exe(Windows) - 双击打开安装文件
- 将应用拖拽到 Applications 文件夹(macOS)或按向导安装(Windows)
- 打开应用,开始使用
方式二:从源码构建
# 1. 克隆仓库
git clone https://github.com/jiashuaiLu/opencc.git
cd opencc
# 2. 安装依赖
npm install
# 3. 开发模式运行
npm run electron:dev
# 4. 构建生产版本
npm run electron:build
📚 使用指南
1. 配置代理
首次使用时,需要进行基础配置:
- 打开应用,进入"配置管理"页面
- 输入配置名称(如:"OpenAI-Production")
- 输入 API Key(例如:
sk-xxxxx) - 选择或输入 Base URL(例如:
https://api.openai.com/v1) - 设置代理端口(默认:8787)
- 点击"保存配置"
2. 启动服务
配置完成后:
- 回到"仪表盘"页面
- 点击"启动服务"按钮
- 等待服务启动完成(状态变为"运行中")
- 现在可以使用 Claude Code 了!
3. 查看日志
在"运行日志"页面可以:
- 查看实时运行日志
- 按级别过滤日志(INFO/WARN/ERROR)
- 搜索特定日志
- 导出日志文件
4. 查看统计
在"仪表盘"页面可以查看:
- 总请求数
- 成功率
- Token 消耗
- 平均响应时间
5. 管理对话历史
在"对话历史"页面可以:
- 查看所有对话记录
- 搜索特定对话
- 查看对话详情
- 删除历史记录
6. 插件管理
- MCP 管理: 配置和管理 Model Context Protocol 服务器
- Skills 管理: 管理和发现 Claude Code 技能插件,支持从 ZIP 安装、扫描本地目录或从仓库安装
🛠️ 开发指南
项目结构
opencc/
├── src/
│ ├── main/ # Electron 主进程
│ │ ├── index.ts # 主进程入口
│ │ ├── preload.ts # Preload 脚本
│ │ ├── proxy/ # 代理服务
│ │ ├── database/ # 数据库
│ │ ├── logger/ # 日志系统
│ │ └── ipc/ # IPC 通信
│ ├── renderer/ # 渲染进程(React)
│ │ ├── index.tsx # 渲染进程入口
│ │ ├── App.tsx # 应用根组件
│ │ ├── pages/ # 页面组件
│ │ ├── components/ # 通用组件
│ │ ├── styles/ # 样式文件 (common.css, global.css 等)
│ │ ├── theme/ # 主题配置
│ │ └── context/ # React Context (ThemeContext 等)
│ └── shared/ # 共享代码
│ └── types.ts # 类型定义
├── resources/ # 资源文件
│ └── icons/ # 应用图标
├── tests/ # 测试文件
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
├── vite.config.ts # Vite 配置
├── DESIGN_SYSTEM.md # 设计规范文档
└── README.md # 项目文档
技术栈
- 前端框架: React 18 + TypeScript
- 桌面框架: Electron
- UI 组件: Ant Design 5
- 样式方案: CSS Variables + Ant Design Token
- 状态管理: Zustand + React Context
- 路由: React Router
- 图表: Recharts
- 数据库: LowDB
- 日志: Winston
- 构建工具: Vite + Electron Builder
开发命令
# 开发模式
npm run dev # 启动 Vite 开发服务器
npm run electron:dev # 启动 Electron 开发模式
# 构建
npm run build # 构建前端代码
npm run electron:build # 构建并打包应用
# 代码质量
npm run lint # 运行 ESLint
npm run lint:fix # 自动修复 ESLint 问题
npm run format # 格式化代码
🎯 功能路线图
v2.1.5 (当前版本)
- Claude Code 与 Codex 双客户端统一管理
- Anthropic / Chat Completions / Responses 三协议互转
- Claude Desktop 路由映射与版本化模型名匹配
- Token 统计(含缓存命中)与用量看板
- 模型能力目录与媒体请求清洗
- MCP & Skills 管理
- 只读/全量模型列表按 Key 来源切换
- 环境自检与上游连通性诊断
- 浅色 / 深色主题
后续计划
- 高级统计分析
- 自动更新
- 插件系统增强
- 主题定制增强
🔄 OpenCC vs CC Switch
| 对比维度 | OpenCC | CC Switch |
|---|---|---|
| 定位 | Claude Code + Codex 统一代理与监控 | 多 CLI 工具配置切换器(Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw) |
| 核心能力 | 本地代理服务器 + 请求转发 + 协议转换 | 配置文件写入 + 供应商切换 |
| 工作原理 | 启动本地 HTTP 代理,拦截并转发 API 请求,支持 Anthropic ↔ OpenAI 格式互转 | 直接修改各 CLI 工具的配置文件(settings.json / .env) |
| 模型管理 | 配置默认模型后 Claude Code 启动即生效,/model 热切换透传 |
供应商级别切换,需重启终端生效(Claude Code 除外) |
| 协议适配 | 内置 Anthropic / OpenAI Chat Completions 双格式代理,任何兼容接口均可接入 | 依赖上游 API 本身兼容目标 CLI 格式 |
| 监控统计 | Token 消耗、请求耗时、成功率、模型维度统计、度量看板 | 用量仪表盘(v3.8+ 新增) |
| MCP / Skills | 支持管理并同步到 Claude Code | 统一管理 4 个应用的 MCP / Skills,双向同步 |
| 代理/故障转移 | 单代理服务,稳定转发 | 内置本地代理热切换、自动故障转移、熔断器 |
| 平台支持 | macOS (Universal) + Windows | macOS + Windows + Linux |
| 技术栈 | Electron + React + TypeScript | Tauri 2 + React + Rust |
| 安装体积 | ~122 MB | ~15 MB(Tauri 原生) |
| 数据存储 | JSON 文件 (~/.opencc/) | SQLite (~/.cc-switch/) |
| 适用场景 | 需要协议转换、请求级监控和审计、本地代理层统一管理 | 多供应商频繁切换、多 CLI 工具统一管理、需要云同步配置 |
总结
- 选 OpenCC:你需要协议转换(如 OpenAI 格式转 Anthropic 格式)、请求级监控统计、或需要一个本地代理层来统一管理 API 转发。
- 选 CC Switch:你同时使用多个 AI CLI 工具(不只是 Claude Code),需要在多家第三方供应商之间频繁切换,或需要跨设备云同步配置。
🤝 贡献指南
我们欢迎所有形式的贡献!
如何贡献
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
代码规范
- 使用 TypeScript 编写代码
- 遵循 ESLint 规则
- 使用 Prettier 格式化代码
- 编写清晰的提交信息
📄 许可证
本项目采用 MIT 许可证 - 详见 LICENSE 文件
🙏 致谢
感谢以下开源项目:
📞 联系方式
- GitHub: @jiashuaiLu
Made with ❤️ by OpenCC Team
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi