op7418/CodePilot
GitHub: op7418/CodePilot
一款基于 Electron + Next.js 的多模型 AI Agent 桌面客户端，支持连接 17+ AI 服务商，可通过 MCP 和技能扩展，并从手机端远程控制。
Stars: 6010 | Forks: 645
# 
CodePilot
**多模型 AI agent 桌面客户端** —— 连接任意 AI provider，通过 MCP 和技能进行扩展，从手机端进行控制，并让您的助手学习您的工作流。
[](https://github.com/op7418/CodePilot/releases)
[](https://github.com/op7418/CodePilot/releases)
[](https://github.com/op7418/CodePilot/stargazers)
[](https://github.com/op7418/CodePilot/releases)
[](LICENSE)
[中文文档](./README_CN.md) | [日本語](./README_JA.md)
[下载](#download) | [快速开始](#quick-start) | [文档](#documentation) | [贡献指南](#contributing) | [社区](#community)
## 下载
| 平台 | 下载 | 架构 |
|---|---|---|
| macOS | [Apple Silicon (.dmg)](https://github.com/op7418/CodePilot/releases/latest) · [Intel (.dmg)](https://github.com/op7418/CodePilot/releases/latest) | arm64 / x64 |
| Windows | [安装程序 (.exe)](https://github.com/op7418/CodePilot/releases/latest) | x64 + arm64 |
| Linux | 从源码构建 | x64 + arm64 |
或访问 [Releases](https://github.com/op7418/CodePilot/releases) 页面获取所有版本。
## 为什么选择 CodePilot
### 多 Provider，统一界面
开箱即用连接 **17+ AI provider**。在不丢失上下文的情况下，可以在对话中途切换 provider 和模型。
| 类别 | Provider |
|---|---|
| 直接 API | Anthropic, OpenRouter |
| 云平台 | AWS Bedrock, Google Vertex AI |
| 国内 AI provider | Zhipu GLM (国内/全球), Kimi, Moonshot, MiniMax (国内/全球), Volcengine Ark (Doubao), Xiaomi MiMo, Aliyun Bailian (Qwen) |
| 本地与自托管 | Ollama, LiteLLM |
| 自定义 | 任何兼容 Anthropic 或 OpenAI 的 endpoint |
| 多媒体 | Google Gemini (图像生成) |
### 超越编码 —— 一个完整的 AI agent
CodePilot 起初是一个编码工具，但已发展成为**通用的 AI agent 桌面端**：
- **助手工作区** —— Persona 文件、持久化记忆、引导流程和每日签到。您的助手会学习您的偏好并随时间适应。
- **生成式 UI** —— AI 可以创建在应用内实时渲染的交互式仪表板、图表和可视化小部件。
- **远程桥接** —— 连接到 Telegram、飞书、Discord、QQ 和微信。从手机发送消息，在桌面端获取响应。
- **MCP + 技能** —— 添加具有运行时监控的 MCP server (stdio / sse / http)。定义可重用的技能或从 skills.sh 市场安装。
- **媒体工作室** —— AI 图像生成，支持批量任务、画廊和标签。
- **任务调度器** —— 使用 cron 表达式或时间间隔来安排循环任务。
### 专为日常使用打造
- 暂停、恢复以及**将会话回退到任意检查点**
- **分屏**并排双会话
- 通过每日图表跟踪 **token 使用量和成本**
- 导入 Claude Code CLI 会话历史
- 深色/浅色主题切换
- 英文 + 中文界面
## 快速开始
### 路径 A：下载发布版（面向大多数用户）
1. 从上方的[下载](#download)部分下载适合您平台的安装程序
2. 启动 CodePilot
3. 在 **Settings > Providers** 中**配置 Provider** —— 为任意受支持的 provider 添加您的 API key
4. 开始对话
### 路径 B：从源码构建（面向开发者）
| 前置条件 | 最低版本 |
|---|---|
| Node.js | 18+ |
| npm | 9+ (随 Node 18 一起提供) |
```
git clone https://github.com/op7418/CodePilot.git
cd CodePilot
npm install
npm run dev # browser mode at http://localhost:3000
# -- 或者 --
npm run electron:dev # full desktop app
```
## 核心能力
### 对话与交互
| 能力 | 详情 |
|---|---|
| 交互模式 | Code / Plan / Ask |
| 推理力度 | Low / Medium / High / Max + Thinking 模式 |
| 权限控制 | Default / Full Access，以及逐操作审批 |
| 会话控制 | 暂停、恢复、回退至检查点、归档 |
| 模型切换 | 对话中途更改模型 |
| 分屏 | 并排双会话 |
| 附件 | 支持多模态视觉的文件和图像 |
| 斜杠命令 | /help /clear /cost /compact /doctor /review 等 |
### 扩展与集成
| 能力 | 详情 |
|---|---|
| Provider | 17+ provider: Anthropic, OpenRouter, Bedrock, Vertex, Zhipu GLM, Kimi, Moonshot, MiniMax, Volcengine, MiMo, Bailian, Ollama, LiteLLM, 自定义 endpoint |
| MCP server | stdio / sse / http，运行时状态监控 |
| 技能 | 自定义 / 项目 / 全局技能，skills.sh 市场 |
| 桥接 | Telegram / 飞书 / Discord / QQ / 微信远程控制 |
| CLI 导入 | 导入 Claude Code CLI .jsonl 会话历史 |
| 图像生成 | Gemini 图像生成，批量任务，画廊 |
### 数据与工作区
| 能力 | 详情 |
|---|---|
| 助手工作区 | Persona 文件 (soul.md, user.md, claude.md, memory.md)、引导流程、每日签到、持久化记忆 |
| 生成式 UI | AI 创建的交互式仪表板和可视化小部件 |
| 文件浏览器 | 项目文件树，支持语法高亮预览 |
| Git 面板 | 状态、分支、提交、工作树管理 |
| 使用分析 | token 计数、成本估算、每日使用图表 |
| 任务调度器 | 基于 cron 和时间间隔的调度并持久化 |
| 本地存储 | SQLite (WAL 模式)，所有数据均保存在您的机器上 |
| i18n | 英文 + 中文 |
| 主题 | 深色 / 浅色，一键切换 |
## 首次启动
1. **配置 Provider** —— 前往 **Settings > Providers**，为您想使用的 provider 添加凭证。CodePilot 包含所有主要 provider 的预设 —— 只需选择一个并输入您的 API key。
2. **创建对话** —— 选择工作目录，选择一个模式 (Code / Plan / Ask)，并选择模型。
3. **设置助手工作区**（可选） —— 前往 **Settings > Assistant**，选择一个工作区目录，并启用 Onboarding。CodePilot 会在工作区根目录下创建 `soul.md`、`user.md`、`claude.md` 和 `memory.md`。
4. **添加 MCP server**（可选） —— 在侧边栏前往 **MCP** 页面以添加和管理 MCP server。自定义技能在单独的 **Skills** 页面进行管理。
5. **安装 Claude Code CLI**（可选） —— 对于文件编辑和终端命令等高级功能，请安装 CLI：`npm install -g @anthropic-ai/claude-code`
## 平台与安装说明
macOS 构建版已使用 Developer ID 证书进行代码签名，但未进行公证，因此 Gatekeeper 可能会在首次启动时弹出提示。Windows 和 Linux 构建版未签名。
## 文档
📖 **完整文档：** [英文](https://www.codepilot.sh/docs) | [中文](https://www.codepilot.sh/zh/docs)
**入门指南：**
- [快速开始](#quick-start) —— 下载或从源码构建
- [首次启动](#first-launch) —— Provider 设置，工作区配置
- [安装指南](https://www.codepilot.sh/docs/installation) —— 详细的设置说明
**用户指南：**
- [Provider](https://www.codepilot.sh/docs/providers) —— 配置 AI provider 和自定义 endpoint
- [MCP Server](https://www.codepilot.sh/docs/mcp) —— 添加和管理 Model Context Protocol server
- [技能](https://www.codepilot.sh/docs/skills) —— 自定义技能、项目技能以及 skills.sh 市场
- [桥接](https://www.codepilot.sh/docs/bridge) —— 通过 Telegram、飞书、Discord、QQ、微信进行远程控制
- [助手工作区](https://www.codepilot.sh/docs/assistant-workspace) —— Persona 文件、引导流程、记忆、每日签到
- [常见问题](https://www.codepilot.sh/docs/faq) —— 常见问题与解决方案
**开发者文档：**
- [ARCHITECTURE.md](./ARCHITECTURE.md) —— 架构、技术栈、目录结构、数据流
- [docs/handover/](./docs/handover/) —— 设计决策和交接文档
- [docs/exec-plans/](./docs/exec-plans/) —— 执行计划和技术债务追踪
## 常见问题
`npm run dev` 仅启动 Next.js 开发服务器 —— 您可以在浏览器中通过 `http://localhost:3000` 使用 CodePilot。`npm run electron:dev` 会同时启动 Next.js 和 Electron 外壳，为您提供带有原生窗口控件的完整桌面应用体验。
## 许可证
[Business Source License 1.1 (BSL-1.1)](LICENSE)
- **个人 / 学术 / 非盈利用途**：免费且无限制
- **商业用途**：需要单独的许可 —— 请联系 [@op7418 on X](https://x.com/op7418)
- **变更日期**：2029-03-16 —— 届时代码将转换为 Apache 2.0
CodePilot
**多模型 AI agent 桌面客户端** —— 连接任意 AI provider，通过 MCP 和技能进行扩展，从手机端进行控制，并让您的助手学习您的工作流。
[](https://github.com/op7418/CodePilot/releases)
[](https://github.com/op7418/CodePilot/releases)
[](https://github.com/op7418/CodePilot/stargazers)
[](https://github.com/op7418/CodePilot/releases)
[](LICENSE)
[中文文档](./README_CN.md) | [日本語](./README_JA.md)
[下载](#download) | [快速开始](#quick-start) | [文档](#documentation) | [贡献指南](#contributing) | [社区](#community)
## 下载
| 平台 | 下载 | 架构 |
|---|---|---|
| macOS | [Apple Silicon (.dmg)](https://github.com/op7418/CodePilot/releases/latest) · [Intel (.dmg)](https://github.com/op7418/CodePilot/releases/latest) | arm64 / x64 |
| Windows | [安装程序 (.exe)](https://github.com/op7418/CodePilot/releases/latest) | x64 + arm64 |
| Linux | 从源码构建 | x64 + arm64 |
或访问 [Releases](https://github.com/op7418/CodePilot/releases) 页面获取所有版本。
## 为什么选择 CodePilot
### 多 Provider，统一界面
开箱即用连接 **17+ AI provider**。在不丢失上下文的情况下，可以在对话中途切换 provider 和模型。
| 类别 | Provider |
|---|---|
| 直接 API | Anthropic, OpenRouter |
| 云平台 | AWS Bedrock, Google Vertex AI |
| 国内 AI provider | Zhipu GLM (国内/全球), Kimi, Moonshot, MiniMax (国内/全球), Volcengine Ark (Doubao), Xiaomi MiMo, Aliyun Bailian (Qwen) |
| 本地与自托管 | Ollama, LiteLLM |
| 自定义 | 任何兼容 Anthropic 或 OpenAI 的 endpoint |
| 多媒体 | Google Gemini (图像生成) |
### 超越编码 —— 一个完整的 AI agent
CodePilot 起初是一个编码工具，但已发展成为**通用的 AI agent 桌面端**：
- **助手工作区** —— Persona 文件、持久化记忆、引导流程和每日签到。您的助手会学习您的偏好并随时间适应。
- **生成式 UI** —— AI 可以创建在应用内实时渲染的交互式仪表板、图表和可视化小部件。
- **远程桥接** —— 连接到 Telegram、飞书、Discord、QQ 和微信。从手机发送消息，在桌面端获取响应。
- **MCP + 技能** —— 添加具有运行时监控的 MCP server (stdio / sse / http)。定义可重用的技能或从 skills.sh 市场安装。
- **媒体工作室** —— AI 图像生成，支持批量任务、画廊和标签。
- **任务调度器** —— 使用 cron 表达式或时间间隔来安排循环任务。
### 专为日常使用打造
- 暂停、恢复以及**将会话回退到任意检查点**
- **分屏**并排双会话
- 通过每日图表跟踪 **token 使用量和成本**
- 导入 Claude Code CLI 会话历史
- 深色/浅色主题切换
- 英文 + 中文界面
## 快速开始
### 路径 A：下载发布版（面向大多数用户）
1. 从上方的[下载](#download)部分下载适合您平台的安装程序
2. 启动 CodePilot
3. 在 **Settings > Providers** 中**配置 Provider** —— 为任意受支持的 provider 添加您的 API key
4. 开始对话
### 路径 B：从源码构建（面向开发者）
| 前置条件 | 最低版本 |
|---|---|
| Node.js | 18+ |
| npm | 9+ (随 Node 18 一起提供) |
```
git clone https://github.com/op7418/CodePilot.git
cd CodePilot
npm install
npm run dev # browser mode at http://localhost:3000
# -- 或者 --
npm run electron:dev # full desktop app
```
## 核心能力
### 对话与交互
| 能力 | 详情 |
|---|---|
| 交互模式 | Code / Plan / Ask |
| 推理力度 | Low / Medium / High / Max + Thinking 模式 |
| 权限控制 | Default / Full Access，以及逐操作审批 |
| 会话控制 | 暂停、恢复、回退至检查点、归档 |
| 模型切换 | 对话中途更改模型 |
| 分屏 | 并排双会话 |
| 附件 | 支持多模态视觉的文件和图像 |
| 斜杠命令 | /help /clear /cost /compact /doctor /review 等 |
### 扩展与集成
| 能力 | 详情 |
|---|---|
| Provider | 17+ provider: Anthropic, OpenRouter, Bedrock, Vertex, Zhipu GLM, Kimi, Moonshot, MiniMax, Volcengine, MiMo, Bailian, Ollama, LiteLLM, 自定义 endpoint |
| MCP server | stdio / sse / http，运行时状态监控 |
| 技能 | 自定义 / 项目 / 全局技能，skills.sh 市场 |
| 桥接 | Telegram / 飞书 / Discord / QQ / 微信远程控制 |
| CLI 导入 | 导入 Claude Code CLI .jsonl 会话历史 |
| 图像生成 | Gemini 图像生成，批量任务，画廊 |
### 数据与工作区
| 能力 | 详情 |
|---|---|
| 助手工作区 | Persona 文件 (soul.md, user.md, claude.md, memory.md)、引导流程、每日签到、持久化记忆 |
| 生成式 UI | AI 创建的交互式仪表板和可视化小部件 |
| 文件浏览器 | 项目文件树，支持语法高亮预览 |
| Git 面板 | 状态、分支、提交、工作树管理 |
| 使用分析 | token 计数、成本估算、每日使用图表 |
| 任务调度器 | 基于 cron 和时间间隔的调度并持久化 |
| 本地存储 | SQLite (WAL 模式)，所有数据均保存在您的机器上 |
| i18n | 英文 + 中文 |
| 主题 | 深色 / 浅色，一键切换 |
## 首次启动
1. **配置 Provider** —— 前往 **Settings > Providers**，为您想使用的 provider 添加凭证。CodePilot 包含所有主要 provider 的预设 —— 只需选择一个并输入您的 API key。
2. **创建对话** —— 选择工作目录，选择一个模式 (Code / Plan / Ask)，并选择模型。
3. **设置助手工作区**（可选） —— 前往 **Settings > Assistant**，选择一个工作区目录，并启用 Onboarding。CodePilot 会在工作区根目录下创建 `soul.md`、`user.md`、`claude.md` 和 `memory.md`。
4. **添加 MCP server**（可选） —— 在侧边栏前往 **MCP** 页面以添加和管理 MCP server。自定义技能在单独的 **Skills** 页面进行管理。
5. **安装 Claude Code CLI**（可选） —— 对于文件编辑和终端命令等高级功能，请安装 CLI：`npm install -g @anthropic-ai/claude-code`
## 平台与安装说明
macOS 构建版已使用 Developer ID 证书进行代码签名，但未进行公证，因此 Gatekeeper 可能会在首次启动时弹出提示。Windows 和 Linux 构建版未签名。
macOS：首次启动时 Gatekeeper 报错
**选项 1** —— 在 Finder 中右键点击 `CodePilot.app` > 打开 > 确认。 **选项 2** —— 系统设置 > 隐私与安全性 > 滚动到安全性 > 点击“仍要打开”。 **选项 3** —— 在终端中运行： ``` xattr -cr /Applications/CodePilot.app ```Windows：SmartScreen 阻止了安装程序
**选项 1** —— 在 SmartScreen 对话框中点击“更多信息”，然后点击“仍要运行”。 **选项 2** —— 设置 > 应用 > 高级应用设置 > 将“应用安装控制”设置为允许来自任意位置的应用。我需要 Claude Code CLI 吗？
不需要。您可以在没有 Claude Code CLI 的情况下，使用 CodePilot 与任何受支持的 provider（OpenRouter、Zhipu GLM、Volcengine、Ollama 等）配合使用。只有在您希望 Claude 直接在您的机器上编辑文件、运行终端命令或使用 git 操作时，才需要 CLI。对于聊天和助手功能，只需配置 provider 并开始对话即可。配置了 Provider 但没有出现模型
请验证 API key 是否有效以及 endpoint 是否可达。某些 provider（Bedrock、Vertex）除了 API key 之外，还需要额外的环境变量或 IAM 配置。使用内置诊断工具（**Settings > Providers > Run Diagnostics**）检查连接性。npm run dev 和 npm run electron:dev 有什么区别？
`npm run dev` 仅启动 Next.js 开发服务器 —— 您可以在浏览器中通过 `http://localhost:3000` 使用 CodePilot。`npm run electron:dev` 会同时启动 Next.js 和 Electron 外壳，为您提供带有原生窗口控件的完整桌面应用体验。
助手工作区文件在哪里？
设置工作区时，CodePilot 会在**工作区根目录**创建四个 Markdown 文件：`soul.md`（性格）、`user.md`（用户画像）、`claude.md`（规则）和 `memory.md`（长期笔记）。状态跟踪（引导进度、签到日期）存储在 `.assistant/` 子目录中。每日记忆存放在 `memory/daily/` 中。桥接功能需要针对不同平台进行额外设置
每个桥接通道（Telegram、飞书、Discord、QQ、微信）都需要自己的 bot token 或应用凭证。前往侧边栏的 **Bridge** 页面配置通道。您需要先在目标平台上创建一个 bot，并将 token 提供给 CodePilot。标签：AI智能体, Electron, MITM代理, 人工智能, 多模型支持, 桌面客户端, 用户模式Hook绕过, 自动化攻击