---
description: Install YutoCode on macOS or Linux and verify the version and update path.
---

# Installation

This page only covers the shortest installation path for normal users. You do not need to understand the source tree first.

## Supported Systems

- `macOS arm64`
- `Linux x64`

## Install the Latest Version

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

After installation, verify it immediately:

```bash
yuto --version
```

If the terminal prints a version string, the installation has completed successfully.

## Install a Specific Version

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

Use a specific version only when your team wants to stay aligned or when you need to inspect the behavior of a historical release.

## Update

Update to the latest public version:

```bash
yuto update
```

Check whether an update exists:

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

Install a specific public version:

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

## The First Things to Do After Installation

Do not rush into normal usage immediately after install. Start with these three steps:

1. Run `yuto --version`
2. Run `yuto doctor --json`
3. Follow [Quick Start](/en/yutocode/getting-started) to finish provider login

That sequence makes environment issues easier to locate and prevents the first session from getting blocked on authentication.

## Release Sources

- GitHub Releases: `https://github.com/hkyutong/yuto-code-public/releases`
- Every public release provides matching checksum files

If an old version is already installed on the machine, prefer `yuto update` instead of manually replacing files.