常见问题 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?
官方入门路径为:
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 安装成功?
运行:
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、密码和登录验证码发给任何人。优先按照文档自行配置,遇到问题时只提供脱敏后的错误信息。
六、截图求助指南
提问时请一次性提供:
- 操作系统和版本;
- 工具名称和版本;
- 你正在执行的具体步骤;
- 完整错误信息;
- 已经尝试过的处理方式;
- 脱敏后的截图。
截图前必须遮盖 API Key、密码、手机号、邮箱、客户姓名、案号和内部文件内容。
推荐提问模板:
我正在安装 / 使用【工具名称】。
我的系统是【Windows / macOS / Linux + 版本】。
我正在执行【具体步骤】。
完整错误信息是:【粘贴错误】。
我已经尝试过:【已尝试的方式】。
请帮我判断下一步应该检查什么。如果问题仍未解决,把这份记录带入先导课;能够清楚描述卡点,本身就是课程要训练的能力之一。