OpenCode 开源免费 AI 命令行工具实测：从安装配置到全栈项目实战

• 文档
• 教程
• 知识库
• 人工智能

在 Claude Code 长期占据 AI 编程命令行工具头部的背景下，完全开源免费的 OpenCode 正在成为开发者迁移的热门选择。本文基于本仓库《Vibe Coding 零基础教程》中的真实实测记录，完整演示 OpenCode 的安装、模式与模型切换、命令面板、LSP 支持、Skills 扩展体系与 Oh My OpenCode 增强插件，并通过一个基于 Vercel AI Gateway 的 AI 健康助手全栈项目检验其真实项目开发能力，帮助你在 Claude Code、Cursor、OpenCode、Gemini CLI 等工具之间做出理性选择。

为什么 OpenCode 突然火了：Claude Code 的客观痛点

要理解 OpenCode 的崛起，首先要看 Claude Code 长期存在的两大门槛：

1. 网络与账号门槛：使用 Claude Code 必须依赖特殊网络环境并持有官方账号，否则终端中只会出现一片报错红字，对国内用户非常不友好。
2. 企业级封禁：2025 年 9 月，Anthropic 突然宣布全面禁止中国控股企业使用 Claude 服务，封禁范围不仅包括中国大陆企业，还包括海外中资控股超过 50% 的公司，并点名将中国称为"敌对国家"。

正是在这种"天下苦 Claude Code 久矣"的背景下，身边大量程序员朋友开始从 Claude Code 转向突然爆火的开源项目 OpenCode。据文档记录，该项目仅用约半年时间就在 GitHub 上涨到了 5.2 万 Star。本仓库《05 AI 命令行编程工具》中也将 OpenCode 直接定位为"Claude Code 的开源版"，并指出其最大优势是完全免费开源、无需付费订阅、没有地区限制，对国内用户特别友好，适合预算有限的学生和个人开发者。

OpenCode 是什么

OpenCode 是一款 100% 开源的 AI 编程命令行工具，可以在终端、IDE、甚至桌面应用中使用。它提供直观的终端界面、会话管理、自定义命令等功能，支持 Claude、GPT、Gemini、DeepSeek、GLM 等多模型自由切换，开发者可以根据不同任务选择最合适的模型，不被单一模型限制。

它与 Claude Code 的核心区别在于：Claude Code 是闭源订阅制、区域受限；OpenCode 则完全开源免费、可定制性强，甚至可以直接 fork 一份自行魔改。下面从安装配置开始，完整走一遍实操流程。

从零上手 OpenCode

1. 安装与首次运行

打开 OpenCode 官网，复制官方提供的一行安装命令，在终端执行即可：

curl -fsSL https://opencode.ai/install | bash

安装完成后，在终端输入opencode进入程序。首个经典 Hello World 测试中，AI 成功给出了回复。至此，OpenCode 的基础使用已经掌握了七成——因为后续绝大多数操作都可以通过内置命令面板完成。

2. 选择模式与模型

OpenCode 支持2 种工作模式：

按Ctrl + p可以打开命令面板，其中内置了几十个命令，例如切换大模型。OpenCode 默认提供4 个免费模型，据文档记录甚至包含智谱最新的 GLM-4.7（对拥有付费 Coding Plan 套餐的用户颇具吸引力）。除了免费模型，OpenCode 还支持大量的 AI 模型供自由选择。

选中模型后，配置自己的 API Key 即可使用。如果你之前持有Claude Pro/Max 订阅账号，可以直接登录使用，实现从 Claude Code 的无缝迁移。

3. 快捷指令

OpenCode 支持完整的斜杠命令体系：

• 输入/可以看到大量操作，如查看模型列表、查看 Agents、管理 MCP、切换主题等；
• 支持几十个不同的主题，颜值普遍较高，体现 OpenCode 对用户体验的重视；
• 输入@可以快速关联目录文件，为 AI 添加上下文，例如把某个源码文件直接作为参考喂给模型。

4. 交互体验

相比 Claude Code，OpenCode 几乎把命令行的交互体验拉满了，甚至像一个"伪装成命令行的桌面应用"：

• 点击任意消息会弹出消息动作框，可以撤回消息与 AI 的回复、复制内容，或者基于当前对话新开一个对话框；
• 可以通过鼠标上下滚动切换菜单，并直接点击进入下一步；
• 按Ctrl + p打开命令面板后可以开启侧边栏，界面随即呈现类似桌面 IDE 的布局（含对话列表、文件树等面板）。

5. LSP 支持

侧边栏中的LSP是 OpenCode 的一个关键技术特性。LSP（Language Server Protocol，语言服务器协议）是微软开发的一种通信协议，用于让代码编辑器和语言服务器之间进行通信。简单来说，LSP 就是让编辑器"看懂"代码的技术：在 VS Code 中输入console.会自动提示log、点击函数名能跳转到定义、写错代码会画红线提醒——这些编辑器功能背后都是 LSP 在工作。

