Skip to content

OpenCat 集成教程 ​

OpenCat 是 Mac 平台上的原生 AI 助手应用,提供流畅的 macOS 原生体验。本文介绍如何配置 OpenCat 使用玄州API。

配置步骤 ​

1. 下载安装 ​

从 OpenCat 官网 或 Mac App Store 下载安装 OpenCat。

2. 打开设置 ​

启动 OpenCat,点击菜单栏图标 →「Preferences」(偏好设置),或使用快捷键 Cmd + ,。

3. 配置 API ​

在设置界面:

  1. 选择「API」选项卡
  2. Provider:选择「OpenAI Compatible」
  3. Base URL:填入 https://xuanzhouapi.top/v1
  4. API Key:填入你的玄州API Key(sk-xxxxxxxxxxxxxxxxxxxxxxxx)

4. 添加模型 ​

在模型列表中添加你想使用的模型名称:

  • gpt-5.5
  • claude-sonnet-4-6
  • deepseek-v4-pro
  • gemini-3.5-flash

5. 开始使用 ​

配置保存后,返回主界面,选择模型即可开始对话。

OpenCat 特色功能 ​

  • 菜单栏快捷访问:在菜单栏快速调起 OpenCat
  • 内联补全:在任意文本框中调用 AI 补全
  • 快捷键:支持全局快捷键快速呼出
  • Prompt 模板:预设常用提示词模板

推荐配置 ​

场景推荐模型
日常办公claude-sonnet-4-6
代码编程gpt-5.5 或 deepseek-v4-pro
翻译写作gemini-3.5-flash 或 glm-5.1

常见问题 ​

1. 连接超时 ​

  • 确认 Base URL 格式正确:https://xuanzhouapi.top/v1
  • 检查 Mac 系统代理和网络设置
  • 在控制台日志中确认是否有请求记录

2. 模型报错 404 ​

  • 确认模型名称与「模型广场」中的完全一致
  • 检查该模型是否在你的 API Key 分组中可用

玄州API — 企业级大模型 API 聚合平台