---
description: 在 macOS 或 Linux 上安装 YutoCode，并完成版本确认与更新。
---

# 安装

这页只覆盖普通用户最短安装路径，不要求你先理解源码结构。

## 适用系统

- `macOS arm64`
- `Linux x64`

## 安装最新版

```bash
curl -fsSL https://raw.githubusercontent.com/hkyutong/yuto-code-public/main/install.sh | bash
```

安装完成后，先确认是否成功：

```bash
yuto --version
```

如果终端能输出版本号，说明安装已经完成。

## 安装指定版本

```bash
curl -fsSL https://raw.githubusercontent.com/hkyutong/yuto-code-public/main/install.sh | bash -s -- --version <version>
```

当你需要和团队统一版本，或者回看某一版行为时，再使用指定版本安装。

## 更新

更新到最新公开版本：

```bash
yuto update
```

只检查是否有更新：

```bash
yuto update --check
```

安装指定公开版本：

```bash
yuto update <version>
```

## 安装后第一件事

安装完成后，不要急着直接开用。建议先做这三步：

1. 执行 `yuto --version`
2. 执行 `yuto doctor --json`
3. 按 [快速开始](/yutocode/getting-started) 完成 provider 登录

这样能更快定位环境问题，也能确保第一次使用时不会卡在认证阶段。

## 发布地址

- GitHub Releases：`https://github.com/hkyutong/yuto-code-public/releases`
- 每个公开版本都提供对应的校验文件

如果你的机器已经装过旧版，优先用 `yuto update` 升级，不建议手动覆盖文件。