80000+ GitHub Star，150万开发者都在用的开源AI编程助手，今天手把手教你从零开始配置！
🚀 前言
最近AI编程工具层出不穷，Cursor、GitHub Copilot、Claude Code... 但今天要介绍的这款工具，可能会彻底改变你的编程方式。
它就是 OpenCode —— 一款完全开源、免费的AI编程Agent。
为什么说它是神器？
- ✅ 完全开源，GitHub 80000+ Star
废话不多说，直接上干货！
📖 一、什么是OpenCode？
OpenCode 是一个开源的AI编程Agent，可以在终端、IDE或桌面应用中帮你写代码。
核心特性：
| |
|---|
| |
| |
| |
| 75+种LLM模型，包括Claude、GPT、Gemini等 |
| |
💡 最重要的是：OpenCode提供免费模型！
即使你没有任何AI订阅，也能直接使用。这对于想体验AI编程但不想花钱的同学来说，简直是福音。
💾 二、安装OpenCode##
根据你的操作系统，选择对应的安装方式：
🪟 Windows用户
方法一：使用Chocolatey（推荐）
打开 PowerShell（管理员模式），运行：
choco install opencode
💡 没有安装Chocolatey？先运行这个命令安装：
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
方法二：使用Scoop
scoop install opencode
方法三：使用NPM
npm install -g opencode-ai
🍎 macOS用户
方法一：使用Homebrew（推荐）
brew install anomalyco/tap/opencode
方法二：使用安装脚本
curl -fsSL https://opencode.ai/install | bash
方法三：使用NPM
npm install -g opencode-ai
🐧 Linux用户
方法一：使用安装脚本（推荐）
curl -fsSL https://opencode.ai/install | bash
方法二：使用Homebrew
brew install anomalyco/tap/opencode
方法三：Arch Linux用户
paru -S opencode-bin
✅ 验证安装
安装完成后，打开终端/PowerShell输入：
opencode --version
如果显示版本号（如 1.0.150），说明安装成功！
⚙️ 三、配置免费模型（OpenCode Zen）
OpenCode提供了一个叫 Zen 的服务，里面有经过官方测试和验证的模型，包括免费模型！
📝 步骤1：注册账号
访问 👉 https://opencode.ai/auth 注册账号
🔑 步骤2：获取API Key
登录后，点击 Create API Key 创建一个API密钥，复制保存好。
🔌 步骤3：在OpenCode中配置
打开终端/PowerShell，进入你的项目目录：
Windows:
cd C:\你的项目路径opencode
macOS/Linux:
cd /你的项目路径opencode
首次运行会进入OpenCode的TUI界面，输入以下命令连接Zen：
/connect
选择 opencode，然后粘贴你的API Key。
🎯 步骤4：选择免费模型
输入以下命令查看可用模型：
/models
🆓 免费模型推荐：
⚠️ 重要提示：在 /models 列表中找到 opencode/gpt-5-nano 或 opencode/big-pickle，按回车选择即可。
选择一个免费模型后，就可以开始使用了！
🔌 四、安装Oh-My-OpenCode插件（进阶）
如果你想让OpenCode更强大，强烈推荐安装 Oh-My-OpenCode 插件。
这个插件由社区开发，GitHub 22000+ Star，被称为"OpenCode的最佳伴侣"。
🎁 它能带来什么？
| |
|---|
| |
| Oracle（架构师）、Librarian（文档专家）、Explore（代码探索）等 |
| |
| |
| |
📦 安装步骤
步骤1：运行安装命令
Windows (PowerShell):
npx oh-my-opencode install
macOS/Linux:
bunx oh-my-opencode install# 或者npx oh-my-opencode install
步骤2：根据提示选择配置
安装程序会问你几个问题，如果你没有付费订阅，按以下方式回答：
步骤3：验证安装
Windows (PowerShell):
type $env:USERPROFILE\.config\opencode\opencode.json
macOS/Linux:
cat ~/.config/opencode/opencode.json
确认配置文件中包含 "oh-my-opencode" 即可。
💡 使用技巧
安装完成后，在OpenCode中使用时，只需要在提示词中加入 ultrawork 或 ulw，插件就会自动启用所有高级功能！
例如：
ulw 帮我实现一个用户登录功能
🛠️ 五、实战：用OpenCode创建一个待办事项CLI工具
现在让我们用OpenCode实际做一个小项目，体验一下AI编程的魅力！
🎯 项目目标
创建一个命令行待办事项工具，支持：
📋 开始实战
步骤1：创建项目目录
Windows (PowerShell):
mkdir my-todo-clicd my-todo-cli
macOS/Linux:
mkdir my-todo-clicd my-todo-cli
步骤2：启动OpenCode
opencode
步骤3：选择免费模型
⚠️ 重要：在开始之前，先确保使用的是免费模型！
在OpenCode中输入：
/models
找到并选择 opencode/gpt-5-nano（完全免费）或 opencode/big-pickle（限时免费）。
步骤4：初始化项目
在OpenCode中输入：
/init
这会让OpenCode分析项目并创建 AGENTS.md 文件。
步骤5：让AI帮你写代码
在OpenCode中输入以下提示词：
请帮我创建一个Node.js命令行待办事项工具，要求：1. 使用纯JavaScript，不需要TypeScript2. 数据保存在本地JSON文件中（保存在当前目录的todos.json）3. 支持以下命令： - node todo.js add "任务内容" - 添加任务 - node todo.js list - 查看所有任务 - node todo.js done <id> - 标记任务完成 - node todo.js delete <id> - 删除任务4. 任务显示时，已完成的用 [✓] 标记，未完成的用 [ ] 标记5. 代码要简洁，适合初学者理解6. 不需要安装任何npm依赖，使用Node.js内置模块即可请创建一个名为 todo.js 的文件。
步骤6：观察AI工作
OpenCode会开始创建 todo.js 文件，你可以看到它实时编写代码的过程。
步骤7：测试程序
等AI完成后，打开一个新的终端窗口（不是在OpenCode里），进入项目目录测试：
Windows (PowerShell):
cd C:\你的项目路径\my-todo-cli# 添加任务node todo.js add "学习OpenCode"node todo.js add "写一篇公众号文章"node todo.js add "喝杯咖啡"# 查看任务列表node todo.js list# 标记第一个任务完成node todo.js done 1# 再次查看node todo.js list# 删除第三个任务node todo.js delete 3# 最终查看node todo.js list
macOS/Linux:
cd /你的项目路径/my-todo-cli# 添加任务node todo.js add "学习OpenCode"node todo.js add "写一篇公众号文章"node todo.js add "喝杯咖啡"# 查看任务列表node todo.js list# 标记第一个任务完成node todo.js done 1# 再次查看node todo.js list# 删除第三个任务node todo.js delete 3# 最终查看node todo.js list
步骤8：如果有问题，让AI修复
如果运行出错，回到OpenCode窗口，直接告诉它：
运行时报错了：[粘贴错误信息]请帮我修复
AI会自动分析错误并修复代码。
🚀 进阶玩法
如果你安装了Oh-My-OpenCode，可以这样用：
ulw 帮我给这个待办事项工具添加以下功能：1. 支持设置任务优先级（高/中/低）2. 支持按优先级排序显示3. 支持导出任务到Markdown文件
插件会自动调用多个Agent协作完成任务，效率更高！
📚 六、常用命令速查表
| |
|---|
/init | |
/connect | |
/models | |
/undo | |
/redo | |
/share | |
Tab | |
@文件名 | |
❓ 七、常见问题
Q：OpenCode和Cursor有什么区别？
A：OpenCode完全开源免费，Cursor是商业软件。OpenCode更灵活，支持更多模型，但Cursor的IDE集成更好。
Q：免费模型够用吗？
A：日常开发完全够用。GPT 5 Nano虽然是免费的，但处理一般的编程任务绑绑有余。如果需要更强的模型，可以考虑Zen的付费模型，价格比直接买API便宜。
Q：Oh-My-OpenCode必须安装吗？
A：不是必须的，但强烈推荐。它能让OpenCode的能力提升一个档次，特别是多Agent协作功能。
Q：支持中文吗？
A：支持！大部分模型都能很好地理解和生成中文代码注释。
Q：Windows上遇到权限问题怎么办？
A：尝试以管理员身份运行PowerShell，或者使用NPM安装方式。
🎉 总结
OpenCode是目前最强大的开源AI编程工具之一，配合Oh-My-OpenCode插件，能够实现：
- ✅ 免费使用AI编程（GPT 5 Nano完全免费）
如果你还在犹豫要不要尝试AI编程，OpenCode绝对是最佳入门选择。
🔗 相关链接
- 📌 OpenCode官网：https://opencode.ai/
- 📌 OpenCode GitHub：https://github.com/anomalyco/opencode
- 📌 Oh-My-OpenCode：https://github.com/code-yeongyu/oh-my-opencode
觉得有用的话，点个赞+在看，分享给更多需要的朋友！ 👍
