Skip to content

常见问题 FAQ ​

使用 Ctrl+F(Windows)或 Cmd+F(Mac)搜索关键词。遇到文档没有覆盖的问题,请带着完整错误信息到群里求助。

一、课程与准备 ​

1. 课前必须安装哪些工具? ​

最低要求:

  • WorkBuddy:完成安装、登录和第一个小任务;
  • Claude Code:完成安装、登录、版本检查和第一次本地文件任务;
  • ChatGPT 桌面端与 Codex CLI:可选,但建议有兴趣的同学提前体验。

2. 为什么要求先做小任务? ​

安装成功不等于会用。课程训练的是“说明任务—提供材料—执行—检查结果—返工”的正向循环,所以课前要先跑通一个小而完整的闭环。

3. 课前材料可以用真实案卷吗? ​

不建议。优先使用公开材料、自己编写的测试文本或完全脱敏的材料。不要上传客户姓名、身份证号、联系方式、未公开案卷、内部合同、密码、API Key 或内部链接。

4. 三个工具都必须参加吗? ​

WorkBuddy 和 Claude Code 是本期主要课前入口。ChatGPT 桌面端与 Codex CLI 是可选入口,用于帮助大家理解桌面 GUI 与命令行 Agent 的不同工作方式。

二、WorkBuddy ​

1. 从哪里下载 WorkBuddy? ​

只从 WorkBuddy 官方网站 下载。不要使用网盘、群文件或不明镜像中的安装包。

2. WorkBuddy 登录不了怎么办? ​

先检查默认浏览器是否能够打开,确认网络能够访问官方页面;再记录操作系统、客户端版本和完整错误提示。如果登录页打开但扫码后没有返回客户端,先重新启动客户端和浏览器,再到群里提交截图求助。

3. 第一个 WorkBuddy 任务应该多大? ​

建议只使用一份短材料,完成“提取三个事实—生成一份 Markdown 摘要—检查文件”的任务。先建立手感,再增加材料数量和任务复杂度。

4. WorkBuddy 生成的结果可以直接使用吗? ​

不可以直接当作法律结论或事实认定。先核对材料来源、事实对应关系、遗漏和推测,再决定是否进入下一步工作。

三、ChatGPT 桌面端与 Codex CLI ​

1. ChatGPT 的 CLI 到底叫什么? ​

OpenAI 当前对应的终端工具名称是 Codex CLI。本页将 ChatGPT 桌面端作为 GUI,将 Codex CLI 作为 CLI 入口介绍。

2. 从哪里安装 ChatGPT 桌面端? ​

从 ChatGPT 官方下载页 安装。新的桌面应用整合了 ChatGPT、Work 和 Codex;具体入口受版本、账号和组织策略影响。

3. 如何安装 Codex CLI? ​

官方入门路径为:

bash
npm install -g @openai/codex
codex --login

使用 ChatGPT 账号完成登录。若 codex 找不到,重新打开终端并检查 Node.js、npm 和 PATH。

4. ChatGPT 登录和 API Key 是一回事吗? ​

不是。ChatGPT 账号登录、CLI 授权和 API Key 是不同的凭证路径。不要把密码、授权页面内容或 Key 发到群里,也不要将 Key 提交到代码仓库。

四、Claude Code ​

1. 是否必须先安装 Node.js? ​

不必。当前官方推荐原生安装器,不要求 Node.js 作为必备前置。只有选择 npm 安装路径时,才按官方文档准备相应 Node.js 版本。

2. 如何确认 Claude Code 安装成功? ​

运行:

bash
claude --version
claude doctor

前者检查版本,后者提供只读的安装和设置诊断信息。

3. Windows 应该选原生安装还是 WSL? ​

原生 Windows 适合直接处理 Windows 本地文件;WSL 2 适合已经使用 Linux 工具链的同学。本期不要求为了安装 Claude Code 而额外学习 WSL。

4. PowerShell 报 && 错误怎么办? ​

你可能把 CMD 命令粘贴到了 PowerShell。请根据教程选择对应终端和对应命令,不要混用。

5. claude 找不到怎么办? ​

关闭当前终端并重新打开,再运行 claude --version。如果仍然失败,运行 claude doctor,把完整错误信息、系统版本和安装方式带到群里。

6. Claude Code 登录后仍然不能使用怎么办? ​

检查账户是否具备 Claude Code 权限、网络是否稳定,以及是否存在不匹配的 API 环境变量。免费的 claude.ai 账户不包含 Claude Code 访问权限;组织账号或第三方网关按课程组提供的配置处理。

五、网络、账号与费用 ​

1. 需要准备哪些账号? ​

WorkBuddy 和 ChatGPT / Codex 使用各自的官方账号体系。Claude Code 需要符合官方要求的 Claude 或组织 / 云平台接入。模型账号和套餐是否可用,以当前平台和课程组通知为准。

2. 网络不稳定怎么办? ​

先确认能访问对应官方登录页和下载页,再确认终端能正常访问网络。截图时同时提供系统、浏览器、终端和错误发生步骤,不要只描述“网络不行”。

3. API Key 应该发给助教帮忙配置吗? ​

不建议。不要把 API Key、密码和登录验证码发给任何人。优先按照文档自行配置,遇到问题时只提供脱敏后的错误信息。

六、截图求助指南 ​

提问时请一次性提供:

  1. 操作系统和版本;
  2. 工具名称和版本;
  3. 你正在执行的具体步骤;
  4. 完整错误信息;
  5. 已经尝试过的处理方式;
  6. 脱敏后的截图。

截图前必须遮盖 API Key、密码、手机号、邮箱、客户姓名、案号和内部文件内容。

推荐提问模板:

text
我正在安装 / 使用【工具名称】。
我的系统是【Windows / macOS / Linux + 版本】。
我正在执行【具体步骤】。
完整错误信息是:【粘贴错误】。
我已经尝试过:【已尝试的方式】。
请帮我判断下一步应该检查什么。

如果问题仍未解决,把这份记录带入先导课;能够清楚描述卡点,本身就是课程要训练的能力之一。

四明山法师 AI 夜校 · 学员查阅版

访问统计总访问 ·访客