toolin.ai logo
toolin.ai
首页
AI工具
AI技能包
AI资讯
精选推文
AI提示词
提交AI工具提交
toolin.ai logo
toolin.ai

百万AI玩家的创作利器库,发现最佳AI工具组合,提升您的创作效率

AI工具847个
技能包11个
产品功能
  • AI工具
  • AI技能包
  • AI资讯
  • 精选推文
关于我们
  • 关于Toolin
  • 联系我们
  • 合作洽谈
  • 更新日志
关注我们
© 2025 toolin.ai. All rights reserved.
服务条款隐私政策
Codepilot保姆级入门:开源全平台Agent客户端
2026/04/09

Codepilot保姆级入门:开源全平台Agent客户端

开源Agent客户端Codepilot支持Claude、OpenAI、国产模型Codeplan,提供Skills/MCP/IM远程连接/生成式UI等完整功能,附详细安装配置教程

Codepilot 是一个全平台开源的 Agent 客户端,GitHub Star 已突破 5100。它支持 Claude、OpenAI 以及几乎所有国产模型的 Codeplan 接入,内置 Skills 市场、MCP 管理、IM 远程连接、设计模式、生成式 UI 等功能。

如果你用过 Claude Code 或 OpenClaw 但觉得功能不够灵活,或者想用一个统一界面管理多个 AI 模型,Codepilot 值得试试。

开始前的准备

  • 操作系统:macOS、Windows 或 Linux
  • 至少一个 AI 模型的 API Key(Claude、OpenAI、国产模型均可)
  • 预计时间:15-30 分钟完成安装和配置

第一步:安装应用

前往 Codepilot 的 GitHub Releases 页面 下载对应平台的安装包。

macOS 用户注意:区分 Intel 和 Apple Silicon 版本,下错会很卡。

Releases 页面截图

Windows 用户:首次打开会弹安全警告,选择继续安装即可。

macOS 用户:因为没有公证签名,苹果会拦截。先完成安装,然后去「系统设置 > 隐私与安全」,下滑找到「仍要打开」,点击打开。

macOS 安全设置

第二步:配置模型服务商

安装完成后,进入「设置 > 服务商 > 添加服务商」。

国产模型 Codeplan 配置(以智谱为例)

  1. 在智谱的 Codeplan 页面获取 API Key
  2. 在 Codepilot 中选择「GLM (CN)」
  3. 填入 API Key
  4. 点击「连接测试」确认连通

智谱连接配置

目前支持的国产 Codeplan 渠道:智谱、MiniMax、Kimi、MIMO、火山方舟、阿里云百炼。

三方 Anthropic API 配置

如果你用的是国内第三方 Claude 代理 API:

  1. 选择「Anthropic Third-party API」渠道
  2. 填写名称(随意,方便区分)
  3. 填写基础 URL(去服务商文档的 ClaudeCode 部分找)
  4. API Key 类型选择:看服务商环境变量前缀是 AUTH 还是 API_KEY
  5. 如果服务商要求设置模型名称,展开「更多」填入对应名称

使用 Claude Code 账号额度

如果你有 Claude Pro 或 Max 会员:

  1. 先安装 Claude Code(可在「设置 > Claude Code」一键安装)
  2. 切换执行引擎为「Claude Code」
  3. 输入框下方模型选择会出现 Claude Code 分类

注意:Codepilot 只能读取 Anthropic 登录状态和手动设置的全局环境变量,CC Switch 等工具配置的状态读不到,需要重新添加。

OpenAI 账号授权

选择「使用 ChatGPT 登录」,在弹出的网页中授权即可。之后可以使用 GPT-5.4 等模型。

Ollama 本地模型

安装 Ollama 并装上想要的模型,然后在服务商中选择 Ollama 连接,输入模型名称。

第三步:创建项目和聊天

Codepilot 采用项目制,每个聊天对应一个本地文件夹。

  1. 点击「新建项目」选择一个文件夹
  2. AI 可以看到和操作该文件夹下的所有文件
  3. 输入框下方可切换模型、代码/计划模式、权限级别

