本地与 CLI 服务

Kapinote 支持直接调用 Mac 操作系统中已安装并运行的本地大模型服务或 CLI 命令行智能体。目前支持 Ollama 以及 Gemini CLI、Claude Code、GitHub Copilot CLI、OpenAI Codex CLI。

1. 本地 Ollama

本地 Ollama 不需要 API Key，但需要先在 Mac 上安装 Ollama、下载与统一内存匹配的模型，并保持 Ollama 服务运行。不同于下面的开发者 CLI 工具，Ollama 更适合作为没有云端账号或 API Key 用户的本地方案。

请按照独立的 Ollama 本地 AI 完整配置教程操作。教程包含：

• 完全新手也能跟随的安装步骤，模型可直接在 Kapinote 内下载
• M1 至 M5、8 GB 至 128 GB Mac 的 Qwen 模型推荐
• Kapinote 中每个字段的准确填写方式
• command not found、连接失败、模型不存在和内存不足等排查方法

2. CLI 命令行工具通用连接机制

连接 CLI 工具无需在 Kapinote 中输入任何 API Key，Kapinote 会通过后台非交互子进程（Non-interactive Subprocess）直接调用本机已通过认证的 CLI 命令：

1. 安装对应的官方命令行工具。
2. 在终端中完成该工具自有的登录认证流程（如 OAuth 或 Web 授权）。
3. 在终端中直接运行一次测试命令，确认已处于登录有效状态。
4. 打开 Kapinote 的 设置 → AI → CLI，选中对应工具并点击 验证。
5. 模型别名： 模型字段留空时将自动采用该 CLI 工具的默认模型；亦可按需指定该工具支持的模型别名（如 sonnet、opus、gemini-2.5-flash）。

环境变量注意： Kapinote 需在系统 PATH 中能定位到对应可执行文件。若安装后提示找不到命令，请彻底退出并重启 Kapinote。详见 故障排查。

3. 各 CLI 服务配置指引

Gemini CLI

• 参考官方 Gemini CLI 快速入门 与 登录认证指引。
• 在终端中执行 gemini --version 确认可用。调用额度与模型权限自动继承当前登录的 Google 账号。

Claude Code

• 参考 Anthropic 官方文档 Claude Code 入门指引 完成全局安装与认证。
• 确认终端执行 claude 正常响应。Model 字段可留空，或填入 sonnet、opus 等别名。

GitHub Copilot CLI

• 参考 GitHub Copilot CLI 安装指引。
• 安装命令：npm install -g @github/copilot。
• 运行 copilot login 完成 GitHub 身份授权。

OpenAI Codex CLI

• 运行 npm install --global @openai/codex 安装工具，并执行 codex login。
• 运行 codex login status 确认认证就绪。详见 Codex CLI 官方文档。

运行机制与隐私说明

• Ollama： 安装应用与下载模型需要联网；使用本地模型标签并连接 localhost 时，会议文本由 Mac 本地处理。详见 Ollama 隐私边界。
• CLI 智能体： CLI 命令在 Mac 本地触发执行，但 CLI 底层会按照该工具自身的云端协议将其发送至对应的服务商平台（如 Anthropic、Google、GitHub、OpenAI）。Kapinote 仅作为调度方，不会干涉亦不会拦截对应工具自有的计费与数据策略。