macai

macai (macOS AI) 是一个简单却功能强大的原生 macOS AI 聊天客户端，支持大多数 AI 提供商：ChatGPT, Claude, xAI (Grok), Google Gemini, Perplexity, Ollama, OpenRouter，以及几乎所有兼容 OpenAI 的 API。

目录

• 下载
  • 手动
  • Homebrew
• 贡献
• 为什么选择 macai
• 使用 ChatGPT, Claude, xAI 或 Google Gemini 运行
• 使用 Ollama 运行
• 系统要求
• 项目状态
• 从源码构建
• iCloud 同步配置
• 许可协议

下载

手动

下载 最新的通用二进制文件，已通过 Apple 公证。

Homebrew

使用 homebrew 安装 macai cask： brew install --cask macai

贡献

欢迎贡献。在创建新问题之前，请先查看 Issues 页面 以了解已添加的功能/修复的漏洞。 您也可以通过资助来支持该项目。这种支持对我非常重要，使我能够更专注于 macai 的开发。

为什么选择 macai

• macOS 原生且轻量级
• 用户友好：设置简单，极简主义浅色/深色 UI
• 功能丰富：视觉、图像生成、搜索、推理、导入/导出等
• iCloud 同步：跨设备保持聊天记录、消息和设置同步
• 私密安全：macai 无遥测或使用跟踪（注意：启用 iCloud 同步时，Apple 可能会收集匿名遥测数据）

使用 ChatGPT, Claude, xAI 或 Google Gemini 运行

要使用 ChatGPT 或 Claude 运行 macai，您需要拥有 API 令牌。API 令牌类似于密码。您需要先获取 API 令牌才能使用任何商业大语言模型 (LLM) API。大多数 API 服务在新账户注册时会提供免费额度，因此您可以免费试用大部分服务。 以下是获取所有支持服务的 API 令牌的方法：

• OpenAI: https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key
• Claude: https://docs.anthropic.com/en/api/getting-started
• Google Gemini: https://ai.google.dev/gemini-api/docs/api-key
• xAI Grok: https://docs.x.ai/docs#models
• OpenRouter: https://openrouter.ai/docs/api-reference/authentication#using-an-api-key

如果您是 LLM 新手且不想为令牌付费，请查看 Ollama。它支持数十种可以在 Apple M1/M2/M3/M4 Mac 上本地运行的开源大语言模型。

使用 Ollama 运行

Ollama 是各种 LLM 模型的开源后端。 使用 Ollama 运行 macai 很简单：

1. 从 官方网站 安装 Ollama

2. 遵循安装指南

3. 安装完成后，选择模型（推荐 llama3.1 或 llama3.2），并在终端中使用命令拉取模型：ollama pull <model>

4. 在 macai 设置中，打开 API 服务标签页，添加新的 API 服务（专家模式）并选择类型为 Ollama：

   

5. 选择模型，默认 AI 助手并保存

6. 测试并享受！

系统要求

macOS 14.0 及更高版本（支持 Intel 和 Apple 芯片）

项目状态

项目处于积极开发阶段。

从源码构建

选项 1：拥有 Apple 开发者账号（完整功能）

如果您拥有 Apple 开发者账号并希望构建支持 iCloud 同步的版本：

1. 克隆仓库：git clone https://github.com/Renset/macai.git
2. 在 Xcode 中打开 macai.xcodeproj
3. 在 Signing & Capabilities 中选择您的团队
4. (可选) 要在 Debug 构建中启用 iCloud 同步，请从 Build Settings → Swift Compiler → Active Compilation Conditions 中移除 DISABLE_ICLOUD
5. 构建并运行

注意： 默认情况下，Debug 构建通过 DISABLE_ICLOUD 标志禁用 iCloud 同步，以简化贡献者设置。Release 构建则启用 iCloud 同步。

选项 2：没有 Apple 开发者账号（无 iCloud 同步）

如果您没有 Apple 开发者账号，您仍然可以构建并运行应用，但无法使用 iCloud 同步：

使用 Xcode：

