环境验证清单

课程机制提醒：本课程为公益课堂，保证金用于学习约束。完成听课与作业是退还基础；若中途退课，将按约定扣减后退还剩余金额。

预计完成时间：10-15分钟目的：确认 Claude Code（CLI + VS Code 插件）和 Cherry Studio 都已正确安装并配置 前置要求：

[ ] 已完成《01_Cherry_Studio_安装与配置指南.md》
[ ] 已完成《02_Claude_Code_安装与配置指南.md》

验证完成后：你就可以安心等待开课了！🎉

📋 验证说明

为什么需要验证？

在开课前验证环境可以确保：

✅ 所有工具都已正确安装
✅ API配置正确，可以正常使用
✅ 提前发现问题，避免开课时手忙脚乱
✅ 确保你能跟上课程进度

如何使用本清单？

逐项检查：按照清单逐项完成验证
打勾确认：每完成一项，在 [ ]中打勾（改为 [x]）
记录问题：如果某项失败，记录错误信息
排查解决：参考排查流程或查阅FAQ

🎨 第一部分：Cherry Studio验证

2.1 Cherry Studio已安装

验证方法：

检查Cherry Studio是否在应用程序列表中：

Windows：开始菜单 → 所有程序 → Cherry Studio
macOS：启动台 → Cherry Studio
Linux：应用菜单 → Cherry Studio

验证通过：[ ] ✅

如果失败：

检查安装是否完成
重新安装
查阅FAQ：《04_常见问题FAQ.md#cherry-studio安装失败》

2.2 能正常启动

验证方法：

启动Cherry Studio

预期结果：

Cherry Studio窗口打开
看到主界面（对话区域、输入框等）
没有崩溃或错误提示

验证通过：[ ] ✅

如果失败：

检查是否有错误提示
查阅FAQ：《04_常见问题FAQ.md#无法启动》
尝试重新安装

2.3 国内模型提供商已配置

验证方法：

打开设置（点击左下角齿轮图标）
选择"模型服务"或"提供商"
查看提供商列表

预期结果：

看到至少1个已连接的国内模型提供商（如GLM/Kimi/DeepSeek）
显示"已连接"或绿色状态指示

验证通过：[ ] ✅

关键检查点：

[ ] 至少1个国内模型提供商已添加
[ ] API Key已填写
[ ] 连接状态正常

如果失败：

检查API Key是否正确
检查网络连接
查阅FAQ：《04_常见问题FAQ.md#api-key配置失败》
或重新阅读《01_Cherry_Studio_安装与配置指南.md》的"步骤4"

2.4 能创建新对话

验证方法：

点击"新建对话"按钮（左上角+号）
在右侧边栏选择"GLM-4.7"模型

预期结果：

出现新的对话界面
模型选择显示"GLM-4.7"

验证通过：[ ] ✅

如果失败：

检查模型列表中是否有GLM-4.7
查阅FAQ：《04_常见问题FAQ.md#模型列表中没有glm-47》
或重新阅读《01_Cherry_Studio_安装与配置指南.md》的"步骤4.4"

2.5 能选择可用模型（国内+国际）

验证方法：

在对话界面的右侧边栏，查看模型选择下拉菜单

预期结果：

下拉菜单中显示你已接入的模型（如GLM-4.7 / kimi-latest / deepseek-v3.2 / Claude / GPT / Gemini）
可以选择并切换到该模型

验证通过：[ ] ✅

如果失败：

检查模型是否已添加
重新添加模型

2.6 能发送消息并收到响应

验证方法：

在输入框中输入：

你好，请用一句话介绍你自己。

点击发送

预期结果：

Assistant: 我是智谱AI开发的大语言模型，可以回答问题、提供信息和进行对话交流。

验证通过：[ ] ✅

关键检查点：

[ ] 消息发送成功
[ ] 收到AI的回复
[ ] 回复内容是中文且可理解
[ ] 响应时间在5秒内

如果失败：

检查网络连接
检查API余额
查阅FAQ：《04_常见问题FAQ.md#无法发送消息》
检查模型是否正确选择

2.7 能上传文档

验证方法：

准备一个测试文档（PDF、Word或TXT，<5MB）
点击输入框上方的附件图标（📎）
选择文档并打开
输入提示词：
```
请总结这份文档的主要内容。
```
点击发送

预期结果：

文档上传成功
AI读取文档并给出总结

验证通过：[ ] ✅

关键检查点：

[ ] 文档能成功上传
[ ] AI能读取文档内容
[ ] 总结内容准确

如果失败：

检查文件格式（支持PDF、Word、TXT、Markdown等）
检查文件大小（建议<10MB）
查阅FAQ：《04_常见问题FAQ.md#文档上传失败》

