藕片 API桌面端应用内配置
Claude Desktop 提供图形界面来设置第三方推理连接。藕片 API 用户可先完成本机 Connection 设置，再按需要处理模型、网络和部署选项。
进入配置窗口
在 macOS 菜单栏或 Windows 登录页左上角的 ☰ 应用菜单中进入 Help → Troubleshooting → Enable Developer Mode，随后选择 Developer → Configure Third-Party Inference…。
如果应用配置后菜单发生变化，可再次启用开发者模式；在第三方模式下再次启用后会跨重启保留。组织设置 developerModeEnabled: false 会隐藏启用入口与 Developer 菜单，受管理设备应由对应管理员调整。
先完成 Connection
Connection 决定客户端访问哪一个推理服务。使用 藕片 API 时，准备以下信息：
- 供应商类型：Gateway。
- Credential kind：Static API key。
- 网关地址：
https://eopt.ai。 - 网关凭据：藕片 API 控制台生成的 API Key。
- 模型：控制台当前开放的模型名称。
窗口会根据供应商类型显示相关字段。藕片 API 教程使用默认的 bearer 认证；填完后点击 Test connection 检查连接。
通过设置搜索查找 Model list（模型列表），填写控制台当前开放的完整模型 ID。导出的 inferenceModels 列表第一项为默认模型；模型发现接口属于网关可选能力，列表为空时请先补齐显式模型配置。填写顺序见桌面版接入。
完整的本机接入步骤见Claude Code 桌面版接入。修改终端的 settings.json 不会替代桌面端的 Connection 配置。
在本机应用配置
Apply Changes 用于将配置写入当前设备，并重新启动进入该配置。旧版界面可能显示 Apply locally。应用后先建立一个新会话，检查所选供应商与模型是否符合预期。
如果只是在自己的电脑上使用 藕片 API，从本机应用流程开始即可。将配置保存到本机与导出给其他设备是两种不同操作。
导出与批量部署
Export 提供面向不同管理方式的产物。选择格式前，先确认部署工具需要哪一种文件。
| 导出格式 | 适用的管理方式 |
|---|---|
.mobileconfig | macOS MDM 配置描述文件 |
.reg | Windows 注册表或设备管理 |
ADMX .zip | Windows 管理策略模板 |
Profile Manifest .plist | macOS 配置工具的模板描述 |
| JSON | 引导配置服务或无 MDM 设备的配置文件 |
| Egress allowlist | 对照网络放行要求 |
模板文件不一定包含全部实际值，需按部署工具的要求填写。导出内容可能带有连接凭据，应按团队既有的凭据分发方式管理。
设置只读时怎么办
设备上已有管理配置时，窗口可能以只读方式展示已经下发的值。先确认当前配置由谁管理，再到相应的管理端修改；准备新配置时可使用没有该管理配置的测试设备。
如果只是菜单暂时不见了，先重新检查 Developer Mode。不要把“入口不可见”和“组织策略只读”当作同一种问题。
验证与后续排查
应用后在新会话中测试一次简单对话，核对 藕片 API 使用日志。失败时记录 Connection 检查结果、客户端版本和错误地址。
401 可继续查看供应商与错误端点排查；网络、模型或中断问题见报错与踩坑。