如果任务是复杂的修改,建议先开启「计划模式」,让 AI 先规划再执行。

聊天界面

第四步:安装和使用 Skills 与 MCP

Skills

打开左侧「Skills」面板,切换到「技能市场」,搜索需要的 Skills 并点击安装。

使用方式:在输入框中描述功能并加上 Skills 关键词,或点击输入框的闪电图标查看所有可用 Skills。

Skills 面板

MCP

点击左侧「MCP」切换到 MCP 管理面板,可查看已安装的 MCP 服务,也可点击「添加服务器」安装新的。

使用方式:直接在对话中描述需求,AI 会自动调用对应的 MCP 工具。

第五步:通过飞书、QQ 等 IM 远程连接

Codepilot 支持类似 OpenClaw 的 IM 远程连接功能。

  1. 进入「设置 > 远程桥接」,开启开关并启动桥接
  2. 在下方渠道开启你需要的 IM(飞书、微信、QQ、Discord 等)
  3. 设置远程连接后的工作目录和默认模型
  4. 按照页面下方的设置指南,去对应 IM 的开发者平台完成配置

配置完成后,你关掉电脑,Agent 仍然可以在云端接收和处理你发来的消息。

第六步(进阶):助理模式与生成式 UI

助理模式

在「设置 > 助理」中指定一个助理文件夹(推荐使用 Obsidian 库文件夹),助理会拥有长期记忆,并主动检查和执行任务。

生成式 UI

跟 AI 说「帮我可视化解释一下 XXXX」,它会实时生成一个可交互的图表或流程图。生成的 UI 可以「Pin」到看板上,且数据支持实时更新。

生成式 UI 示例

常见问题

  • Q:Mac 上打开被拦截? A:去「系统设置 > 隐私与安全」找到「仍要打开」。

  • Q:三方 API 连不上? A:检查基础 URL 是否从服务商文档的 ClaudeCode 部分获取,确认 API Key 类型选择正确。

  • Q:选择了 OpenAI 模型后能力变弱? A:使用 OpenAI 模型时,Agent 架构会切换到 AI SDK 模式,写代码能力可能不如 Claude Code 模式。

  • Q:CC Switch 的配置能导入吗? A:不能直接读取,需要按照三方 API 的方式重新添加。

项目链接

  • GitHub: https://github.com/op7418/CodePilot
所有文章

作者

avatar for toolin小编
toolin小编

分类

  • AI教程
开始前的准备第一步:安装应用第二步:配置模型服务商国产模型 Codeplan 配置(以智谱为例)三方 Anthropic API 配置使用 Claude Code 账号额度OpenAI 账号授权Ollama 本地模型第三步:创建项目和聊天第四步:安装和使用 Skills 与 MCPSkillsMCP第五步:通过飞书、QQ 等 IM 远程连接第六步(进阶):助理模式与生成式 UI助理模式生成式 UI常见问题项目链接

相关文章

OpenClaw 2026.4.5:原生视频生成 + 睡眠记忆系统上线
AI产品

OpenClaw 2026.4.5:原生视频生成 + 睡眠记忆系统上线

OpenClaw 最密集功能更新:直接调用 11 家视频生成商出片,/dreaming 命令让 AI 模拟睡眠巩固记忆,支持简体中文界面。

avatar for toolin小编
toolin小编
3天前
MemPalace:免费本地AI记忆系统,GitHub爆火
AI产品

MemPalace:免费本地AI记忆系统,GitHub爆火

开源AI记忆系统MemPalace采用记忆宫殿法,LongMemEval得分96.6%,支持本地运行、MCP接入,年成本仅10美元

avatar for toolin小编
toolin小编
1天前
编程智能体六大核心组件全解析
AI教程

编程智能体六大核心组件全解析

拆解 Claude Code、Codex CLI 等 AI 编程智能体的核心架构,涵盖代码仓库上下文、提示词缓存、工具调用、上下文瘦身、会话记忆和子智能体委派。

avatar for toolin小编
toolin小编
3天前