OpenCode 最被低估的部分，并不是它能不能为你写代码。
真正的问题是，它能否把重复的开发动作变成可复用的工作流。安装一次。配置模型。添加项目规则。然后使用 Skills 来定义某类任务应该如何处理。这样一来，AI 就不再像一个新队友，需要你一遍又一遍解释同样的上下文。
原文有一条清晰路径：先让 OpenCode 运行起来，然后配置 Skills。本文改写保留了这个结构，同时根据当前官方文档更新了安装配置逻辑。
对于 We0ai 这样的平台来说，这一点很重要，因为 AI 编码代理不只是用来写代码。它们可以帮助团队把网站、组件、SEO/GEO 页面和增长实验连接到更大的 Build -> Showcase -> Grow -> Leads 工作流中。
OpenCode 是什么：不是聊天窗口，而是终端里的 AI 编码代理
OpenCode 更适合被理解为面向开发者的 AI 编码代理。它可以在终端中运行，也可以通过桌面端和 IDE 相关体验使用。与普通聊天机器人相比，它更接近一个工程助手，能够读取项目、理解上下文、编辑文件并帮助调试。
这也是它与 Skills 搭配良好的原因。你不必每次都问“写这个函数”，而是可以为发布说明、SEO 页面审查、测试修复、拉取请求检查和代码审查定义可重复的行为。
步骤 1：安装 OpenCode
原图：OpenCode 官方安装入口。
原图：在 Windows Terminal 中使用 npm 全局安装 OpenCode。
原图：启动后的 OpenCode 终端界面。
官方文档将安装脚本列为最简单的起点。你也可以使用 npm、Bun、pnpm、Yarn、Homebrew 或其他包管理器安装 OpenCode。对于许多前端和全栈开发者来说，npm 仍然是最熟悉的入口。
# 推荐：官方安装脚本 curl -fsSL https://opencode.ai/install | bash npm install -g opencode-ai # 启动 opencode
Windows 用户需要注意环境。如果你的工作流依赖终端工具、依赖项、Git 和 shell 脚本，WSL 通常是更顺畅的选择。直接在 Windows 上运行也可以，但类 Linux 环境通常能减少路径和权限方面的摩擦。
步骤 2：连接一个模型，而不是盲目信任默认选项
原图：在 OpenCode 中查看和切换模型。
原图：选择模型后开始第一次对话。
模型选择是许多初次使用者容易卡住的地方。不要只按“免费”或“最强”来选择。先从你需要完成的工作类型出发。
官方文档建议在 TUI 中使用 /connect 来连接你的服务提供商。密钥配置完成后，打开一个项目目录并在那里启动 OpenCode。
# 在 OpenCode TUI 中连接服务提供商 /connect # 在项目中启动 cd your-project opencode
步骤 3：使用 opencode.jsonc 管理配置
默认设置足够用于快速测试。但如果你希望 OpenCode 成为长期工作流的一部分，配置文件就很重要。OpenCode 支持 JSON 和 JSONC 配置，并且可以组合使用全局配置和项目配置。
{ "$schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4-5", "autoupdate": true, "permission": { "edit": "ask", "bash": "ask" }, "instructions": [ "AGENTS.md" ] }
目标不是让配置看起来复杂。目标是让工作边界清晰：使用哪个模型，更新如何处理，哪些操作需要批准，以及必须读取哪些项目规则。
步骤 4：理解 Skills，可复用行为的核心
原图：官方 Anthropic Skills 仓库。
原图：一个中文社区的 Agent Skills 市场。
Skill 不只是另一个文件夹。它是供 AI 助手使用的可复用指令包。你描述某个特定任务应该如何被评判、执行和返回。然后 OpenCode 可以在有用的时候加载这种行为。
根据官方文档，OpenCode 会在项目级 .opencode/skills、全局 ~/.config/opencode/skills，以及兼容的 Claude / Agents skill 目录中搜索 Skills。
# 项目级 Skill your-project/ .opencode/ skills/ seo-page-review/ SKILL.md # 全局 Skill ~/.config/opencode/skills/ release-notes/ SKILL.md
一个最小化的 SKILL.md 通常需要 name 和 description。name 应该简短、小写，并使用连字符连接。description 应该足够具体，让 agent 知道何时加载它。
--- name: seo-page-review description: 审查一个展示型网站页面的 SEO、GEO、信任信号和线索转化。 compatibility: opencode --- ## 需要检查的内容 - 搜索意图和页面结构 - 信任信号和证明 - 线索获取路径 - 内部链接和转化清晰度
第 5 步：Windows 全局 Skill 配置
原图：Windows 用户目录下的 OpenCode skills 文件夹。
原图：skills 目录中的多个 Skill 文件夹。
原图：使用 skill list 检查已加载的 Skills。
原图：OpenCode 自动匹配 frontend-design Skill。
原图：Skill 触发后生成的页面代码和结构化输出。
原图：OpenCode 生成的最终网页预览。
原文重点讲的是 Windows 上的全局 Skill 配置。这个思路很有用：如果每个项目都应该使用同一个 Skill，就把它放在用户级目录中。如果该 Skill 只用于某一个项目，就把它保留在项目级。
一个简单的规则很有帮助：如果 Skill 代表团队知识，就把它和代码仓库放在一起。如果它只是你的个人习惯，就把它放在全局。
第 6 步：不要随意混用 AGENTS.md、Skills 和配置文件
许多团队把所有内容都塞进一个混乱的指令文件中。这会让助手更难控制。更清晰的设置方式是拆分职责。
简而言之：AGENTS.md 用于长期项目规则，Skills 用于具体的可重复任务，而 opencode.jsonc 用于运行时配置。
OpenCode 与 We0ai：构建层遇上增长层
OpenCode 主要帮助处理构建层：代码、重构、脚本、项目规则和可复用的开发工作流。We0ai 专注于展示与增长：将产品、服务、案例、模板、内容以及 SEO/GEO 页面转化为展示型网站，让它们能被发现、被 AI 搜索理解，并转化为线索。
它们并不是彼此的替代品。一个实用的做法是使用 OpenCode 改进开发和内容工程工作流，同时使用 We0ai 将最终网站转化为面向用户和搜索流量的增长资产。
最终要点
OpenCode 并不难安装。真正的问题是你是否把它当作一个长期工作流工具来使用。
如果你只是安装它，你会得到一个 AI 编码助手。如果你配置模型和权限，你会得到一个更稳定的项目助手。如果你善用 Skills、AGENTS.md 和 opencode.jsonc，你会得到一个可复用、可跨项目迁移、并可由团队共享的 AI 开发系统。
对于构建展示型网站、SEO/GEO 页面、产品案例页面和增长实验的团队来说，这一点很重要。网站增长并不会止步于页面生成。它需要代码、内容、组件和工作流持续改进。
这也是 We0ai 背后的逻辑：构建 -> 展示 -> 增长 -> 线索。构建资产，展示价值，提升可见度，并将关注转化为线索和客户。
CTA：如果你的网站需要做的不只是上线，请将开发工作流和展示增长路径一起设计。
常见问题
什么是 OpenCode？
OpenCode 是面向开发者的 AI 编程代理。它可在终端中帮助进行代码理解、编辑、生成和项目协作。
如何安装 OpenCode？
你可以使用官方安装脚本，或通过 npm install -g opencode-ai 进行安装。
OpenCode Skills 有什么用途？
Skills 会打包可复用的任务说明，例如代码审查、SEO 页面审查、发布说明和测试修复工作流。
Skills 应该放在哪里？
常见路径包括 .opencode/skills/<name>/SKILL.md 和 ~/.config/opencode/skills/<name>/SKILL.md。
AGENTS.md 和 SKILL.md 有什么区别？
AGENTS.md 更适合长期项目规则，而 SKILL.md 更适合特定的可重复任务工作流。
这与 We0ai 有什么关系？
OpenCode 支持构建层，而 We0ai 支持展示和增长。二者结合可以连接代码、内容、SEO/GEO 和线索转化。
相关工具
- OpenCode
- Node.js
- npm
- We0ai
来源
