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,就能接入。
配置步骤:
- 在设置 → AI 与连接中新建一个 API 连接
- 选择服务商预设或直接填自定义端点
- 粘贴 API 密钥,手动输入模型 ID 或点击Load models从接口拉取模型列表
- 点击Test验证,通过后Save
PenEcho 内置了十几个常见服务商的预设,选好服务商即可自动带出地址:
| 预设服务 | 预设服务 |
|---|---|
| OpenRouter | DeepSeek |
| 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 就能调用。
配置步骤:
- 在连接管理器中选择 Codex CLI、Claude CLI 或 Kimi CLI
- 缺失 CLI 时,桌面端会显示一键官方安装器;不想用一键安装也可以手动执行官方安装脚本
- 完成登录(
codex login/claude auth login/kimi login) - 点击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 步:
- 在 PenEcho 打开设置 → MCP 服务,为当前画布开启 MCP
- 对受支持的客户端点Auto configure,或把生成的配置提示词复制进你的 AI 客户端
- 对它说:"把刚才讨论的架构画到我的 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),仅供参考