文档 / 入门
连接 AI
选择你已付费的订阅，或使用你自己的 API key。IDE 及其规则完全相同。
Yuli 有两种 AI 模式。唯一的区别是由谁推理；IDE、面板和规则完全相同。
| 订阅模式 | Platform 模式 | |
|---|---|---|
| 由谁推理 | 你自己的 Claude Code、Kiro、Codex 或 Antigravity | Yuli 引擎（Yuli Platform） |
| 由谁付费 | 你现有的订阅 | 你所选提供商的 API key |
| 如何使用 IDE | 通过 MCP 调用 yuli_* 工具 |
内部工具 |
| 规则 | 由 Yuli 为每个智能体生成，并配合 hooks | 引擎的提示词与防护机制 |
新安装的 IDE 默认处于 订阅模式。
选择与谁协作
聊天上方只有一个选择器：你和谁一起工作？
| 分组 | 选项 |
|---|---|
| 你的订阅 · 你的账户 | Claude Code、Kiro、Codex、Antigravity |
| 使用你的 API 密钥 | Yuli Platform |
每个智能体都保留自己的会话。如果某个智能体正在工作，切换会等它完成后再进行。
你也可以在 全局选项 → AI 和模型 → AI 模式 中选择：
- Platform 模式 或 订阅模式。
- 智能体：Claude Code、Kiro、Codex 或 Antigravity。
- 仅为此项目选择模式：启用后，选择仅对当前打开的项目生效；否则作为所有项目的默认值。
使用你的订阅
| 智能体 | 你的账户 | 指南 |
|---|---|---|
| Claude Code | Claude（Pro、Max 或 Console） | Claude Code |
| Kiro | AWS Builder ID、Google 或 GitHub | Kiro、Codex 与 Antigravity |
| Codex | ChatGPT | Kiro、Codex 与 Antigravity |
| Antigravity | Kiro、Codex 与 Antigravity |
通用步骤：
- 使用官方安装程序安装智能体。Yuli 会自动检测；它从不下载或再分发智能体。
- 阅读初始提示后继续。
- 通过智能体的官方流程，由你自己登录。
- 输入你的需求。
默认情况下，Yuli 不会在你的项目中写入任何内容：其配置会在启动智能体时直接传递给它。
在此模式下，Yuli 从不接触你的凭据，也不使用 API key。智能体读取的内容会以你的账户发送至其提供商，与在 Yuli 之外使用时完全相同。
使用你的 API key
- 打开模型配置：聊天标题栏 → 更多操作 → 模型设置。
- 选择提供商：Anthropic、OpenAI、Gemini、xAI、DeepSeek、Local、AWS Bedrock 或 Vertex AI。
- 输入你的 API key 和模型。
- 点击 测试连接，然后点击 保存设置。
密钥保存在系统密钥链中，并且始终以掩码形式显示。详见模型与提供商。
无法连接云端？使用 Local 搭配 Ollama、LM Studio、vLLM 或 llama.cpp：上下文不会离开你的网络。
两种模式的差异
| 功能 | 订阅 | Platform |
|---|---|---|
| 更改窗口与撤销 | 是 | 是 |
| 任务、阶段与度量 | 是 | 是 |
| 仅在你要求时使用 Git | 是 | 是 |
| 机密保护 | 是 | 是 |
| 无人值守模式 | 否：任务均为交互式 | 是 |
| 智能体团队 | 通过 yuli_team_* 启动，使用 Platform 的提供商 |
是 |
| 用量指示 | 套餐用量（5 小时与每周） | 令牌与成本 |
责任声明
Claude Code 是 Anthropic 的产品，Kiro 属于 Amazon Web Services，Codex 属于 OpenAI，Antigravity 属于 Google。Yuli 与上述任何一方均无关联，也未获得其背书。每位用户均依据其提供商的条款使用自己的账户。