企业官网建设流程全解析

OpenCode 终端 AI 编程助手：3 步装好，5 分钟出第一版代码

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

在终端里改代码、跑测试、查 bug，不用切到 IDE 插件或网页——OpenCode 是开源的终端 AI 编程助手，能直接读你的项目、改你的文件。下面用最短路径把它跑起来，再看 3 个高频场景和报错解法。

OpenCode 安装：最快路径 3 步跑起来

1. 全局安装（npm 最通用，也支持 bun/pnpm/yarn）：

npm i -g opencode-ai@latest

2. 进入你的项目目录：

cd /path/to/your-project

3. 运行opencode，按提示选提供商和模型，直接输入第一条需求。

其他途径一行带过：brew、scoop、pacman 与仓库根目录的一键脚本 install 效果相同；源码党用bun install+bun dev即可。

能帮你做什么：改代码、审代码、查问题

改代码。默认的 build agent 能读文件、改文件、跑命令，动手前会展示 diff 等你确认。 示例指令：把 src/utils/format.ts 里的同步逻辑改成异步，并跑通现有测试。

审代码。按 Tab 切到 plan agent：只读模式，不改文件，跑命令前先征求同意，适合摸陌生仓库或规划改动。 示例指令：帮我梳理 packages/core 里 session 的运行流程，先别改任何文件。

查问题。agent 可以执行命令、读日志来定位故障。 示例指令：跑一遍 bun test，找出失败的 case 并给出修复建议。 多步检索时加@general调用子 agent，例如：@general 找出所有写死了 localhost 的文件。

踩坑实录：高频报错一句话解法

• 现象：终端提示opencode: command not found→ 原因：安装目录不在 PATH 里 → 解法：重开一个终端，或把安装目录加进 PATH。
• 现象：agent 只读文件、拒绝改代码 → 原因：当前是只读的 plan agent → 解法：按 Tab 切回 build agent。
• 现象：opencode serve报端口被占用 → 原因：默认 4096 端口已被其他服务占用 → 解法：换端口，opencode serve --port 8080。

去哪继续

• 文档源码在 packages/docs/，配置、agent、插件都有专门章节。
• 想读核心实现，从 packages/opencode/src/ 看起，TUI 代码在 packages/opencode/src/cli/cmd/tui/ 下。
• 想提 PR，先看 CONTRIBUTING.md：所有 PR 必须先关联一个 issue。

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