跨平台 AI 代理管理工具，支持 Claude、Gemini、Codex、Copilot、Qwen、iFlow、Kiro 等。
LinJun 是一款原生桌面应用，用于管理 CLIProxyAPIPlus —— 一个为 AI 编程助手提供支持的本地代理服务器。它帮助你在 macOS、Windows 和 Linux 上统一管理多个 AI 账户、追踪配额、配置 CLI 工具。
## ✨ 功能特性 - 🔌 **扩展服务商支持**：支持 Claude、Gemini、Codex、Qwen、Antigravity、iFlow、GitHub Copilot、Kiro、自定义服务商、AmpCode - 📊 **配额 + 模型可见性**：可在配额页通过 **查看全部模型** 浏览按服务商隔离的模型目录 - 🧠 **服务商感知模型过滤**：配额模型列表会按当前服务商上下文过滤（如 Codex/Copilot/Kiro） - ⚡ **大体量日志性能优化**：日志页已支持虚拟列表与增量轮询，大数据量下保持流畅 - 🚀 **一键配置 Agent**：自动检测并配置 Claude Code、OpenCode、Gemini CLI 等工具 - 📈 **实时仪表盘**：监控请求流量、Token 使用量和成功率 - 🔀 **智能路由**：支持轮询（Round Robin）和填充优先（Fill First）故障转移策略 - 🔑 **API Key 管理**：为本地代理生成和管理密钥 - 🖥️ **系统托盘集成**：从菜单栏快速访问状态 - 🌐 **多语言支持**：支持英文和简体中文 ## 🤖 支持的生态系统 ### AI 服务商 | 服务商 | 认证方式 | | -------------- | -------------- | | Claude Code | OAuth | | Gemini CLI | OAuth | | OpenAI Codex | OAuth | | Qwen Code | OAuth | | Antigravity | OAuth (Google) | | iFlow | OAuth | | GitHub Copilot | OAuth | | Kiro | OAuth | | 自定义服务商 | API Key | | AmpCode | API Key | ### 兼容的 CLI Agent LinJun 可以自动配置以下工具使用你的集中代理： - Claude Code - Codex CLI - Gemini CLI - OpenCode - Amp CLI - Droid CLI - iFlow CLI ## 📥 安装 ### 下载安装 从 [GitHub Releases](https://github.com/wangdabaoqq/LinJun/releases) 下载最新版本： | 平台 | 下载文件 | | --------------------- | ------------------------------------- | | macOS (Apple Silicon) | `LinJun-x.x.x-arm64.dmg` | | macOS (Intel) | `LinJun-x.x.x-x64.dmg` | | Windows | `LinJun-x.x.x-x64.exe` | | Linux | `LinJun-x.x.x-x64.AppImage` 或 `.deb` | ### 从源码构建 **环境要求：** - Node.js 18+ - Bun（推荐）或 npm - Git ```bash # 克隆仓库 git clone https://github.com/wangdabaoqq/LinJun.git cd LinJun # 安装依赖 bun install # 下载 CLIProxyAPIPlus 二进制文件 bun run download:binary # 启动开发服务器 bun dev ``` ### 构建生产版本 ```bash bun run build:mac # macOS (dmg, zip) bun run build:win # Windows (nsis) bun run build:linux # Linux (AppImage, deb) bun run build:all # 所有平台 ``` ## 📖 使用方法 ### 1. 启动服务器 启动 LinJun，点击 **Start** 初始化本地代理服务器。 ### 2. 连接账户 进入 **Providers** 标签页 → 选择服务商 → 通过 OAuth 认证或输入 API Key。 ### 3. 配置 Agent 进入 **Agents** 标签页 → 选择检测到的 Agent → 配置使用本地代理。 ### 4. 监控使用情况 - **Dashboard**：整体健康状况和流量 - **Quota**：每个账户的使用明细，以及按服务商查看完整模型目录（查看全部模型） - **Logs**：原始请求日志，用于调试 ## 📸 截图 | 仪表盘 | 服务商 | | -------------------------------------------- | -------------------------------------------- | |  |  | | 配额监控 | 设置 | | ------------------------------------ | ------------------------------------------ | |  |  | | 代理配置 | API 密钥 | | -------------------------------------- | ---------------------------------------- | |  |  | | 引导页 | 日志 | | ------------------------------------ | ---------------------------------- | |  |  | ## ⚙️ 设置选项 - **端口**：更改代理监听端口（默认：8310） - **路由策略**：轮询（Round Robin）或填充优先（Fill First） - **自动启动**：应用启动时自动启动代理 - **通知**：开启/关闭配额警告提醒 ## 🏗️ 项目结构 ``` LinJun/ ├── src/ │ ├── main/ # Electron 主进程 │ │ ├── index.ts # 应用入口 │ │ ├── tray.ts # 系统托盘集成 │ │ ├── proxy/ # CLIProxyAPIPlus 管理 │ │ │ ├── manager.ts # 进程生命周期 │ │ │ └── api.ts # 管理 API 客户端 │ │ ├── ipc/ # IPC 处理器 │ │ ├── quota/ # 服务商配额服务 │ │ ├── logging/ # 请求日志 │ │ └── utils/ # CLI 检测、存储 │ ├── preload/ # 上下文桥接 │ └── renderer/ # React 前端 │ ├── components/ # UI 组件 │ ├── stores/ # Zustand 状态 │ └── hooks/ # 自定义 Hooks ├── resources/ # 静态资源 └── scripts/ # 构建脚本 ``` ## 🔧 技术栈 | 组件 | 技术 | | -------- | --------------------- | | 框架 | Electron 33+ | | 前端 | React 18 + TypeScript | | 样式 | Tailwind CSS | | 状态管理 | Zustand | | 构建工具 | Vite + electron-vite | | 打包工具 | electron-builder | ## 📁 Token 存储 认证 Token 存储在 `~/.cli-proxy-api/` 目录下的 JSON 文件中： - `codex-{email}-Plus.json` - `antigravity-{email}.json` - `kiro-google-{id}.json` - 等等 ## ❓ 常见问题 ### macOS 提示"应用已损坏，无法打开"？ 由于 macOS 的安全机制，非 App Store 下载的应用可能会触发此提示。运行以下命令即可修复： ```bash sudo xattr -rd com.apple.quarantine "/Applications/霖君.app" ``` ## 🤝 贡献 1. Fork 本项目 2. 创建功能分支 (`git checkout -b feature/amazing-feature`) 3. 提交更改 (`git commit -m 'Add amazing feature'`) 4. 推送到分支 (`git push origin feature/amazing-feature`) 5. 提交 Pull Request ## 📄 许可证 MIT 许可证。详见 [LICENSE](LICENSE)。 ## 🙏 致谢 - [CLIProxyAPIPlus](https://github.com/router-for-me/CLIProxyAPIPlus) - 强大的代理服务器 - [Quotio](https://github.com/nguyenphutrong/quotio) - 项目灵感来源 - [Electron](https://www.electronjs.org/) - 跨平台框架 - [Vite](https://vitejs.dev/) - 快速构建工具 --- [](https://star-history.com/#wangdabaoqq/LinJun&Date)