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 和配置文件

Gratuit · Utiliser We0 AI

Creez un site vitrine et genere des leads en quelques minutes

Decrivez votre idee une fois, et We0 AI peut generer un site vitrine, des pages et un CMS, puis vous aider a attirer clients et trafic apres le lancement.

Une génération de projet complète pour une inscription gratuite

Idéal pour essayer un flux de génération complet et voir rapidement une première ébauche de projet.

Sans titre-1