快速开始
首次配置#
方式 A：内置模型 + 微信登录（默认，免 API Key）#
在对话窗口点 微信扫码登录，或打开 ⚙ 设置 → 账户。
系统浏览器打开微信扫码页，扫码后自动跳回 Kaya；令牌写入系统钥匙串或 Windows 凭据管理器。
回到对话窗口即可提问。订阅 / 试用状态在 设置 → 账户 查看。
顶栏「内置模型」可展开服务端模型目录：默认「跟随默认」，也可以选具体模型；目录不可用时退回静态条目。
国际版使用 GitHub 登录，支付走 Paddle 收银台（银行卡与 PayPal 钱包），其余流程一致。
方式 B：自备模型（BYOK）#
点顶栏模型切换器，切到 我的模型。
打开 ⚙ 设置 → 模型 → + 添加供应商：
从 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 和模型供应商的账户与费用单独管理。
让 AI 大脑理解当前终端#
在终端进入你的项目，运行熟悉的命令、脚本或编程 Agent。遇到报错、看不懂的命令或需要讨论的方案时，直接在旁边的对话里提问：
text
解释当前终端的报错，先告诉我原因和可选的解决步骤。按 Enter 发送，你会看到：
当前模型支持并启用思考时，出现可折叠的思考区。
工具卡片展示工具名、参数、运行状态与输出。
AI 把结果整理成自然语言回答。
可以继续追问：“这个命令会做什么？”“Agent 提出的方案有哪些取舍？”“总结目前的进展和下一步。”AI 默认读取终端输出；在普通 shell 中执行命令仍由你决定。如果 AI 卡住，按 Esc 或点 ⏹ 中断后换个问法。
同时跟进多个 Agent#
在 设置 → 编程 Agent 安装、配置 Claude Code、Codex、OpenCode 或 Kimi Code，按需要绑定模型。在不同标签页进入各自项目，让不同 Agent 并行处理任务。
开启 Coding 模式后，可以通过 Agent 列表查看谁在运行、谁在等待你的确认，以及谁已结束当前工作。点卡片切到对应标签页并绑定当前对话，结合实际终端输出询问进展。
如果希望 Kaya 代为向受支持的 Agent 输入指令，需要 Coding 模式 + 该标签页的明确授权；Coding 模式与逐标签页授权共同控制终端写入。登录后，Coding 模式使用你自己的模型即可工作，无需 Kaya 订阅；使用内置模型仍需有效试用或付费权益。直接在终端运行外部 Agent 的账户和权限由对应 Agent 管理。详见编程 Agent 管理。
完成第一次跨项目交接#
先在不同标签页准备好目标 Agent，然后在对话中说明共享需求和各自分工，例如：
汇总后端已完成的登录接口约定，交给前端 Agent 读取并完成接入。保留接口约定、已完成内容和待办，完成后汇报结果。
确认目标与内容后，由 Kaya 协助交接需求和上下文。目标 Agent 检查自己的项目并继续推进，你可以查看任务进展、终端输出与下一步。操作权限和关键决策仍由你掌握。详见任务交接与 ToDoList。
查看模型请求的保护结果#
需要保护编程 Agent 的模型请求时，按前面的模型配置流程启用网关并明确接入 Agent。Kaya 在请求发出前检查内容，按所选策略拦截或脱敏，并在 设置 → 网关 → 隐私保护统计 中展示保护结果。网关默认关闭，保护范围取决于接入请求和所选策略。详见模型网关。
把 Kaya 用作日常终端#
继续运行命令、脚本和命令行工具，使用熟悉的 Shell 与开发环境。Mac 上用 ⌘T 新建标签页、⌘数字 切换标签页、⌘D 左右分屏、⌘⇧D 上下分屏；⌘C / ⌘V 复制粘贴，Ctrl 字母键继续传给终端工具。Windows 的对应快捷键在设置中查看。详见终端与标签页。
粘贴图片#
在对话输入框按 ⌘V（Windows：Ctrl+V）粘贴图片：
自动剥除 EXIF / GPS，长边过大自动降采样。
每条消息最多 4 张，每张不超过 5MB，支持 png / jpeg / webp / gif。
BYOK 且模型支持图片时才随消息发出；内置模型暂不支持看图。
图片本身为内存态，不落盘、不进入审计正文，只记 mime 与字节数。
「发送给 Agent」会把图片以 0o600 暂存到
~/.kaya/tmp-images/，并把绝对路径交给终端中的 Agent；Agent 自己也需要支持读图。图片不跨会话保留，新对话中的旧图片显示「已随会话清除」。
使用技巧#
空对话显示欢迎卡片，有消息后在输入框上方显示单行提示，每 5 分钟轮换；已用过的功能自动降低优先级。可以点「换一条」或永久关闭「不再提示」。