🔧 第二部分：Claude Code验证

1.1 Node.js已安装

验证方法：

打开终端/命令行，执行：

bash

node --version

预期结果：

v20.18.0  # 或v18.x.x、v22.x.x等LTS版本

验证通过：[ ] ✅

如果失败：

检查Node.js是否安装
查阅FAQ：《04_常见问题FAQ.md#nodejs安装失败》
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤2"

1.2 Claude Code CLI已安装

验证方法：

bash

claude --version

预期结果：

claude-code version 2.1.2  # 或其他版本号

验证通过：[ ] ✅

如果失败：

检查Claude Code是否安装
查阅FAQ：《04_常见问题FAQ.md#claude-code安装报错》
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤3"

1.2A Windows学员：Git for Windows 已安装

验证方法（仅 Windows 学员）：

powershell

git --version

预期结果：

git version 2.xx.x.windows.x

验证通过：[ ] ✅（macOS/Linux 学员此项可跳过）

如果失败：

安装 Git for Windows：https://git-scm.com/download/win
重开 PowerShell 后重新验证
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤1.3"

1.3 Visual Studio Code 已安装

验证方法：

打开 Visual Studio Code
确认应用可以正常进入主界面

预期结果：

VS Code 可正常启动
左侧可看到“资源管理器/搜索/扩展”等图标

验证通过：[ ] ✅

如果失败：

重新安装 VS Code
以管理员身份运行安装程序（Windows）
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤3.3"

1.4 VS Code 中 Claude Code 插件已安装

验证方法：

在 VS Code 中打开“扩展”（Ctrl+Shift+X / Cmd+Shift+X）
搜索 Claude Code
确认发布者为 Anthropic 的插件状态为“已安装”

预期结果：

插件显示“Installed/已安装”
命令面板中可搜索到 Claude Code 相关命令

验证通过：[ ] ✅

如果失败：

检查网络后重试安装
搜索关键词改为 Anthropic
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤3.4"

1.5 已通过 coding-tool-helper 完成GLM接入

验证方法：

bash

# 先确认工具可运行
npx @z_ai/coding-helper --help

# Windows (PowerShell)
cat $env:USERPROFILE\.claude\settings.json

# macOS/Linux
cat ~/.claude/settings.json

预期结果（包含）：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-abc123...",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4/",
    "ANTHROPIC_MODEL": "glm-4.7"
  }
}

验证通过：[ ] ✅

关键检查点：

[ ] npx @z_ai/coding-helper 命令可正常执行
[ ] ANTHROPIC_AUTH_TOKEN字段存在且不是空值
[ ] ANTHROPIC_BASE_URL指向可用模型API地址
[ ] ANTHROPIC_MODEL设置为你选择的目标模型（如 glm-4.7）

如果失败：

重新执行 npx @z_ai/coding-helper，按向导再走一遍
检查配置文件是否存在
检查配置文件格式是否正确
查阅FAQ：《04_常见问题FAQ.md#api-key配置失败》
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤5"

1.6 已安装 CC Switch

验证方法：

启动 CC Switch 应用
确认应用可打开且可看到 provider 管理入口

预期结果：

CC Switch 可正常启动
可进行 provider 的添加和启用操作

验证通过：[ ] ✅

如果失败：

重新安装 CC Switch
按系统对应安装包重新下载
或重新阅读《02_Claude_Code_安装与配置指南.md》的"步骤5.6"

1.7 能启动Claude Code

验证方法：

bash

claude

预期结果：

Initializing Claude Code...
Connected to model: glm-4.7

You are now connected to Claude Code!
Type your message and press Enter to send.
Type /exit or Ctrl+C to exit.

You: _

验证通过：[ ] ✅

如果失败：

检查错误信息
查阅FAQ：《04_常见问题FAQ.md#claude-code启动失败》
检查网络连接
检查API Key是否有效

1.8 能发送测试消息并收到响应

验证方法：

在 You:提示符后输入：

你好，请用一句话介绍你自己。

按回车发送。

预期结果：

You: 你好，请用一句话介绍你自己。

Assistant: 我是智谱AI开发的大语言模型GLM，可以回答问题、提供信息和进行对话交流。

验证通过：[ ] ✅

关键检查点：

[ ] 能成功发送消息
[ ] 能收到AI的回复
[ ] 回复内容是中文且可理解
[ ] 响应时间在5秒内

如果失败：

检查网络连接
检查API余额
查阅FAQ：《04_常见问题FAQ.md#消息发送无响应》
检查模型是否正确配置

1.9 能正常退出Claude Code

验证方法：

输入 /exit或按 Ctrl+C

预期结果：

Exiting Claude Code...
Goodbye!

验证通过：[ ] ✅

🔄 第三部分：综合验证

3.1 两个工具都能正常使用

验证方法：

回顾前面的验证项目，确认：

Claude Code：

[ ] 能启动和退出
[ ] 能发送消息并收到响应
[ ] VS Code 插件可用
[ ] CC Switch 可启动

Cherry Studio：

[ ] 能启动
[ ] 能创建对话
[ ] 能发送消息并收到响应
[ ] 能上传文档

验证通过：[ ] ✅

3.2 理解两个工具的区别和使用场景

自我测试：

回答以下问题（不查阅文档）：

Claude Code和Cherry Studio的主要区别是什么？
- 你的答案：____________________________________
Claude Code适合什么场景？
- 你的答案：____________________________________
Cherry Studio适合什么场景？
- 你的答案：____________________________________
什么情况下你会选择Claude Code而不是Cherry Studio？
- 你的答案：____________________________________
什么情况下你会选择Cherry Studio而不是Claude Code？
- 你的答案：____________________________________

验证通过：[ ] ✅

参考答案（对照你的答案）：

主要区别：
- Claude Code是命令行工具，Cherry Studio是可视化工具
- Claude Code更高效但需要熟悉命令行，Cherry Studio更直观
Claude Code适合：
- 批量处理文档
- 自动化工作流
- 需要与系统命令结合的场景
Cherry Studio适合：
- 日常对话
- 知识库管理
- 可视化操作
- Skill开发
选择Claude Code的情况：
- 需要批量处理20份合同
- 需要自动化重复性任务
- 需要与文件系统深度集成
选择Cherry Studio的情况：
- 需要可视化界面
- 需要构建知识库
- 需要开发自定义Skill
- 需要上传多种类型文档

✅ 验证完成确认

最终检查清单

所有验证项目：

Cherry Studio：

[ ] 1.1 Cherry Studio已安装
[ ] 1.2 能正常启动
[ ] 1.3 国内模型提供商已配置
[ ] 1.4 能创建新对话
[ ] 1.5 能选择可用模型（国内+国际）
[ ] 1.6 能发送消息并收到响应
[ ] 1.7 能上传文档

Claude Code：

[ ] 2.1 Node.js已安装
[ ] 2.2 Claude Code CLI已安装
[ ] 2.2A Windows学员：Git for Windows 已安装（macOS/Linux 可跳过）
[ ] 2.3 Visual Studio Code 已安装
[ ] 2.4 VS Code 中 Claude Code 插件已安装
[ ] 2.5 已通过 coding-tool-helper 完成GLM接入
[ ] 2.6 已安装 CC Switch
[ ] 2.7 能启动Claude Code
[ ] 2.8 能发送测试消息并收到响应
[ ] 2.9 能正常退出Claude Code

综合验证：

[ ] 3.1 两个工具都能正常使用
[ ] 3.2 理解两个工具的区别和使用场景

验证结果统计

总项目数：17项（Windows学员为18项）

已完成：/17（Windows学员填写/18）

通过率：_____%

验证结果评估

🎉 优秀（全部通过）：

✅ 你已经完全准备好了！
✅ 可以安心等待开课
✅ 预祝你学习愉快！

👍 良好（仅剩1-2项未完成）：

✅ 基本准备好，可以参加课程
⚠️ 建议在开课前解决剩余问题
💡 如有困难，可在微信群中求助

⚠️ 需要改进（剩余未完成项较多）：

⚠️ 建议尽快解决未通过的项目
📖 重新阅读对应的安装指南
🆘 如有困难，在微信群中求助或查阅FAQ
💡 也可以申请助教一对一指导

🔍 验证失败排查流程

如果某个验证项目失败

第1步：查看错误信息

记录完整的错误提示
截图保存（方便求助）

第2步：查阅FAQ

打开《04_常见问题FAQ.md》
搜索相关的错误信息
按照FAQ中的解决方法尝试

第3步：重新阅读对应指南

如果是Claude Code问题，重新阅读《02_Claude_Code_安装与配置指南.md》
如果是Cherry Studio问题，重新阅读《01_Cherry_Studio_安装与配置指南.md》
重点关注失败的步骤

第4步：微信群求助

在学员微信群中提问
描述问题+截图+你的操作系统
等待助教或其他学员回复

第5步：截图求助AI（终局方案）

截取完整的错误信息
使用网页版AI（Claude/ChatGPT/文心一言）

使用提示词模板：

我在验证AI工具环境时遇到了错误，请帮我解决。

我在验证的项目：[如"1.7 能启动Claude Code"]
我的操作系统：[Windows 10/Mac macOS 13/Ubuntu 20.04]
错误信息：[粘贴完整错误]

