企业官网建设流程全解析

如何在PI-Desktop中接入你的第一个模型：OpenAI与Anthropic API Key完整配置教程

【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop

PI-Desktop 是一款本地优先（Local-first）的 AI 编码智能体桌面应用，支持 macOS、Windows 和 Linux。本教程将带你用 5 分钟完成第一步：在 PI-Desktop 中配置 OpenAI 或 Anthropic 的 API Key，接入你的第一个大模型，并开始第一次智能体编码会话。无需注册 PI-Desktop 账号，模型请求会直接发往你配置的提供商端点，API Key 安全保存在操作系统钥匙串中。

准备工作：你需要什么 🧰

在开始之前，只需准备两样东西：

💡 提示：PI-Desktop 是本地优先架构，API 凭证通过 Rust Host Core 存入系统密钥存储，配置文件里只保留引用指针，明文密钥不会出现在日志或导出内容中。密钥存储机制详见 014-secrets-storage。

第一步：打开「模型配置」页面 📂

启动 PI-Desktop 后，进入Settings（设置）→ Model configuration（模型配置）。

如果你是全新安装，这一页会显示空状态——这正是添加第一个 AI 服务的入口。点击「添加 AI 服务」（Add AI service）按钮，会弹出统一的服务配置对话框。该对话框的核心实现位于 ProviderSetupDialog.tsx，整个页面由 ModelConfigPage.tsx 承载。

第二步：选择 OpenAI 或 Anthropic 并粘贴 API Key 🔑

添加服务对话框刻意把常见路径简化为「选服务 + 粘贴密钥」两步（这一交互设计见 ADR 0156）：

1. 选择服务（Service）：在预设列表中直接选择OpenAI或Anthropic。
2. 粘贴 API Key：端点的 Base URL 和 API 协议格式都会自动填好，你唯一需要做的就是粘贴密钥。
3. 如果你需要接入其他网关（如 DeepSeek、OpenRouter 或本地 Ollama），选择「自定义端点」后填入名称、Base URL 和 API Key 即可，自定义端点同样走 OpenAI 兼容协议。

各内置服务的端点与协议格式定义在 provider-presets.ts 中，例如：

粘贴密钥后，PI-Desktop 会自动向该端点发起模型发现请求，拉取该账户下可用的模型列表——无需手动填写模型 ID。

第三步：选择要启用的模型 🤖

模型列表加载后，勾选你要使用的模型。每个被选中的模型都会保存一份独立的「模型绑定」，包括：

• 上下文窗口（Context Window）：模型可处理的最大上下文长度
• 输出上限（Max Tokens）：单次回复的最大 token 数
• 思考等级（Thinking Level）：推理模型的思考强度档位，非推理模型会自动置空

模型元数据（名称、能力、限额、思考等级）来自内置的 models.dev 模型目录，无需手动维护。完整的提供商与模型体系设计可查看 11-provider-model-system。

第四步：测试连接并保存 ✅

点击对话框中的测试连接（Test connection），PI-Desktop 会立即验证密钥有效性并返回结构化的成功/失败结果：

测试通过后点击保存，服务即刻生效。

开始你的第一次智能体会话 🚀

配置完成后，回到主界面：

1. 在侧边栏打开（或新建）一个本地项目；
2. 在底部 Composer 输入框中，点击模型选择器，选择刚配置的 OpenAI 或 Anthropic 模型——会话无需重建即可随时切换模型；
3. 选择Agent / Plan / Goal三种工作模式之一，输入第一条指令，例如"为这个项目写一个健康检查接口"。

Agent 会读取代码、编辑文件并运行命令，所有特权操作都会经过 PI-Desktop 的权限层等待你的批准。多轮对话、@引用文件、/斜杠命令都可以直接使用。

常见问题速查 🛠️

• 密钥保存到哪里？操作系统钥匙串（Keychain/Secret Store），应用导出设置永远不会包含明文密钥。
• 一个厂商可以用多个账号吗？可以。多个相同厂商的提供商行相互独立，各自持有独立凭证。
• 想用 Claude Pro / ChatGPT 订阅登录？支持的供应商可在同一页面走 OAuth 账号登录流程，无需粘贴 API Key。
• 本地模型能用吗？可以，通过 OpenAI 兼容端点接入 Ollama、LM Studio 等本地网关。

相关文件索引 📚

• 服务配置对话框：ProviderSetupDialog.tsx
• 内置服务预设：provider-presets.ts
• 模型配置页面：ModelConfigPage.tsx
• 提供商与模型体系规范：11-provider-model-system.md
• 精简添加服务流程的决策记录：ADR 0156

完成以上四步，你的第一个模型就已经接入 PI-Desktop 了。接下来不妨打开一个真实项目，让智能体完成它的第一个代码补丁——模型是可替换的零件，而工作流始终掌握在你手里。

【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop