企业官网建设流程全解析

五步跑起 OpenCode：在终端里用开源 AI 编程助手

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode

凌晨想修一个小 bug，IDE 索引还没建好；只想看一个函数的调用链，却得自己翻五个文件。OpenCode 是一个开源的 AI 编码智能体（coding agent）：你在终端里描述需求，它去读代码、改文件、跑测试。这篇文章面向新手，五步就能完成第一次 AI 辅助修复。

工作原理：TUI 和服务器是怎么分工的

OpenCode 把终端界面（TUI）和核心逻辑拆成两部分。你在 TUI 里输入需求，服务器端接管：选择模型供应商，把对话发给大模型，再按模型指示在项目里执行文件读写和 shell 命令（即"工具"），把结果写回界面。它还能用opencode serve暴露成 HTTP API，供其他设备远程接入。服务器实现 可以看到分工细节。

快速上手：从安装到第一次修复 ⌨️

第 1 步：安装。macOS、Linux、Windows 都可以。

npm i -g opencode-ai@latest # macOS/Linux 也可: brew install anomalyco/tap/opencode

第 2 步：配置模型凭据。OpenCode 对接多家模型供应商，配置一次即可：

opencode auth login

完成后用opencode auth list核对，密钥保存在~/.local/share/opencode/auth.json。

第 3 步：在项目目录启动界面。进入项目运行opencode，出现 TUI 界面，底部输入框即可输入需求。

第 4 步：选模式。按 Tab 切换智能体：plan 是只读模式，适合先读代码；build 是默认模式，能改文件、跑命令。

第 5 步：提第一个需求。输入"读一下 src/utils.ts，说明校验函数的流程"，智能体开始逐行读文件并回答。

典型用法：3 个马上能用的场景

场景一：用 plan 智能体探索陌生代码库

• 你做了什么：按 Tab 切到 plan，输入"订单模块的入口在哪，涉及哪些文件？"
• 界面出现什么：智能体逐个列出文件、给出调用链；它不改任何文件，跑命令前会先征求同意
• 得到什么结果：两三分钟拿到一张结构地图，不用担心它顺手改坏代码

场景二：让 build 智能体直接修掉失败的测试

• 你做了什么：切到 build，输入"test/login.test.ts 挂了，找出原因并修复"
• 界面出现什么：它读测试文件、定位问题断言、编辑源文件、重跑测试，每次改动都在界面里显示 diff
• 得到什么结果：测试变绿，你审完 diff 即可直接提交

场景三：远程机器上跑，别的设备连

• 你做了什么：在远程开发机上运行opencode web --port 4096 --hostname 0.0.0.0（端口被占就换--port）
• 界面出现什么：另一台设备用浏览器打开http://<服务器地址>:4096即可使用；本机 TUI 也能用opencode attach接上远程后端
• 得到什么结果：不在工位也能查看和续上刚才的修复会话

避坑清单：4 个高频问题 📋

• 症状：运行opencode提示没有可用模型。原因：没配置供应商凭据。解法：跑opencode auth login填密钥，再用opencode auth list确认。
• 症状：让它改代码，它却拒绝动文件。原因：当前在 plan 模式，默认只读。解法：按 Tab 切到 build，或用opencode agent create自定义权限。
• 症状：opencode serve起不来，报端口占用。原因：默认端口被其他进程占用。解法：加--port 4100换个端口。
• 症状：升级后命令报错、行为与文档不符。原因：旧版本（0.1.x 以下）还留在系统里。解法：先移除旧版本再重装，官方 README 明确给了这条提示。

下一步：5 分钟感受差别

OpenCode 给你在终端里多了一双会读代码、会改代码、还每一步都让你过目的手。打开你最常改的那个项目的终端，运行opencode，让它讲一个你一直想搞懂的模块；想继续看高级选项，可以查项目内的 CLI 文档。

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode