实验：Opencode 环境配置实践

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆

发布于

2026-05-11

实验前置检查

网络畅通
终端工具可用（macOS Terminal 或 Windows PowerShell）

实验时长：90 分钟

阶段 1：安装全套工具（30 分钟）

按照你的操作系统，选择对应章节完成安装：

macOS 用户：按照 3.2 节完成 Homebrew 安装和一键安装
Windows 用户：按照 3.3 节逐步完成 9 个工具的安装

安装完成后，在终端逐条验证：

git --version
node --version
npm --version
opencode --version
code --version
conda --version
pandoc --version

预期结果：每条命令都显示版本号。

阶段 2：配置 Git 身份（5 分钟）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global --list

预期结果：看到你填写的名字和邮箱。

阶段 3：启动 Opencode 并安装 Skills（20 分钟）

mkdir ~/opencode-lab
cd ~/opencode-lab
opencode

Windows 用户将 ~/opencode-lab 替换为 $env:USERPROFILE\opencode-lab。

在 Opencode TUI 中完成以下操作：

输入 /models，选择一个免费模型（如 GLM-5 Free）
输入 你好，请介绍一下自己，测试 AI 连接
粘贴以下指令安装 Skills 扩展包：

▶ Claude Code

请帮我从 GitHub 下载并安装 Skills 扩展包。步骤如下：
1. 克隆仓库 https://github.com/Xueheng-Li/ai-tools-installation.git 到临时目录
2. 将仓库中 recommended_skills 文件夹下的所有子文件夹复制到 ~/.config/opencode/skills/
3. 完成后删除临时目录

安装完成后，输入 /skills 确认技能列表中显示 15 个技能

预期结果：AI 正常回复；Skills 扩展包安装成功。

阶段 4：配置 API 密钥（可选，10 分钟）

如果你有智谱 AI 的 API 密钥：

在 Opencode 中输入 /connect
选择 Zhipu AI（或 Zhipu AI Coding Plan）
输入 API 密钥
输入 /models 切换到更强的模型（如 GLM-5）
输入一句话测试连接

阶段 5：VS Code 与 Opencode 协作（25 分钟）

打开 VS Code：从开始菜单或 Dock 启动
安装插件：按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows），搜索并安装 Office Viewer、Git Graph、Marp
切换中文：按 Cmd+Shift+P / Ctrl+Shift+P，搜索 Configure Display Language，选择中文
打开工作文件夹：File > Open Folder，选择 opencode-lab 文件夹
打开终端：按 Control+`（Mac）或 Ctrl+`（Windows）
启动 Opencode：在终端输入 opencode
对话练习：向 AI 提问经济学概念，观察回复质量
模式切换：
- 按 Tab 切换到 Plan 模式
- 输入 分析一下如何用 Python 计算股票的移动平均线
- 按 Tab 切回 Build 模式，让 AI 创建代码文件
探索命令：
- 按 Ctrl+P 打开命令面板
- 输入 /themes 换一个喜欢的主题
- 输入 /new 新建对话

评估标准

全套工具安装成功（7 个命令都显示版本号）
Git 身份配置完成
Opencode 启动成功，AI 能正常回复
Skills 扩展包安装成功（/skills 显示 15 个技能）
VS Code 插件安装完成
能在 VS Code 终端中启动 Opencode
能在 Build 和 Plan 模式之间切换

遇到问题时：

关闭终端，重新打开再试
检查命令拼写是否正确
查阅本章对应小节的常见问题说明
访问 Opencode 官方文档（https://learnopencode.com）
寻求助教或同学帮助

--- title: "实验：Opencode 环境配置实践" --- **实验前置检查** - [ ] 网络畅通 - [ ] 终端工具可用（macOS Terminal 或 Windows PowerShell） **实验时长**：90 分钟 --- **阶段 1：安装全套工具（30 分钟）** 按照你的操作系统，选择对应章节完成安装： - macOS 用户：按照 3.2 节完成 Homebrew 安装和一键安装 - Windows 用户：按照 3.3 节逐步完成 9 个工具的安装安装完成后，在终端逐条验证： ```bash git --version node --version npm --version opencode --version code --version conda --version pandoc --version ``` 预期结果：每条命令都显示版本号。 --- **阶段 2：配置 Git 身份（5 分钟）** ```bash git config --global user.name "你的名字" git config --global user.email "你的邮箱" git config --global --list ``` 预期结果：看到你填写的名字和邮箱。 --- **阶段 3：启动 Opencode 并安装 Skills（20 分钟）** ```bash mkdir ~/opencode-lab cd ~/opencode-lab opencode ``` Windows 用户将 `~/opencode-lab` 替换为 `$env:USERPROFILE\opencode-lab`。在 Opencode TUI 中完成以下操作： 1. 输入 `/models`，选择一个免费模型（如 GLM-5 Free） 2. 输入 `你好，请介绍一下自己`，测试 AI 连接 3. 粘贴以下指令安装 Skills 扩展包： ```opencode 请帮我从 GitHub 下载并安装 Skills 扩展包。步骤如下： 1. 克隆仓库 https://github.com/Xueheng-Li/ai-tools-installation.git 到临时目录 2. 将仓库中 recommended_skills 文件夹下的所有子文件夹复制到 ~/.config/opencode/skills/ 3. 完成后删除临时目录 ``` 4. 安装完成后，输入 `/skills` 确认技能列表中显示 15 个技能预期结果：AI 正常回复；Skills 扩展包安装成功。 --- **阶段 4：配置 API 密钥（可选，10 分钟）** 如果你有智谱 AI 的 API 密钥： 1. 在 Opencode 中输入 `/connect` 2. 选择 Zhipu AI（或 Zhipu AI Coding Plan） 3. 输入 API 密钥 4. 输入 `/models` 切换到更强的模型（如 GLM-5） 5. 输入一句话测试连接 --- **阶段 5：VS Code 与 Opencode 协作（25 分钟）** 1. **打开 VS Code**：从开始菜单或 Dock 启动 2. **安装插件**：按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows），搜索并安装 Office Viewer、Git Graph、Marp 3. **切换中文**：按 Cmd+Shift+P / Ctrl+Shift+P，搜索 `Configure Display Language`，选择中文 4. **打开工作文件夹**：File > Open Folder，选择 `opencode-lab` 文件夹 5. **打开终端**：按 Control+\`（Mac）或 Ctrl+\`（Windows） 6. **启动 Opencode**：在终端输入 `opencode` 7. **对话练习**：向 AI 提问经济学概念，观察回复质量 8. **模式切换**： - 按 `Tab` 切换到 Plan 模式 - 输入 `分析一下如何用 Python 计算股票的移动平均线` - 按 `Tab` 切回 Build 模式，让 AI 创建代码文件 9. **探索命令**： - 按 `Ctrl+P` 打开命令面板 - 输入 `/themes` 换一个喜欢的主题 - 输入 `/new` 新建对话 --- **评估标准** - [ ] 全套工具安装成功（7 个命令都显示版本号） - [ ] Git 身份配置完成 - [ ] Opencode 启动成功，AI 能正常回复 - [ ] Skills 扩展包安装成功（`/skills` 显示 15 个技能） - [ ] VS Code 插件安装完成 - [ ] 能在 VS Code 终端中启动 Opencode - [ ] 能在 Build 和 Plan 模式之间切换 **遇到问题时**： 1. 关闭终端，重新打开再试 2. 检查命令拼写是否正确 3. 查阅本章对应小节的常见问题说明 4. 访问 Opencode 官方文档（https://learnopencode.com） 5. 寻求助教或同学帮助

其他格式