我已尝试的方法：
1. [列出你已尝试的解决方法]

请提供其他可能的解决方案，谢谢！

📞 需要帮助？

开课前支持渠道

如果在验证过程中遇到问题：

1. 学员微信群

响应时间：通常1-2小时内
适用场景：一般性问题、需要人工判断的问题

2. 联系陈石微信

微信号/手机号：13567896937
适用场景：紧急问题、个别沟通、协助排查

🎉 祝贺你！

如果你已经完成了所有验证项目，那么：

✅ 你已成功完成课前准备！

你现在拥有：

✅ Claude Code CLI（命令行AI工具）
✅ Git for Windows（Windows学员，Git Bash 可用）
✅ Cherry Studio（可视化AI客户端）
✅ 至少1个国内模型（API已配置并测试）
✅ 完整的工作环境（已验证可用）

🚀 你已经为课程做好了准备！

✅ 不会因为环境问题跟不上课程
✅ 可以专注于学习AI应用技能
✅ 可以提前熟悉工具，学习效果更好

📅 下一步

等待开课：

开课前1天，我们会发送开课提醒
开课前30分钟，我们会发送会议链接
准备好你的电脑和心态，我们课堂上见！

预习建议（可选）：

尝试用Cherry Studio创建一个知识库
尝试用Claude Code处理一份文档
思考你想用AI解决什么问题

期待在课堂上见到你！ 🎊

验证清单版本：v1.0 最后更新：2025年2月4日 适用课程：法律人 AI 训练营

环境验证清单 ​

📋 验证说明 ​

为什么需要验证？ ​

如何使用本清单？ ​

🎨 第一部分：Cherry Studio验证 ​

2.1 Cherry Studio已安装 ​

2.2 能正常启动 ​

2.3 国内模型提供商已配置 ​

2.4 能创建新对话 ​

2.5 能选择可用模型（国内+国际） ​

2.6 能发送消息并收到响应 ​

2.7 能上传文档 ​

🔧 第二部分：Claude Code验证 ​

1.1 Node.js已安装 ​

1.2 Claude Code CLI已安装 ​

1.2A Windows学员：Git for Windows 已安装 ​

1.3 Visual Studio Code 已安装 ​

1.4 VS Code 中 Claude Code 插件已安装 ​

1.5 已通过 coding-tool-helper 完成GLM接入 ​

1.6 已安装 CC Switch ​

1.7 能启动Claude Code ​

1.8 能发送测试消息并收到响应 ​

1.9 能正常退出Claude Code ​

🔄 第三部分：综合验证 ​

3.1 两个工具都能正常使用 ​

3.2 理解两个工具的区别和使用场景 ​

✅ 验证完成确认 ​

最终检查清单 ​

验证结果统计 ​

验证结果评估 ​

🔍 验证失败排查流程 ​

如果某个验证项目失败 ​

第1步：查看错误信息 ​

第2步：查阅FAQ ​

第3步：重新阅读对应指南 ​

第4步：微信群求助 ​

第5步：截图求助AI（终局方案） ​

📞 需要帮助？ ​

开课前支持渠道 ​

🎉 祝贺你！ ​

✅ 你已成功完成课前准备！ ​

🚀 你已经为课程做好了准备！ ​

📅 下一步 ​

环境验证清单

📋 验证说明

为什么需要验证？

如何使用本清单？

🎨 第一部分：Cherry Studio验证

2.1 Cherry Studio已安装

2.2 能正常启动

2.3 国内模型提供商已配置

2.4 能创建新对话

2.5 能选择可用模型（国内+国际）

2.6 能发送消息并收到响应

2.7 能上传文档

🔧 第二部分：Claude Code验证

1.1 Node.js已安装

1.2 Claude Code CLI已安装

1.2A Windows学员：Git for Windows 已安装

1.3 Visual Studio Code 已安装

1.4 VS Code 中 Claude Code 插件已安装

1.5 已通过 coding-tool-helper 完成GLM接入

1.6 已安装 CC Switch

1.7 能启动Claude Code

1.8 能发送测试消息并收到响应

1.9 能正常退出Claude Code

🔄 第三部分：综合验证

3.1 两个工具都能正常使用

3.2 理解两个工具的区别和使用场景

✅ 验证完成确认

最终检查清单

验证结果统计

验证结果评估

🔍 验证失败排查流程

如果某个验证项目失败

第1步：查看错误信息

第2步：查阅FAQ

第3步：重新阅读对应指南

第4步：微信群求助

第5步：截图求助AI（终局方案）

📞 需要帮助？

开课前支持渠道

🎉 祝贺你！

✅ 你已成功完成课前准备！

🚀 你已经为课程做好了准备！

📅 下一步