CodePilot

一款多模型 AI 助手桌面客户端 -- 可连接任意 AI 提供商，通过 MCP 和技能扩展功能，用手机控制，并让您的助手学习您的工作流程。

中文文档 | 日本語

下载 | 快速入门 | 文档 | 贡献 | 社区

下载

或访问 发布页面 获取所有版本。

为什么选择 CodePilot

多提供商，统一界面

开箱即用即可连接 17+ 家 AI 提供商。在对话过程中无需丢失上下文即可切换提供商和模型。

不止于编码 — 全功能 AI 助手

CodePilot 最初是一款编码工具，如今已发展为一款 通用型 AI 助手桌面应用：

• 助理工作区 — 包括角色文件、持久化记忆、引导流程和每日问候。您的助手会不断学习您的偏好并逐步适应。
• 生成式 UI — AI 可以创建交互式仪表盘、图表和可视化小部件，并在应用内实时渲染。
• 远程桥接 — 连接 Telegram、飞书、Discord、QQ 和微信。您可以在手机上发送消息，在桌面端接收回复。
• MCP + 技能 — 添加 MCP 服务器（stdio / sse / http），并进行运行时监控。您可以定义可重用的技能，或从 skills.sh 市场安装。
• 媒体工作室 — AI 图像生成支持批量任务、图库和标签管理。
• 任务调度器 — 使用 cron 表达式或间隔时间安排定期任务。

专为日常使用打造

• 暂停、恢复，并 将会话回退到任意检查点
• 分屏 同时开启两个会话
• 通过每日图表跟踪 token 使用情况和费用
• 导入 Claude Code CLI 会话历史
• 暗色 / 浅色主题切换
• 英文 + 中文界面

快速入门

路径 A：下载发行版（大多数用户）

1. 从上方的 下载 部分下载适合您平台的安装程序
2. 启动 CodePilot
3. 在 设置 > 提供商 中 配置提供商 — 添加您支持的任何提供商的 API 密钥
4. 开始对话

注意： 安装 Claude Code CLI (npm install -g @anthropic-ai/claude-code) 可解锁更多功能，如直接编辑文件、执行终端命令和 Git 操作。虽然推荐使用，但并非基础聊天所必需。

路径 B：从源码构建（开发者）

git clone https://github.com/op7418/CodePilot.git
cd CodePilot
npm install
npm run dev              # 浏览器模式，地址为 http://localhost:3000
# 或 --
npm run electron:dev     # 完整桌面应用

核心功能

对话与交互

扩展与集成

数据与工作区

首次启动

1. 配置提供商 — 前往 设置 > 提供商，添加您想要使用的提供商的凭据。CodePilot 为所有主流提供商提供了预设选项——只需选择一个并输入您的 API 密钥。
2. 创建对话 — 选择一个工作目录，选定模式（代码 / 计划 / 提问），并选择一个模型。
3. 设置助理工作区（可选）— 前往 设置 > 助理，选择一个工作区目录，并启用引导流程。CodePilot 会在工作区根目录下创建 soul.md、user.md、claude.md 和 memory.md 文件。
4. 添加 MCP 服务器（可选）— 前往侧边栏中的 MCP 页面，以添加和管理 MCP 服务器。自定义技能则在单独的 技能 页面进行管理。
5. 安装 Claude Code CLI（可选）— 若要使用文件编辑和终端命令等高级功能，请安装 CLI：npm install -g @anthropic-ai/claude-code

平台与安装说明

macOS 版本已使用开发者 ID 证书进行代码签名，但尚未经过公证，因此首次启动时 Gatekeeper 可能仍会弹出提示。Windows 和 Linux 版本则未签名。

xattr -cr /Applications/CodePilot.app

文档

📖 完整文档： 英文 | 中文

入门指南：

• 快速入门 -- 下载或从源码构建
• 首次启动 -- 提供商设置、工作区配置
• 安装指南 -- 详细设置说明

用户指南：

• 提供商 -- 配置 AI 提供商和自定义端点
• MCP 服务器 -- 添加和管理模型上下文协议服务器
• 技能 -- 自定义技能、项目技能以及 skills.sh 市场
• 桥接 -- 通过 Telegram、飞书、Discord、QQ、微信进行远程控制
• 助理工作区 -- 角色文件、引导流程、记忆、每日签到
• 常见问题解答 -- 常见问题及解决方案

开发者文档：