1. 克隆仓库：git clone https://github.com/Renset/macai.git
2. 在 Xcode 中打开 macai.xcodeproj
3. 选择 macai 目标 → Build Settings 标签页
4. 搜索 CODE_SIGN_ENTITLEMENTS
5. 将值从 macai/macai.entitlements 更改为 macai/macai-no-icloud.entitlements
6. 在 Signing & Capabilities 中，将"Signing Certificate"设置为"Sign to Run Locally"
7. 构建并运行

使用命令行：

git clone https://github.com/Renset/macai.git
cd macai
xcodebuild -scheme macai \
  -configuration Debug \
  CODE_SIGN_IDENTITY="-" \
  CODE_SIGN_ENTITLEMENTS="macai/macai-no-icloud.entitlements" \
  DEVELOPMENT_TEAM="" \
  CODE_SIGNING_ALLOWED=NO \
  build

注意： 未包含 iCloud 权限设置的应用程序将正常工作，但 iCloud 同步功能将不可用。所有其他功能（聊天、API 服务、角色设定等）将按预期工作。

iCloud 同步配置

针对贡献者（调试构建）

在调试构建中，iCloud 同步（iCloud Sync）默认通过 DISABLE_ICLOUD 编译器标志被禁用。这简化了开发环境设置，并避免了没有 Apple Developer 账户的贡献者遇到的 CloudKit 相关签名问题。

要在调试构建中启用 iCloud 同步：

1. 选择 macai 目标 → 构建设置标签页
2. 搜索 SWIFT_ACTIVE_COMPILATION_CONDITIONS（或“活动编译条件”）
3. 从值中移除 DISABLE_ICLOUD（仅保留 DEBUG）
4. 确保已正确配置 Entitlements（权限）和签名（见下文）

针对分叉版本 / 自定义构建

如果你想在分叉版本或自定义构建中使用 iCloud 同步，必须使用你自己的 CloudKit 容器：

1. 在你的 Apple Developer 账户中创建一个 CloudKit 容器
2. 在 Xcode 中为 macai 目标启用 iCloud 功能，并添加你的容器
3. 将 macai/Info.plist 中的 CloudKitContainerIdentifier 值更新为你的容器 ID
4. 确保应用的 Bundle Identifier（包标识符）与你为容器注册的标识符匹配
5. 如果存在，从活动编译条件中移除 DISABLE_ICLOUD

如果缺少 CloudKitContainerIdentifier，应用将回退到默认容器。

许可证

Apache-2.0

macai 快速上手指南

macai 是一款原生 macOS AI 聊天客户端，支持 ChatGPT、Claude、Ollama 等多种主流 AI 服务。界面简洁，支持 iCloud 同步，适用于本地及云端大模型交互。

1. 环境准备

• 操作系统：macOS 14.0 或更高版本（支持 Intel 芯片及 Apple Silicon M1/M2/M3/M4）。
• 前置依赖：
  • 使用 Homebrew 安装需确保已配置 Homebrew。
  • 若从源码构建，需安装 Xcode 及 Git。

2. 安装步骤

推荐使用以下方式之一进行安装：

方式一：Homebrew 安装（推荐）

在终端中执行以下命令：

brew install --cask macai

方式二：手动下载

访问 GitHub Releases 页面下载最新通用二进制文件（Universal Binary），该版本已通过 Apple 公证： https://github.com/Renset/macai/releases

注意：如需从源码构建以启用 iCloud 同步功能，请参考项目文档中的 Build from source 章节。

3. 基本使用

macai 支持连接商业 API 或本地部署的开源模型。

使用商业 API (ChatGPT, Claude, Gemini 等)

1. 获取对应服务的 API Token（类似密码）。
   • OpenAI: 帮助文档
   • Claude: 文档
   • Google Gemini: 文档
   • xAI Grok: 文档
   • OpenRouter: 文档
2. 打开 macai，进入设置添加新的 API Service，输入 Token 即可开始对话。

使用本地模型 (Ollama)

适合不想付费或希望数据完全本地的用户。

1. 安装 Ollama：前往官网下载安装 ollama.com。
2. 拉取模型：在终端运行以下命令（推荐 llama3.1 或 llama3.2）：

   ollama pull <model>
   

3. 配置 macai：
   • 打开 macai 设置，进入 API Service 标签页。
   • 选择 Expert mode，添加新服务并选择类型为 Ollama。
   • 选择刚才拉取的模型，保存后测试连接即可使用。