---
description: 第一次使用 YutoCode 的最短路径，从理解定位到完成首次登录和第一次会话。
---

# 快速开始

这一页只讲第一次用时最需要的步骤，不展开内部实现。

## 先理解它是什么

YutoCode 的定位是：打破平台壁垒的下一代 AI 编程智能体，原生兼容 `OpenAI`、`Claude`、`Gemini` 及 `OpenClaw`。

这句话真正想表达的是两点：

- 你不需要把工作流绑死在单一平台上
- 你可以用同一套终端使用方式，在不同模型与生态之间持续工作

这也是它和普通“单平台 AI 编码工具”最大的差别。

## 第一步：选择一个 provider

第一次使用时，不要先追求把所有兼容面都试完。更稳的做法是先选一个你现在手上已经有凭证、最容易跑通的 provider。

常见选择是：

- `Yuto API`：适合已经在用 YutoAI 能力的团队
- `OpenAI Codex`：适合已经有对应账号和授权流程的用户
- `Anthropic`：适合已经能使用 Claude 或 Anthropic API 的用户

先跑通一条链路，比一开始把所有平台都接上更重要。

## 第二步：登录

### 用 Yuto API

如果你用的是 OpenAI 兼容接口：

```bash
yuto auth login --provider yuto --api-format openai --api-key YOUR_YUTO_API_KEY
```

如果你用的是 Claude 格式接口：

```bash
yuto auth login --provider yuto --api-format claude --api-key YOUR_YUTO_API_KEY
```

### 用 OpenAI Codex

```bash
yuto auth login --provider openai-codex
```

浏览器授权完成后，把最终跳转得到的 `http://localhost:1455/auth/callback?...` 完整地址粘回终端即可。

### 用 Anthropic

```bash
yuto auth login --provider anthropic --claudeai
```

如果你已经有 API key，也可以直接保存：

```bash
yuto auth login --provider anthropic --api-key YOUR_ANTHROPIC_API_KEY
```

## 第三步：确认登录状态

```bash
yuto auth status --json
```

如果你使用多个账户或工作环境，也可以通过 profile 管理：

```bash
yuto auth profiles --json
yuto auth use-profile work
```

## 第四步：开始第一次会话

进入项目目录后，直接运行：

```bash
yuto
```

第一次会话建议做这三类简单任务：

1. 让它总结当前仓库结构
2. 让它解释某个文件或某段代码
3. 让它给出一个明确的小改动方案

例如：

```text
先看一下这个仓库的目录结构，再告诉我登录逻辑可能在哪几个文件里。
```

## 第五步：如果你不想进入持续会话

可以直接用单次执行模式：

```bash
yuto --print "Summarize the purpose of this repository."
```

这适合快速出一份说明、摘要或初步分析。

## REPL 里最常用的斜杠命令

- `/help`
- `/status`
- `/provider`
- `/model`
- `/tools`
- `/config`
- `/clear`
- `/exit`

第一次使用时，不需要把所有命令背下来。先会 `status`、`provider`、`exit` 就够了。