• ARCHITECTURE.md -- 架构、技术栈、目录结构、数据流
• docs/handover/ -- 设计决策与交接文档
• docs/exec-plans/ -- 执行计划与技术债务跟踪器

常见问题解答

社区

扫描二维码加入 WeChat 用户群，参与讨论、反馈和最新动态。

• GitHub Issues -- Bug 报告和功能请求
• GitHub Discussions -- 问题解答和一般讨论

贡献

1. 分支仓库并创建功能分支
2. 使用 npm install 和 npm run electron:dev 进行本地开发
3. 在提交 PR 之前运行 npm run test
4. 向 main 分支提交带有清晰描述的 PR

请确保每次 PR 只包含一个功能或修复。

npm run dev                    # Next.js 开发服务器（浏览器）
npm run electron:dev           # 完整 Electron 应用（开发模式）
npm run build                  # 生产构建
npm run electron:build         # 构建 Electron 发行版
npm run electron:pack:mac      # macOS DMG（arm64 + x64）
npm run electron:pack:win      # Windows NSIS 安装程序
npm run electron:pack:linux    # Linux AppImage、deb、rpm

许可证

商业源代码许可证 1.1 (BSL-1.1)

• 个人 / 学术 / 非营利用途：免费且无限制
• 商业用途：需另行授权 — 请联系 @op7418 on X
• 变更日期：2029-03-16 — 此后代码将转为 Apache 2.0 许可证

CodePilot 快速上手指南

CodePilot 是一款支持多模型接入的 AI 智能体桌面客户端。它允许你连接任意 AI 提供商，通过 MCP 协议扩展能力，并支持手机远程控制，让助手逐步学习你的工作流。

环境准备

系统要求

CodePilot 支持以下主流操作系统：

• macOS: Apple Silicon (arm64) 或 Intel (x64)
• Windows: x64 或 arm64
• Linux: x64 或 arm64 (支持 AppImage, .deb, .rpm)

前置依赖（仅针对源码构建）

如果你选择下载安装包使用，无需安装额外依赖。若需从源码构建或开发，请确保安装以下工具：

• Node.js: 18+ 版本
• npm: 9+ 版本（通常随 Node.js 自动安装）

可选增强：安装 Claude Code CLI 可解锁直接文件编辑、终端命令执行及 Git 操作等高级功能（非必需）：

npm install -g @anthropic-ai/claude-code

安装步骤

方式一：下载预编译包（推荐大多数用户）

1. 访问 Releases 页面。
2. 根据你的操作系统下载对应的安装包：
   • macOS: 下载 .dmg 文件（区分 Apple Silicon 或 Intel）。
   • Windows: 下载 .exe 安装程序。
   • Linux: 下载 .deb (Debian/Ubuntu), .rpm (Fedora/CentOS) 或 AppImage。
3. 运行安装程序并按照提示完成安装。

macOS 用户注意：若首次启动遇到"无法打开”提示，请在“系统设置”>“隐私与安全性”中点击“仍要打开”，或在终端运行 xattr -cr /Applications/CodePilot.app。

方式二：源码构建（开发者）

git clone https://github.com/op7418/CodePilot.git
cd CodePilot
npm install

# 模式 A: 浏览器开发模式
npm run dev

# 模式 B: 完整桌面应用开发模式
npm run electron:dev

基本使用

1. 配置 AI 提供商

启动 CodePilot 后，首先需要配置模型来源：

• 进入 Settings (设置) > Providers (提供商)。
• 选择你拥有的服务商（如 Zhipu GLM, Moonshot, OpenRouter, Ollama 等）。
• 填入对应的 API Key。CodePilot 内置了国内主流大模型（智谱、月之暗面、MiniMax 等）的预设配置。

2. 开始对话

• 点击主界面新建会话。
• 选择工作目录：指定代码项目所在的文件夹。
• 选择模式：根据需求切换 Code (编码), Plan (规划), 或 Ask (问答) 模式。
• 选择模型：从已配置的提供商中选择具体模型。
• 输入指令即可开始与 AI 协作。

3. 进阶功能（可选）

• 助手工作区：在 Settings > Assistant 中启用 Onboarding，系统将生成 soul.md, user.md 等文件，让 AI 记忆你的偏好。
• MCP 扩展：在侧边栏 MCP 页面添加服务器，扩展 AI 的工具调用能力。
• 远程桥接：配置 Bridge 页面，绑定 Telegram、飞书或微信，实现手机端发送消息、桌面端接收回复。