OpenCode 支持 LSP，意味着 AI 能真正理解代码结构（函数在哪里被调用、引用了哪些变量），而不是把代码当普通文本进行全局瞎猜，因此代码修改更精准。例如让 AI 介绍项目中"最有价值的代码"时，LSP 能帮助 AI 快速定位某段代码的调用关系与变量引用，而不是低效地全局搜索文本。

6. 回到之前的会话

如果不小心关闭了 OpenCode，可以打开命令面板（Ctrl + p），选择 "Switch session" 切换会话，即可回到之前的聊天记录，无需担心上下文丢失。

桌面版 OpenCode

即使终端版交互已经足够出色，仍有不少开发者不喜欢"小黑框"。OpenCode 因此还提供了桌面应用版本，支持 macOS、Windows、Linux 全平台，下载地址为 https://opencode.ai/download。

需要说明的是，作者实测安装并打开桌面版时出现报错，排查后发现是本地开启了代理导致的，关闭代理后即可正常运行。但综合体验上，用惯了 Cursor 之后会觉得桌面版交互有些敷衍，作者并不推荐日常主力使用桌面版，终端版才是 OpenCode 的完整形态。

OpenCode 的扩展能力：兼容 Claude Code 的 Skills 系统

OpenCode 在前端用户体验上全面发力之余，还完全兼容 Claude Code 的Skills 系统。

Skills 是一种为 AI 准备的能力扩展包，可以理解为给"新同事"准备的工作交接文档，内部包含任务执行方法、工具使用说明、模板素材等。例如可以创建一个公司代码规范 Skill，把代码风格、命名规则、注释要求写进去，此后 AI 生成的代码就会自动遵循这些规范，无需每次重复说明。

根据官方文档，OpenCode 会自动搜索以下位置的 Skills：

这意味着如果你之前给 Claude Code 创建过自定义 Skills，可以直接拿来给 OpenCode 使用，又是一次无缝迁移。

Oh My OpenCode 增强插件

如果觉得 OpenCode 原生能力还不够强，可以尝试开源的 OpenCode 增强插件Oh My OpenCode（据文档记录已有 1 万 Star）。用户评价包括 "It made me cancel my Cursor subscription"（让我取消了 Cursor 订阅）、"Knocked out 8000 eslint warnings with Oh My Opencode, just in a day"（一天内解决了 8000 个 ESLint 警告）。

Oh My OpenCode 的核心功能是引入了一个名为Sisyphus的智能体编排系统（西西弗斯，希腊神话中因欺骗众神、挑战权威而被惩罚永无止境推石上山的国王，象征对荒谬命运的抗争精神）。这个系统提供：

1. 并行调度多个 AI 模型：例如让 GPT 负责 debug 的同时，让 Gemini 写前端代码；
2. 自动任务管理：不完成任务不停止，像西西弗斯推石头一样锲而不舍；
3. 智能代码审查：自动检测并清理 AI 生成的冗余注释；
4. LSP 深度集成：提供重命名、跳转定义等 IDE 级功能。

简单来说，Sisyphus 就是一个"AI 监工"，能同时指挥多个 AI 模型干活，并盯着它们把任务做完。

安装方面，虽然官方文档说一行命令即可完成安装，但作者建议先安装 bun，再执行 npx 安装，否则可能报错：

npm install bun -g npx oh-my-opencode install

安装过程中会询问是否拥有某些模型的订阅，按实际情况选择（作者一直选择 "No" 即可）。安装完成后重新进入 OpenCode，在提示词中加入ultrawork（或缩写ulw）这个激活咒语，即可开启全部增强功能：自动调度多个 AI 模型同时工作、深度探索代码库、锲而不舍地执行任务。

实战项目：用 OpenCode 开发 AI 健康助手

下面用一个全栈项目实测 OpenCode 的项目开发能力。参考蚂蚁集团爆火的"蚂蚁阿福"AI 健康助手（可通过拍皮肤、拍报告提供 AI 初诊，智能回答医学科普和治疗建议），做一个类似的"每日健康小助手"网站。

1. 技术方案：Vercel AI Gateway

项目包含前端 + 后端，后端需要调用 AI 大模型生成内容，这里选择用Vercel AI Gateway实现 AI 能力。

什么是 AI 网关？它就像火车站的检票口：应用的请求先经过网关，由网关统一处理认证、限流、监控等一系列复杂操作，再转发给 AI 大模型。据文档记录，Vercel AI Gateway 支持对接 500 多个大模型，且有免费额度，非常适合学习和小型项目。本仓库《Vercel AI 网关 - AI 减压小能手项目实战》中对 AI 网关有更系统的解释：你的应用只需发送标准请求给 AI 网关，网关会自动完成用户鉴权、限流控制、安全防护、故障转移、负载均衡、监控统计等操作，切换大模型只需修改请求中的模型名称，无需为每种模型各写一套对接代码。

