---
description: 排查 YutoCode 的登录、授权、provider 403 和命令不可用等常见问题。
---

# 常见问题

## 1. 安装完成后，终端里找不到 `yuto`

先执行：

```bash
yuto --version
```

如果提示命令不存在，通常是：

- 安装没有完成
- 当前 shell 没有刷新环境变量
- 终端窗口仍停留在安装前的会话

最简单的处理方式是重开一个终端，再试一次 `yuto --version`。

## 2. OpenAI Codex 登录后浏览器报错

当前推荐流程是把浏览器最终跳转到的完整地址粘回终端：

```text
http://localhost:1455/auth/callback?code=...&state=...
```

如果你只复制了一部分，或者没把整条 URL 粘回去，登录就不会完成。

## 3. Anthropic OAuth 返回 403

如果你看到类似：

```text
OAuth authentication is currently not allowed for this organization
```

说明当前组织策略不允许这条 OAuth 推理链路。处理方式一般只有两种：

- 换到允许该能力的组织
- 改用 `ANTHROPIC_API_KEY`

## 4. 某个命令提示当前版本不包含该子系统

如果你看到类似：

```text
This source snapshot does not include this subsystem yet.
```

不要先判断成安装坏了。更常见的情况是：你现在用的公开版本里，本来就没有把那个子系统作为正式支持面放出来。

先做两件事：

1. `yuto --version`
2. `yuto update --check`

确认是否已经是当前公开版本。

## 5. 不确定现在到底登录的是哪个 provider

直接执行：

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

如果你维护了多个 profile，再补：

```bash
yuto auth profiles --json
```

这比凭记忆判断更稳。

## 6. 报问题时应该提供什么

建议先收集：

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

再补这些信息：

- 失败命令
- 完整报错输出
- 当前工作目录
- 系统版本

## 7. 什么信息不要直接发给别人

不要公开贴出这些内容：

- API key
- OAuth access token
- refresh token
- 凭证文件的完整内容

如果一定要发配置，请先脱敏，只保留结构和非敏感字段。