安装 / 登录卡住了？最常见几种
可搜索图文 FAQ ｜ 面向零技术背景的学术用户 ｜ 遇到问题按关键词找
装 AI、登录、配 key 时卡住了？下面按最常见的几类整理。用浏览器的"页内查找"（⌘F）搜关键词，直接跳到你的问题。
安装类
Q：点了「安装 / Install」后卡住不动 / 转很久 / 提示失败，怎么办？
那一行会变成 「重试 / Retry」（一个循环箭头图标）。点 Retry 重新安装。
如果反复失败，几乎都是网络问题——安装脚本需要访问 claude.ai（Claude Code）下载官方安装脚本。检查：
- 你的网络能否正常打开 claude.ai；
- 是否有代理 / VPN 干扰，试着切换或关闭后重试；
- 公司 / 校园网可能拦截，换个网络再试。
🖼 配图：Claude Code 行显示「重试 / Retry」按钮特写，圈红。
Q：我以前明明装过 Claude Code，为什么它还让我装？
通常是 Scholardo 在默认路径没找到 claude 这个命令（PATH 检测不到），并不代表你的电脑上没有。试试：
- 重启 Scholardo 再看 chooser——很多时候重启后就识别到了。
- 进阶自查（可选）：打开"终端"App，输入
which claude回车。- 有输出路径 → 说明装过，多为 Scholardo 的环境没继承到该路径，重启 app 或重新点该行启动。
- 无输出 → 确实没装到默认位置，直接在 chooser 里点「安装 / Install」让它装一次即可。
Q：安装时滚过一大堆看不懂的字，正常吗？
正常。 那是下载和安装过程的输出，不需要你理解。等它停下来，"Choose an agent" 卡片会自动重新出现（这是 Scholardo 的 A1 设计），点该行启动即可。
登录类
Q：浏览器里授权成功了，回到 Scholardo 终端却没反应，怎么办？
- 回到 Scholardo 窗口，等几秒——授权回传有时有延迟。
- 仍无反应：回 chooser 重新点一次该 agent 行启动，重走登录。
- 确认授权时用的是正确的账号（比如 Claude 订阅账号，而非另一个没订阅的账号）。
Q：选登录方式时，我好像选了带 API 的那一项，结果不对 / 担心多花钱？
Claude Code / Codex 应选 "用订阅登录"（subscription / Claude account / ChatGPT account），不要选带 API / Console / usage billing（按量计费） 的那一项——那条路会按 token 单独收费。
如果选错了：退出登录向导，回 chooser 重新启动该 agent，重走登录流程，这次改选"订阅"那项。
配置类（第三方模型 / DeepSeek）
Q：终端提示"未检测到可用的 DeepSeek 配置"，怎么办？
原文：⚠️ 未检测到可用的 DeepSeek 配置。请先在 设置 ▸ AI Agent 添加 DeepSeek 提供方并填写 API Key，然后重新启动会话。
说明 key 还没配好。到 设置 ▸ AI Agent ▸「AI providers」段 确认 DeepSeek 的 API key 已填好，然后新开一个 session 再启动。详见 P0-3。
Q：终端提示"无法从 Keychain 读取 DeepSeek 的 API Key"？
原文：⚠️ 无法从 Keychain 读取 DeepSeek 的 API Key。请在 设置 ▸ AI Agent 重新保存 Key。
回 设置 ▸ AI Agent 的同一段，重新粘贴并保存一次 key 即可。
Q：创建 DeepSeek 的 key 时忘了复制，弹窗关掉后找不到完整 key 了？
API key 只完整显示一次，关掉就看不到了。回 DeepSeek 平台的 API keys 页，删掉旧 key、重新创建一个，再回 Scholardo 重新粘贴。
Q：我填了 key，为什么选 DeepSeek（或 Kimi / GLM）时提示还要装 Claude Code？
因为这些第三方模型寄生在 Claude Code 上运行——Claude Code 在这里充当"运载工具"（carrier）。行上若显示 "Needs Claude Code installed" + 「安装 / Install」，海外网络下点 Install 让它自动把 carrier 装好即可（装的是运行外壳，不需要你再买一份 Claude 订阅）。
⚠️ 中国大陆：这个一键 Install 走
claude.ai，被墙装不上。请先按 《中国大陆使用 Claude Code》 的「第 1 步」用 npm（国内镜像）装好 Claude Code（后面 env-var 步骤不用做），装好后该行会自动就绪。详见 DeepSeek 完整接入 的「大陆用户必看」。
还是不行？
- 确认你走对了路线：大陆用户请走 DeepSeek，别在 Claude / ChatGPT 订阅注册上反复尝试（P0-2 有说明）。
- 从头对照 P0-1（Claude 订阅版） 或 P0-3（DeepSeek 版） 再走一遍。
Shot list（配图清单）
均为 Scholardo 当前发布版界面。key 相关截图务必打码。
| 图号 | 截什么 | 界面来源 | 关键 callout |
|---|---|---|---|
| 图 1 | Claude Code 行「重试 / Retry」按钮特写 | Scholardo | 圈红 Retry |
| 图 2 | 终端 DeepSeek 未配置 / Keychain 读取失败的中文警告 | Scholardo | 圈出"设置 ▸ AI Agent"指引 |
| 图 3 | 设置 ▸ AI Agent ▸「AI providers」段重新保存 key | Scholardo（key 打码） | 圈出 key 输入框与保存 |
| 图 4 | DeepSeek 行 "Needs Claude Code installed" + Install | Scholardo | 旁注"装的是 carrier，不用再买订阅" |
数据隐私披露
排查问题不涉及额外数据外发；但正常使用时请记得：你的文稿内容会发送给所选 AI 服务商处理（Anthropic / DeepSeek 等）。你的 API key 只保存在本机 Keychain，不会上传。若材料涉及未公开数据、受访者隐私或保密协议，请先确认发送给第三方 AI 服务是否符合你所在机构的合规要求。