文档教程知识库人工智能【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址https://gitcode.com/GitHub_Trending/aig/ai-guide点击查看免费下载在 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 长期存在的两大门槛网络与账号门槛使用 Claude Code 必须依赖特殊网络环境并持有官方账号否则终端中只会出现一片报错红字对国内用户非常不友好。企业级封禁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 一份自行魔改。下面从安装配置开始完整走一遍实操流程。从零上手 OpenCode1. 安装与首次运行打开 OpenCode 官网复制官方提供的一行安装命令在终端执行即可curl -fsSL https://opencode.ai/install | bash安装完成后在终端输入opencode进入程序。首个经典 Hello World 测试中AI 成功给出了回复。至此OpenCode 的基础使用已经掌握了七成——因为后续绝大多数操作都可以通过内置命令面板完成。2. 选择模式与模型OpenCode 支持2 种工作模式模式用途切换方式Build 模式默认构建应用、生成代码默认启用Plan 模式生成执行计划按Tab键切换按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 CodeOpenCode 几乎把命令行的交互体验拉满了甚至像一个伪装成命令行的桌面应用点击任意消息会弹出消息动作框可以撤回消息与 AI 的回复、复制内容或者基于当前对话新开一个对话框可以通过鼠标上下滚动切换菜单并直接点击进入下一步按Ctrl p打开命令面板后可以开启侧边栏界面随即呈现类似桌面 IDE 的布局含对话列表、文件树等面板。5. LSP 支持侧边栏中的LSP是 OpenCode 的一个关键技术特性。LSPLanguage 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搜索路径目录层级.opencode/skill/name/SKILL.md项目目录~/.config/opencode/skill/name/SKILL.md用户目录.claude/skills/name/SKILL.mdClaude Code 兼容~/.claude/skills/name/SKILL.mdClaude Code 兼容这意味着如果你之前给 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的智能体编排系统西西弗斯希腊神话中因欺骗众神、挑战权威而被惩罚永无止境推石上山的国王象征对荒谬命运的抗争精神。这个系统提供并行调度多个 AI 模型例如让 GPT 负责 debug 的同时让 Gemini 写前端代码自动任务管理不完成任务不停止像西西弗斯推石头一样锲而不舍智能代码审查自动检测并清理 AI 生成的冗余注释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 网关网关会自动完成用户鉴权、限流控制、安全防护、故障转移、负载均衡、监控统计等操作切换大模型只需修改请求中的模型名称无需为每种模型各写一套对接代码。操作步骤注册登录 Vercel在控制台创建 API Key注意不要泄露启动 OpenCode切换模型到编程能力强且免费的 GLM-4.7输入开发提示词将 API Key 提供给 AI让它帮助启动项目项目启动成功后浏览器访问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 已提供。再次告知 AIkey 之前已经提供过了后经过大约 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 模式实测作者随后尝试用ultraworkulw咒语激活多代理模式进入战斗状态。此时可以查看子代理运行详情先按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 编程工具大全中的命令行工具实测专题。赞分享文档教程知识库人工智能【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址https://gitcode.com/GitHub_Trending/aig/ai-guide点击查看免费下载相关推荐OpenCode 深度实测开源免费的 AI 命令行编程工具安装、配置与全栈实战指南OpenCode 深度实测开源免费的 AI 命令行编程工具安装、配置与全栈实战指南 本文是 OpenCode开源免费的 AI 命令行工具实测 https:/文档教程知识库人工智能OpenCode 实测指南开源免费的 AI 命令行编程工具从安装到全栈实战ai-guide Vibe Coding 教程OpenCode 实测指南开源免费的 AI 命令行编程工具从安装到全栈实战ai guide Vibe Coding 教程 本篇技术指南以鱼皮 AI 指南文档教程知识库人工智能Doctrine ORM 安装与配置实战从 Composer 安装到 EntityManager 与命令行工具Doctrine ORM 安装与配置实战从 Composer 安装到 EntityManager 与命令行工具 本指南以 Doctrine ORM 仓库中的数据库ORM后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考