使用 OpenCode 帮助你完成任务

1. 确保你已经安装了 git.
2. 一个国际网络环境, 不在本文讨论范围, 故不赘述.

推荐使用 OpenCode, 因为 OpenCode Zen 官方提供了部分模型的免费使用, 且国内可以正常使用, 对于国内学习使用非常友好. CLI vibe coding 工具操作基本都差不多, 熟悉后, 还能够快速上手其他 CLI vibe coding 工具.

对于 Cursor, 这个软件上手比较容易, 但它是编辑器一体化软件, 不够轻量, 便携, 所以本文不推荐.

Codex CLI 和 Google Antigravity CLI 都有每周免费额度, 只需要登录对应的账号, 但是额度很少, 基本上使用一天就能够将两家的额度使用完.

详情请参考 OpenCode 官方文档 (opens in a new tab)

由于 OpenCode 官方的教程主要面向 Linux & macOS, 这里介绍一下 OpenCode 在 Windows 平台下的一种简单的安装方式 (当然你也可以根据教程使用 Node.js 和 pnpm 进行安装).

1. 前往 OpenCode 在 GitHub 上的 仓库 (opens in a new tab)
2. 找到最新的 Release 并访问

3. 在 Release description 下方找到 opencode-windows-x64.zip (往往在最后)
4. 单击并下载文件
5. 下载完成后在资源管理器中找到刚刚下载的文件并解压
6. 将解压出来的 exe 文件放置在你认为可以作为环境存储的目录下 (不建议需要管理员权限的目录), 推荐 %USERPROFILE%\.local\bin 目录 (最佳实践)
7. 将 %USERPROFILE%\.local\bin 目录添加到系统环境变量当中
8. 使用 PowerShell 运行 opencode -v, 检查能否成功安装 OpenCode

安装完成.

与其说是安装, 不如描述为将一个 exe 文件添加到环境变量当中.

question	description
GitHub 下载很慢	检查是否处于国际网络环境
什么是 %USERPROFILE%	这是一个环境变量, 如果你的用户名是 Zhang, 那么 %USERPROFILE% = C:\Users\Zhang, 你可以在 PowerShell 中尝试输入此环境变量, 查看该变量的值. 你可以在资源管理器的地址栏中输入该变量, 以达到快速访问目标目录的目的.

1. 打开环境变量窗口

• 方法一

使用  + S 快捷键, 打开搜索框, 输入 edit environment variables for your account (系统语言英文) 或 编辑环境变量 (系统语言中文), 你应该能够搜索到相关结果.

• 方法二

使用  + R 快捷键, 打开运行窗口, 输入 sysdm.cpl 并按下 ⏎, 现在你应该打开了编辑环境变量窗口.

2. 复制你放置 exe 文件的路径

3. 在环境变量窗口中, 选中 Path, 点击 Edit, 在新窗口中点击 New 并将你刚刚复制的内容粘贴进聚焦的输入框中, 按下 ⏎, 点击新窗口下方的 确定, 点击环境变量窗口下方的确定.

你成功将一个路径添加到了环境变量当中.

1. 打开资源管理器, 导航到你想要让 OpenCode 工作的目录 (建议使用空文件夹, 请不要选择桌面, system32 等路径, 除非你知道你在做什么)
2. 在资源管理器空白处右键, 选择在终端中打开 (注意不要选中任何文件夹中的项目)

3. 在终端中输入 opencode 并按下 ⏎, 这样你就能够开始使用 OpenCode 了

1. Ctrl + C 退出 OpenCode, 回到终端
2. Ctrl + P 打开指令面板
3. Escape + Escape 终止 OpenCode 的执行

1. opencode 打开 OpenCode (新对话)
2. opencode -c 打开 OpenCode (继续上次对话)
3. opencode -v 输出当前 OpenCode 版本
4. opencode upgrade 在线更新 OpenCode (不是使用官方方式安装的 OpenCode 不在版本控制当中, 如果你的 OpenCode 是按照这篇博客的方式安装的, 请前往 GitHub 下载并覆盖旧版本文件)

直接在对话框输入 / 可以触发指令

1. /providers 链接外部供应商 API
2. /models 能够在可用的模型之间切换
3. /themes 切换主题
4. /sessions 能够查看在当前目录的历史对话, 如果你发现你的历史对话不见了, 大概率是目录不同导致的
5. /skills 查看安装的 skills
6. /undo 撤销上一次消息 OpenCode 所做的操作 (注意: 如果你的文件是当次消息新加入的, 可能导致 OpenCode 追踪不全, 误删文件, 执行前请先备份)
7. /variants 更改思考/努力程度

更详细的使用方式, 请参照 OpenCode 官方文档 (opens in a new tab)

使用 /models 选择一个你心仪的模型.

在之前打开的 OpenCode 对话框中, 输入你想让 OpenCode 完成的事情, 例如 制作一个网页版贪吃蛇, 需要有样式与交互, 查看 OpenCode 是如何帮你实现的.

OpenCode 不仅能够帮你修改文件, 还能执行指令, 尝试告诉 OpenCode 帮我打开这个网页, 查看 OpenCode 是如何执行的.

OpenCode 也不是做慈善的, 官网说明免费请求 200 次免费模型每 5 小时. 这个免费额度已经很高了, 完成一些日常任务与轻度学习足够了, 但是如果重度使用, 这个用量也会很快用完.

重度使用可以考虑 deepseek 官方 API.

编程是这类工具的主要用途, 但是不仅限于编程, 正如上面所演示的, OpenCode 还能够执行终端的命令. 拥有执行终端命令的能力就说明, OpenCode 几乎能够帮你做到任何事情, 例如帮你安装 uv, python 环境, 帮你运行一个 GitHub 上的项目等. 终端是强大的, 许多 Linux 开发者仅使用终端的功能进行开发, 在终端中就能执行指令, 浏览并修改文件.

但是它并不是万能的, 例如帮你完成 Unity 项目, PS 修改图片, AE 制作合成这类事情原生并无法做到, 但是你可以自己动手拓展它的能力, 让它有能力来帮你完成这些事情.