本页内容

安装与配置

系统要求#

Kaya 分国内版与国际版，安装包都发布在 GitHub Releases，功能一致：国内版官网为 yunhouai.com，使用微信登录与微信支付；国际版官网为 yunhou.ai，使用 GitHub 登录与 Paddle 收银台（银行卡与 PayPal 钱包）。

从官网或 GitHub Release 下载 kaya-vX.Y.Z-macos-universal.dmg（国际版为 kaya-intl-vX.Y.Z-macos-universal.dmg）。
双击挂载 DMG。
把 kaya.app 拖入 /Applications。
从 Launchpad 或 /Applications 打开。

如果 macOS 提示无法验证应用，在 Finder 找到 /Applications/kaya.app，到系统设置的 隐私与安全性 中允许已确认的 Kaya，再重新打开。不要关闭 Gatekeeper，也不要执行来源不明的提权命令。

下载 kaya-vX.Y.Z-windows-x64.exe（国际版为 kaya-intl-vX.Y.Z-windows-x64.exe）；同版本也提供 .msi，任选一个。
运行安装向导并完成安装。
从开始菜单打开 Kaya。

官网只推荐官方安装包。命令行版本的预编译 release 暂停提供，需要 CLI 的高级用户参考独立 CLI 文档。

国内版在对话窗口点 微信扫码登录；国际版点 GitHub 登录。系统浏览器完成授权后自动跳回 Kaya，令牌写入系统钥匙串或 Windows 凭据管理器。无需自己申请模型 API Key；内置云模型需要有效订阅或试用，订阅 / 试用状态在 设置 → 账户 查看。

在顶栏模型切换器选择 我的模型。
打开 ⚙ 设置 → 模型 → + 添加供应商。
从 200+ 家供应商目录选择，或自定义 OpenAI 兼容端点；配置 API Key。Kimi Coding Plan 可使用 OAuth 设备码登录；“OpenAI ChatGPT 订阅（Codex）”有专用浏览器授权入口，仅供编程 Agent 经网关使用，不作为 Kaya 聊天模型。相关真实登录与刷新仍待真机验收。
一个供应商可带 对话 / Anthropic / OpenAI 三种端点和一份模型清单，同族多模型共用一份 key。
给编程 Agent 使用时，在 设置 → 网关 启用网关，然后到 设置 → 编程 Agent → Agent 详情 → 模型网关 选择默认模型并打开「经网关接入」。

配置保存在本机，当前凭据使用系统钥匙串与运行内存；旧配置与迁移备份可能保留历史敏感值，需单独检查。

真实终端可独立使用；AI 对话、Coding 模式和 IM 渠道需要登录。登录后，使用自备 API Key、Ollama 或适用的自有 OAuth 即可使用全部本地功能，无需有效订阅，订阅过期或取消不影响这些功能。

内置云模型及其辅助调用，以及经 yunhou 服务器中转的远程访问 / 跨机协同，仍需有效订阅或试用。第三方编程 Agent 和模型供应商的账户与费用单独管理。