文档 / 入门
安装 Yuli
免费下载适用于 64 位 Windows、macOS 或 Linux 的 IDE，并首次启动。
Yuli 安装在你的电脑上并在本地运行：只有你选择的 AI 会访问互联网。它免费，且无需注册账户。
Yuli 目前处于测试版阶段。如果遇到问题，请使用 帮助 → 报告问题… 并在 GitHub 上分享：每一份报告都能帮助我们完善它。
系统要求
| 要求 | 说明 |
|---|---|
| 操作系统 | Windows、macOS 或 Linux，64 位。 |
| JVM 项目 | Java、Maven、Gradle 或 Ant。Yuli 会自动检测，并提供下载缺失组件。 |
仅部分工具需要
如果缺少某项依赖，Yuli 会提示并说明如何安装。
| 用途 | 所需组件 |
|---|---|
| Oracle | Oracle Instant Client 19c 或更高版本。SQL Server、MySQL、MariaDB、MongoDB 和 SQLite 无需额外组件。 |
| 容器 | Docker；如需 Kubernetes，还需配置好上下文的 kubectl。 |
| 通过 SSH 远程开发 | OpenSSH 客户端。 |
| 订阅模式 | 由你自行安装的 Claude Code、Kiro CLI、Codex CLI 或 Antigravity ACP 服务器。 |
下载
本页的按钮会检测你的系统并引导你下载最新发布版本。你也可以选择其他格式。
| 系统 | 格式 |
|---|---|
| Windows x64 | 安装程序 .exe、.zip 和便携版 Yuli-Code-Portable-<versión>-x64.exe。 |
| macOS | .dmg 和 .zip。 |
| Linux x64 | .AppImage 和 .deb。 |
安装
Windows
- **安装程序：**运行
.exe。你可以选择安装目录；安装程序会在桌面和开始菜单创建快捷方式。 - **便携版：**在任意位置运行
Yuli-Code-Portable-<versión>-x64.exe，无需安装。首次运行时会将应用解压到本地文件夹，之后即可秒开。 - **Zip：**解压到任意文件夹，然后从该位置运行 Yuli。
便携版不会自动更新。如需自动更新，请使用安装程序。
macOS
打开 .dmg，将 Yuli 拖入“应用程序”文件夹。
Linux
- **AppImage：**为文件添加执行权限（对文件执行
chmod +x），然后打开。 - **Debian 和 Ubuntu：**使用包管理器安装
.deb（sudo apt install ./archivo.deb）。
首次启动
- **欢迎。**会出现 “欢迎使用 Yuli Code”，介绍 IDE 的核心内容。
- **语言。**如果系统语言可用，Yuli 会使用系统语言；否则使用英语。你可以随时更改。参见语言。
- **你想如何连接 AI？**选择 使用你的订阅（Claude Code、Kiro、Codex 或 Antigravity；默认选项）或 使用你的 API 密钥。你也可以选择 跳过，稍后再决定。
- **主页。**未打开任何内容时，编辑器提供四条路径：向 AI 提需求、打开文件、设计一个界面 和 运行与测试。
如需再次查看欢迎页，请使用 帮助 → 初始设置…。如需七个步骤的引导式导览，请使用 帮助 → 导览和初始设置…。
项目信任
首次打开项目时，Yuli 会询问 “你信任此项目吗？”：
- 信任：运行项目的注解处理器（Lombok）和 Maven/Gradle，以进行完整分析。
- 受限模式：不运行仓库中的任何代码。
请只对你了解的项目选择 信任。你可以在 全局选项 → 安全 中更改。参见沙箱与权限。
更新
安装版会在启动时检查更新、下载更新，并在关闭时应用。每次下载都会通过签名和 SHA-512 校验和进行验证。在 帮助 → 检查更新… 中配置更新通道（稳定版或测试版）和自动检查。
卸载
- **Windows：**在“设置 → 应用”中卸载，或删除便携版或 zip 版所在的文件夹。
- **macOS：**将 Yuli 从“应用程序”拖到废纸篓。
- **Linux：**删除 AppImage 或卸载软件包。
你的设置保存在用户目录下的 .yulicode 文件夹中；如需从头开始，删除该文件夹即可。