CloseChatCloseChat

快速开始

欢迎使用 CloseChat！本文档将帮助你在 5 分钟内完成安装并开始第一次对话。

系统要求

桌面端

  • Windows 10/11（64 位）
  • macOS 12.0 或更高版本
  • Ubuntu 20.04 / Debian 11 或同等 Linux 发行版

移动端

  • iOS 16.0 或更高版本
  • Android 10 或更高版本

下载与安装

Windows

  1. 从下载页面下载 .exe 安装包
  2. 双击运行时若出现蓝色「Windows 已保护你的电脑」拦截窗（SmartScreen 基于信誉累积机制，对新发布的软件默认提示「发布者未知」，属正常现象，软件本身无问题），点击「更多信息」→「仍要运行」即可继续
  3. 按提示完成安装，在开始菜单找到 CloseChat 并启动

macOS

  1. 下载对应架构的 .dmg 文件（Apple Silicon 或 Intel）

  2. 打开 dmg，将 CloseChat 拖入 Applications 文件夹

  3. 首次启动大概率提示「已损坏，无法打开。你应该将它移到废纸篓」（因开发者证书申请中，属正常现象，软件本身无问题），请不要移到废纸篓，打开「终端」执行以下命令后重新打开即可：

    xattr -r -d com.apple.quarantine /Applications/CloseChat.app

  4. 若提示「Apple 无法验证是否包含恶意软件」，在「系统设置 → 隐私与安全性」中点击「仍要打开」允许运行

Linux

  1. 下载 .AppImage 文件

  2. 赋予执行权限后运行：

    chmod +x CloseChat.AppImage
./CloseChat.AppImage

配置第一个 AI 供应商

安装完成后，你需要配置至少一个 AI 供应商才能开始对话。

使用内置供应商

CloseChat 已预置 OpenAI、Anthropic、Google、DeepSeek、智谱、月之暗面、MiniMax、通义千问等主流供应商：

  1. 打开 设置 → 模型供应商，在列表中选中供应商
  2. 填入你的 API Key（API 地址保持默认即官方接口）
  3. 点击「检测」验证连通性
  4. 回到对话界面选择对应模型，开始对话

接入第三方中转 / 代理

使用第三方 API 中转站时，有两种方式：

  • 修改内置供应商：直接把对应供应商的「API 地址」改为中转站地址
  • 新建自定义供应商：点击供应商列表底部的「添加」，填写名称并选择协议——中转站大多兼容 OpenAI 格式，选 OpenAI Compatible 即可；然后填入 API Key 与 API 地址，并在模型列表中「获取」或手动添加模型

关于 API 地址：填到根路径即可（如 https://api.example.com），CloseChat 会自动补全 /v1，输入框下方会实时预览最终的请求地址；已带版本段（/v1、/v1beta 等）的地址不会重复补全；个别特殊网关不需要补全时，在地址末尾加 # 即可按原样使用。

配置完成后若报错：401 多为 API Key 错误；404 多为 API 地址或协议不对，可对照预览地址排查。

开启 AI 画图（可选）

配置好 API Key 后即可启用对话内 AI 画图，支持多轮编辑、多图融合、角色一致等。画图默认不会自动开启，需要简单配置一次：

  1. 确认已在 设置 → 模型供应商 中配置好 OpenAI 或 Google Gemini 的 API Key
  2. 打开 设置 → 增强功能 → 图像生成，选择供应商与模型（首次进入没有预选模型，需手动选择一个）
  3. 回到对话，在输入框勾选「图像生成」即可开始画图

关于模型选择：推荐优先使用 Google 的 Nano Banana 2，又快又便宜。OpenAI 的 gpt-image-2 也很好，但出图较慢，单张等待几分钟、甚至 4～5 分钟都属正常现象，并不是软件或网络卡死，请耐心等待；若等待过长也可能是网络超时，此时建议改用 Nano Banana 2。

配置云同步（可选）

CloseChat 支持通过自定义对象存储（S3 / OSS / R2 等）在多端同步数据：

  1. 进入 设置 → 云同步
  2. 填写你的对象存储配置（Endpoint、Bucket、Access Key、Secret Key）
  3. 点击「测试连接」确认配置正确
  4. 开启「自动同步」

所有同步数据均加密存储在你自己的存储桶中，CloseChat 不经手任何用户数据。

下一步