☰
3种方式让任意AI接入PenEcho:API密钥、Codex/Claude CLI与云端模型完整指南
2026/10/4 4:15:55 网站建设 项目流程

3种方式让任意AI接入PenEcho:API密钥、Codex/Claude CLI与云端模型完整指南

【免费下载链接】penechoThink with AI beyond the chat box. A shared canvas for handwriting, equations, diagrams, and spatial reasoning.项目地址: https://gitcode.com/gh_mirrors/pe/penecho

PenEcho 是一款 AI 无限画布工具:手写笔记、数学公式、架构图和空间推理都在同一块画布上进行,停笔片刻后 AI 会自动回应,把草图变成专业图表和可运行的组件。本文完整介绍3 种接入 AI 的方式——填入自己的 API 密钥、复用已登录的 Codex / Claude Code / Kimi CLI 订阅、直接使用 PenEcho 云端托管模型,新手跟着步骤走,几分钟就能跑通。

一、快速开始:3分钟启动 PenEcho 画布

启动方式要求适合人群
🖥️ 桌面应用macOS / Windows,自动更新日常主力使用
⌨️ npm 命令行Node.js 22.19+喜欢命令行的开发者
🌐 浏览器登录官方账号即可不想安装任何软件

npm 方式只需两条命令:

npm install -g penecho penecho # 打开 http://localhost:3888

首次启动会让你设置一个6 位访问码(或在可信网络上直接开放访问)。进入画布后,打开设置 → AI 与连接,就能管理下面三种 AI 连接方式。保存的连接统一存放在本地的连接存储中,密钥只留存在你自己的电脑上,详见 配置参考。

二、方式一:填入 API 密钥,接入任意模型 API

这是自由度最高的方式:支持OpenAI 兼容和Anthropic 兼容两种请求格式,只要你的服务商提供这类 API,就能接入。

配置步骤:

  1. 在设置 → AI 与连接中新建一个 API 连接
  2. 选择服务商预设或直接填自定义端点
  3. 粘贴 API 密钥,手动输入模型 ID 或点击Load models从接口拉取模型列表
  4. 点击Test验证,通过后Save

PenEcho 内置了十几个常见服务商的预设,选好服务商即可自动带出地址:

预设服务预设服务
OpenRouterDeepSeek
Qwen(北京/新加坡/弗吉尼亚)智谱 GLM / Z.AI
SiliconFlow 硅基流动Groq、Mistral、xAI

完整预设清单与端点说明见 API 服务商预设文档,预设注册表源码在 src/providers/api-presets.js。

💡小技巧:推理强度随心调。画布工具栏上有一个固定的Reasoning菜单,可在none / low / medium / high和当前连接保存值之间切换,每次请求单独覆盖,不用反复改设置。复杂手写识别、数学推导建议用high,日常问答用medium更快。

三、方式二:复用 Codex / Claude Code / Kimi CLI 订阅,免 API 密钥

如果你已经订阅了 ChatGPT Plus(Codex)、Claude Pro/Max(Claude Code)或 Kimi Code,完全不用再买一份 API 费用——直接登录 CLI,PenEcho 就能调用。

配置步骤:

  1. 在连接管理器中选择 Codex CLI、Claude CLI 或 Kimi CLI
  2. 缺失 CLI 时,桌面端会显示一键官方安装器;不想用一键安装也可以手动执行官方安装脚本
  3. 完成登录(codex login/claude auth login/kimi login)
  4. 点击Test:Codex 只做本地可执行文件 + 登录态 + 模型目录检查,不消耗 token;Claude 和 API 会发送一个极小的真实请求验证

方式二值得知道的细节:

  • ✅ 不需要 API 密钥,复用你已有的订阅额度
  • ✅ CLI 在隔离的临时环境中运行,你的全局配置、项目规则不会被画布请求污染
  • ✅ 启动检查不消耗模型 token,失败时只显示诊断信息,不影响画布其他功能
  • ✅ 适配器源码:codex-cli.js、claude-cli.js,运行原理见 架构文档

四、方式三:PenEcho 云端模型,零密钥零配置开画

不想管密钥、也不想装任何东西?在浏览器登录 PenEcho 官方账号即可:

  • ☁️托管模型:登录后直接选择模型开始画,按账号积分计费
  • 🔄云端画布:项目、收藏跨设备同步,手机浏览器也能继续上次的思路
  • 🔗关联设备:云端画布可以指挥你已关联的电脑,用本地 CLI 或本地 API 执行

云端与本地、MCP 三条链路的关系如下图所示:

三种方式可以混用:同一个 PenEcho 实例里保存多个连接,随时在 API、CLI、云端模型之间切换。

五、进阶玩法:用 MCP 让任意 AI Agent 在你的画布上画

以上三种方式解决"画布内置 AI 用谁的脑子";而 MCP 解决的是反向问题——让 Codex、Claude Code、Kimi、Cursor 等任何 AI 客户端直接在 PenEcho 画布上创作。你继续在自己熟悉的 Agent 里对话,Agent 负责画图,你用手写笔标注反馈,它下一轮就能读到你的批注。

配置只需 3 步:

  1. 在 PenEcho 打开设置 → MCP 服务,为当前画布开启 MCP
  2. 对受支持的客户端点Auto configure,或把生成的配置提示词复制进你的 AI 客户端
  3. 对它说:"把刚才讨论的架构画到我的 PenEcho 画布上"

MCP 是可选能力:Agent 只能看到你主动开启的画布,Local MCP 完全留在你自己的电脑上。完整工具清单、会话绑定与安全细节见 MCP 设置指南。

六、3种 AI 接入方式怎么选?

接入方式需要密钥?费用最适合
API 密钥需要按服务商计费想自主控制模型、成本与端点
Codex / Claude / Kimi CLI不需要复用现有订阅已有 AI 订阅、不想重复付费
云端托管模型不需要账号积分零配置快速上手、跨设备

🎯选择建议:

  • 第一次使用 →云端模型,登录即画
  • 已有 ChatGPT / Claude / Kimi 订阅 →CLI 方式,一份订阅两处用
  • 想指定特定模型(如 DeepSeek、Kimi K3、GLM)→API 密钥,自由又便宜

更多细节可阅读 配置参考、架构说明 和 README。

小结

PenEcho 的"接入任意 AI"本质就是三条清晰的路线:自带 API 密钥换自由、复用 CLI 订阅省钱、云端模型零门槛。无论选哪条,你的手写、公式和图表都会落在同一块无限画布上——先挑最省事的方式跑起来,之后随时可以再加一条连接,多种模型在同一个 PenEcho 里自由切换。

【免费下载链接】penechoThink with AI beyond the chat box. A shared canvas for handwriting, equations, diagrams, and spatial reasoning.项目地址: https://gitcode.com/gh_mirrors/pe/penecho

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询