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

如何在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-DesktopPI-Desktop 是一款本地优先Local-first的 AI 编码智能体桌面应用支持 macOS、Windows 和 Linux。本教程将带你用 5 分钟完成第一步在 PI-Desktop 中配置 OpenAI 或 Anthropic 的 API Key接入你的第一个大模型并开始第一次智能体编码会话。无需注册 PI-Desktop 账号模型请求会直接发往你配置的提供商端点API Key 安全保存在操作系统钥匙串中。准备工作你需要什么 在开始之前只需准备两样东西准备项说明API Key从 OpenAI 或 Anthropic 官方平台获取的 API 密钥二选一即可PI-Desktop 安装包从发行版下载对应平台的安装包macOS.dmg、Windows 安装程序、Linux.AppImage等 提示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选择服务Service在预设列表中直接选择OpenAI或Anthropic。粘贴 API Key端点的 Base URL 和 API 协议格式都会自动填好你唯一需要做的就是粘贴密钥。如果你需要接入其他网关如 DeepSeek、OpenRouter 或本地 Ollama选择「自定义端点」后填入名称、Base URL 和 API Key 即可自定义端点同样走 OpenAI 兼容协议。各内置服务的端点与协议格式定义在 provider-presets.ts 中例如服务自动填充的 Base URL协议格式OpenAIhttps://api.openai.com/v1ResponsesAnthropichttps://api.anthropic.comAnthropic MessagesDeepSeekhttps://api.deepseek.comChat Completions粘贴密钥后PI-Desktop 会自动向该端点发起模型发现请求拉取该账户下可用的模型列表——无需手动填写模型 ID。第三步选择要启用的模型 模型列表加载后勾选你要使用的模型。每个被选中的模型都会保存一份独立的「模型绑定」包括上下文窗口Context Window模型可处理的最大上下文长度输出上限Max Tokens单次回复的最大 token 数思考等级Thinking Level推理模型的思考强度档位非推理模型会自动置空模型元数据名称、能力、限额、思考等级来自内置的 models.dev 模型目录无需手动维护。完整的提供商与模型体系设计可查看 11-provider-model-system。第四步测试连接并保存 ✅点击对话框中的测试连接Test connectionPI-Desktop 会立即验证密钥有效性并返回结构化的成功/失败结果测试结果含义解决办法✅ 成功密钥有效模型列表可访问直接保存PROVIDER_UNAUTHORIZED密钥无效或已过期重新到官方平台生成 API KeyPROVIDER_RATE_LIMITED触发 429 限流稍后重试NETWORK_ERROR端点不可达检查网络与代理设置测试通过后点击保存服务即刻生效。开始你的第一次智能体会话 配置完成后回到主界面在侧边栏打开或新建一个本地项目在底部 Composer 输入框中点击模型选择器选择刚配置的 OpenAI 或 Anthropic 模型——会话无需重建即可随时切换模型选择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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考