常见问题

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

先执行：

yuto --version

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

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

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

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

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

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

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

3. Anthropic OAuth 返回 403

如果你看到类似：

OAuth authentication is currently not allowed for this organization

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

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

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

如果你看到类似：

This source snapshot does not include this subsystem yet.

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

先做两件事：

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

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

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

直接执行：

yuto auth status --json

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

yuto auth profiles --json

这比凭记忆判断更稳。

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

建议先收集：

yuto doctor --json
yuto auth status --json

再补这些信息：

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

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

不要公开贴出这些内容：

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

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