操作步骤：

1. 注册登录 Vercel，在控制台创建 API Key（注意不要泄露）；
2. 启动 OpenCode，切换模型到编程能力强且免费的 GLM-4.7，输入开发提示词；
3. 将 API Key 提供给 AI，让它帮助启动项目；
4. 项目启动成功后，浏览器访问localhost:3000测试效果。

开发提示词原文如下：

你是一位专业的程序员，请帮我开发《每日健康小助手》网站，用户可以通过和 AI 聊天来记录和管理每日健康状态。 ## 开发要求 1. 需要包含完整的前端和后端，后端使用 Node.js 2. 使用 Vercel 的 AI Gateway 实现 AI 能力，需要先通过官方文档来获取用法：https://vercel.com/docs/ai-gateway/getting-started 3. 以完成核心功能为目标，确保项目可以正常运行 4. 整体网站界面采用清新的绿色健康风格，响应式适配各种尺寸的设备 5. AI 需要主动询问用户的健康状况，比如睡眠、运动、饮食等

点击发送后，OpenCode 会自动使用网页抓取工具读取 Vercel AI Gateway 的官方文档、学习最新用法。据作者实测，大约 5 分钟 AI 就完成了全部代码生成，并自动安装了依赖。

2. 排错过程：AI 网关调用反复失败

访问localhost:3000测试时报错：无法调用 AI。作者怀疑是 AI 对 Vercel AI Gateway 文档理解不到位导致调用代码写错，于是再次把文档输入给 AI 重试，结果依然报"缺少 API Key"——尽管 API Key 已提供。再次告知 AI"key 之前已经提供过了"后，经过大约 5 轮报错与修复，项目仍然无法正常运行。

排错要点：如果遇到调用 AI 网络超时的问题，可以让 AI 把调用的 baseURL 改为https://ai-gateway.vercel.sh/v1。

3. 对照组：Claude Code 修复同一问题

为了与 Claude Code 对比，作者把同一个问题交给 Claude Code 修复，提示词如下：

现在项目后端 AI 功能不可用 请参考 https://vercel.com/docs/ai-gateway/getting-started 文档 帮我修复后端，确保项目能正常运行

Claude Code 成功修复了问题，项目恢复正常运行。作者对比了两个工具的耗时：此前类似任务用 Claude Code / Cursor + GLM 不到 10 分钟即可完成，而这次 OpenCode 花了约 20 分钟、经历多轮来回拉扯才勉强可用。这一结果让作者开始怀疑 OpenCode 的项目级能力。

4. Ultrawork 模式实测

作者随后尝试用ultrawork（ulw）咒语激活多代理模式，进入"战斗状态"。此时可以查看子代理运行详情：先按Ctrl + x，再按方向键切换查看不同的代理；后台任务完成时会有提示，例如"研究 Vercel AI SDK 对话模式"任务完成。

但实测结果是：等待近 10 分钟后任务仍未结束，而且任务列表极其复杂，甚至引入了数据库。作者得出结论：这种不算太复杂的工作并不能发挥多代理的优势——就像你只是要打印一张纸，没必要发动全公司的人，有人研究纸张类型、有人研究打印机状态、有人研究打印姿势。

总结与选型建议

经过上述完整测试，作者对 OpenCode 保持观望态度：前端用户体验确实出色，但后端项目能力与 Claude Code 仍有差距；如果只追求前端使用方便，Cursor 可能是更成熟的选择。

不过 OpenCode 的成功说明了一个道理：谁离用户近、谁能发现痛点，谁就有超越巨头的机会。Claude Code 对中国用户的封禁给了开源社区一个绝佳机会，OpenCode 抓住痛点，用更开放的方式赢得了用户。虽然实际效果有待提高，但 OpenCode 完全开源免费，对喜欢折腾的程序员来说可定制性更强，甚至可以 fork 一份自行魔改。

结合本仓库《05 AI 命令行编程工具》中的选型框架，可以给出如下建议：

• 追求最强功能与最佳体验：选 Claude Code，其自主执行能力、Skills 支持、项目理解能力最强，适合专业开发者与复杂项目，但需要付费且国内需配置国产大模型 API；
• 想完全免费使用：选 OpenCode，开源、支持多模型切换、功能接近 Claude Code、无地区限制，适合预算有限的学生和个人开发者；
• 需要超长上下文分析大型项目：选 Gemini CLI，支持百万级 Token 上下文，且有免费额度；
• 需要更好的终端体验：选 Warp，将终端、编辑器和 AI 三合一；
• 已在用 GitHub Copilot：选 Copilot CLI，无缝衔接现有工作流。

命令行 AI 工具的生态仍在快速演进，本文的实测记录（对应仓库中的中文原版文档与英文翻译版）可作为工具选型的参考，更多同类工具的实测评测可参见00 AI 编程工具大全中的"命令行工具实测"专题。

• 文档
• 教程
• 知识库
• 人工智能