企业官网建设流程全解析

引言

如果你在寻找一款轻量级、高自由度、能够无缝融入终端与现有开发工作流的开源利器，那么 Opencode 就值得你加入工具箱。很多初次接触的朋友可能会问：Opencode 到底是什么？它能解决哪些开发痛点？又该如何快速在本地跑起来？ 本文将带你从零开始，一次性搞定 Opencode 的概念解析、下载安装与实战使用，助你轻松打造效率翻倍的工作系统。

概念篇

1.什么是OpenCode

Opencode是一款开源 AI 编程代理(编程助手/编程智能体)，它提供终端界面、桌面应用、网页端和 IDE 扩展等多种使用方式，在这里推荐大家使用终端界面，可以单独使用，也可以在各种IDE和编辑器中直接嵌入使用。它和 Claude Code、Cline、Gemini CLI 是同一类工具。Opencode 内置免费模型，或者你能连接任意提供商的任意模型，包括 MiniMax，GLM，Claude, GPT, Gemini 等。

1.1.为什么选择OpenCode

它是一款开源 AI 编程代理，不需要神秘力量，普通人就能上手使用；默认支持语言服务器协议（LSP），在终端上看到的代码都有语法高亮；提供免费的模型接入，使用成本低；学会使用它，其他智能体也能轻易上手。

2.什么是编程代理

这里简单介绍一下编程代理的概念及功能：
编程代理是指能通过内部配置的大语言模型来理解我们的自然语言，帮我们做一些程序开发的辅助工作的助手，具有如下能力：

• 代码阅读与理解：分析代码库结构、理解代码逻辑。
• 编写和修改代码：添加功能、修复 bug、重构代码。
• 搜索与定位 ：在大型代码库中快速找到相关文件和代码。
• 执行命令：运行 git、npm、python、gcc 等开发工具。
• 调试问题：定位问题根源并提供修复方案。
• 代码审查：检查代码质量、提出改进建议。
• 项目探索：了解陌生项目的架构和依赖。

在看过其作为助手的能力后，相信你已准备好使用它提升工作效率了。

实操篇

1.OpenCode的安装、打开和退出

Opencode的官网：进入官网
可以看到有几种安装方式，我们选择 npm 安装；如果你没有配置该环境，那花两分钟了解并配置好这个环境，会让你在后续使用各类前沿 AI 命令行工具时事半功倍。
✳️Node.js 与 npm 简介：
Node.js是一个开源、跨平台的 JavaScript 运行时环境。过去 JavaScript 只能在浏览器运行，而 Node.js 让它能够直接在你的操作系统底层运行，具备了直接读写本地文件、执行系统终端命令以及发起高并发网络请求的能力。
npm是随 Node.js 一起自动安装的官方包管理工具。它连接着全球最大的开源软件注册表，让我们只需一行简单的终端命令，就能全自动完成工具的下载、依赖解析与环境变量配置。

1.1.Node.js的安装

首先点击Node.js的官网：进入官网
然后选择你使用的平台，并点击安装按钮：

下载完成后，点击打开文件：

进入安装程序后，点击 next，勾选协议，选择安装路径，并一路点击 next：

1.1.1.检查是否安装成功

分别输入如下指令检查 Node.js 和 npm 的版本，显示版本代表安装成功：

//检查Node.js的版本node-v//检查npm的版本npm-v

当返回结果是这样，无需担心：

这只是系统环境变量的配置问题导致的，通常情况是因为你修改了 Node.js 安装路径中的任意文件夹名称，以至于下载时自动添加的环境变量地址失效了，直接问 AI “如何添加Node.js的系统环境变量？”即可解决。

1.1.2.切换国内源加速安装

由于 npm 默认源在海外，下载速度可能较慢。建议在安装 Opencode 前先执行一行命令切换为国内淘宝镜像源，下载体验直接拉满。

npmconfigsetregistry https://registry.npmmirror.com

1.2.一行命令安装OpenCode

得益于 npm 的强大功能，我们只需在终端输入该指令即可完成安装。

npmi-gopencode-ai

1.2.1.检查是否安装成功

我们依然使用显示版本号的方式检查：

opencode-v

1.3.打开OpenCode

在终端中输入 opencode 后最大化窗口就是它的终端界面，默认操作的路径是终端当前所在的路径：

或者也可以在电脑上找到合适的路径打开终端，让它在该目录下工作：

输入对话后，它的工作区呈现：

1.4.退出OpenCode

除了输入对话以外，它还有一些以 / 开头的常用指令：

在对话框中输入 / 后，它自动的弹出了一些指令；输入 /exit 可以退出。
下面我们分别来学习一下这些常用指令的作用。

2.OpenCode常用指令

2.1./models切换模型

🔶在Opencode的对话框输入 /models 回车后即可选择模型：

2.2./connect链接供应商

🔶在Opencode的对话框输入 /connect 回车后即可链接模型：

已链接的模型在其左侧有一个✅，连接方式如下：
通过各个模型厂商的网站获取API，以谷歌为例，点击你想选择的模型，通过该模型的 API 连接，通过 Google AI Studio 获取官方 API Key，然后通过 Opencode 的终端界面完成绑定。

2.3.切换工作模式

🔶Opencode中有两种类型的代理：主代理和子代理。Plan 和 Build 是主代理，在键盘上按Tab就能切换两个模式。

2.3.1.Plan Agent (规划代理)

在该模式下，Opencode默认停用一切修改本地文件和执行破坏性命令的权限（保持只读状态）。它的核心任务是深入读取你的代码库、分析跨文件依赖关系、定位问题根源，并用自然语言为你输出一份结构化的实施计划或设计方案，使你可以毫无心理负担地与它反复推敲方案，不用担心本地代码被意外篡改。

2.3.2.Build Agent (构建代理)

这是Opencode的实战执行模式，拥有完整的文件读写与终端命令调用权限。它会严格遵循你们在 Plan 阶段敲定的技术路线，自动创建新文件、生成代码 并写入修改，甚至主动运行测试脚本来验证代码是否能跑通。
✨这种"先规划、再执行"的设计确保了开发流程的规范性和代码质量的可靠性。

还有其它两个子代理，其可以通过@符呼出：

其实它还内置了一些隐藏的子代理，点击进入官网查看详细信息。
官网中说：“子代理是主代理可以调用来执行特定任务的专业助手。您也可以通过在消息中 @ 提及它们来手动调用。”

2.4./init和AGENTS.md

🔶/init 命令用于创建和更新AGENTS.md文件。
第一次执行 /init 时，它会扫描你工作目录下的项目及其所有内容，了解项目的用途、项目结构、代码规范、项目类型等，并据此生成一个AGENTS.md文件，帮助Opencode更好的做好代理的工作。
注：如果已有AGENTS.md文件，该命令会尝试在其基础上进行补充。
AGENTS.md文件的作用如下：

• 保存项目上下文 - 记录项目结构、构建命令、测试命令等。
• 帮助AI快速上手 - 未来新对话时无需重复说明项目信息。
• 定义项目的规范 - 代码风格、命名约定、错误处理等。

例如在我的扫雷项目目录中打开Opencode，输入 /init：

它就会在该目录下生成一个AGENTS.md文件：

Opencode还支持从多个位置读取AGENTS.md文件以用于不同的用途。
🔹项目级：在项目根目录放置一个AGENTS.md文件，用于定义项目特定的规则，这些规则仅在该目录或其子目录中工作时生效。
🔸全局级：在 ~/.config/opencode/AGENTS.md 文件中设置全局规则，这些规则会应用于所有的Opencode对话。
注：Opencode启动时会自动加载 ~/.config/opencode/AGENTS.md 文件，将其作为系统级指令注入到对话上下文中。

2.5./new和/sessions

🔶输入 /init 开始新对话；输入 /sessions 可以选择历史对话。
之前历史对话记录只是当前目录的局部记录，例如在 D 盘打开并使用Opencode后，输入 /sessions 和在 E 盘打开并输入 /sessions 呈现的并不是同一份记录。

但在更新到最新版本后，无论打开哪个目录都会显示全部对话记录，并且按时间排序，按 Ctrl + a 只显示当前目录下的记录。

2.6.文件引用与bash命令

可以使用 @ 在消息中引用文件，这会在当前工作目录中进行模糊文件搜索，然后自动阅读文件内容执行任务；例如在刚才演示的扫雷目录中输入：

得到分析结果：

在对话框中执行 Bash 命令：
Opencode将以 ! 开头的消息作为 shell 命令执行，例如输入 ls：

得到统计结果：

2.7.其余命令

• /undo：撤销修改。
• /redo：重做修改。
• /share：生成当前对话的链接并复制到剪贴板。
• /theme：切换主题。

2.8.卸载OpenCode

直接在终端中输入指令：opencode uninstall

通过方向键选择 Yes 或 No 后，自动完成卸载。

3.OpenCode更新

当出现新版本时，它会出现如图中的提示，点击提示：


更新成功后会出现一个提示，此时继续点击橙色选项后，会退出到传统终端界面；再次输入 Opencode 打开后，会看到新版本的介绍：

更新成功.jpg

4.关于API的付费问题

以图中为例，当我使用一个免费层级的模型问问题时，为什么 Opencode 的右上角会提示我花费了0.01美元？
答：这是因为 Opencode 并不知道我的 Key 是免费版还是付费版，它内部有一张写死的公开价格表（包含各个模型每百万 Token 的官方刊例价）。只要有 Token 消耗，Opencode 就会自动用 [消耗的 Token 数 × 官方单价] 算出一个参考金额显示在界面上(四舍五入后显示为 $0.01)。因此这是 Opencode 本地内置的“预估计费计算器”算出来的虚拟数字。

4.1.如何确定自己100%亿会被扣费

1. 在 API 开发者后台（Billing 页面）绑定了信用卡，且将账户升级为了 Pay-as-you-go(按量付费，以Google为例)。

2. 在国内云厂商（阿里云、腾讯云等）开通了大模型服务，且账户里有现金余额或开通了先用后付，并调用了非免费额度的商业模型。

3. 在预付费平台主动充值了真金白银（此时会优先扣除你充值的余额）。

🪄最后说明一下，通常来说 AI 的网页版/App端会员和开发者 API 是完全独立的计费体系，两者互不影响。

附录：常见踩坑

Windows 用户必看：OpenCode显示异常

CMD / PowerShell 默认搭载的传统控制台宿主（conhost.exe） 是导致 OpenCode 界面出现了典型的终端字符编码与字体渲染异常的根本原因：

解决方案

换用现代终端宿主 Windows Terminal，直接使用微软官方推出的现代终端 Windows Terminal 运行 PowerShell 或 CMD，它采用全新的 DirectWrite 渲染引擎，原生完美支持 OpenCode 的所有像素块和真彩色渲染。
1.使用自带的 PowerShell 运行以下命令一键安装：

wingetinstallMicrosoft.WindowsTerminal

2.按 Win + R 打开运行窗口，输入 wt 并按回车。
3.在 Windows Terminal 中启动Opencode即可解决。

⚛️EL PSY CONGROO，十分感谢你的阅读

本期不确定：
要补充一些实战教程吗