企业官网建设流程全解析

OpenCode 安装教程：5 分钟装好终端 AI 编程代理

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

OpenCode 是一款开源的 AI 编程代理（coding agent），运行在终端里。装完之后，你在任意项目目录运行opencode，就能让 AI 帮你读代码、改文件、执行命令，内置免费模型，开箱即可用。这篇 OpenCode 安装教程带你走一遍完整流程，全程大约 5 分钟。

环境准备与前置条件

• 系统：Linux / macOS / Windows（Windows 建议用 WSL），CPU 为 x64 或 ARM64
• 一键安装方式不要求任何编程语言环境，有终端即可
• 终端为 bash、zsh 或 fish 均可，脚本会自动识别

OpenCode 一键安装命令

在终端里直接运行：

curl -fsSL https://opencode.ai/install | bash

脚本会依次做四件事：识别你的操作系统和 CPU 架构，下载对应的二进制文件（默认装到~/.opencode/bin），把该目录写入 shell 配置文件的 PATH，最后打印出 OpenCode 的 logo 和两行提示——先cd进项目目录，再运行opencode。看到这段输出，说明安装已经完成。

OpenCode 其他安装方式

如果你习惯用包管理器，任选其一即可，效果与脚本安装相同：

npm i -g opencode-ai@latest

macOS 和 Linux 也可以走 Homebrew：

brew install anomalyco/tap/opencode

OpenCode 安装验证与首次运行

先确认命令可用：

opencode --version

输出一个形如0.x.x的版本号，即验证通过。

然后进入你的项目目录，启动第一次会话：

cd 你的项目目录 opencode

首次启动时，它会引导你选择模型供应商并配置 API 密钥；不想配密钥的话，直接用内置的免费模型即可开始对话。

OpenCode 安装失败自查清单

• 提示command not found: opencode：PATH 没生效。开一个新终端窗口再试；仍不行的话手动执行export PATH=$HOME/.opencode/bin:$PATH，并用which opencode确认指向的是新装的路径
• 装了旧版本导致行为异常：官方建议先卸载 0.1.x 之前的旧版（例如npm uninstall -g opencode-ai），再重新安装
• 脚本报Unsupported OS/Arch：目前只支持 Linux / macOS / Windows 的 x64 与 ARM64 组合，其他架构请改用源码方式构建

安装完成后，下一步建议：浏览仓库内的 docs/ 目录了解 agent、权限和模型配置的具体用法；试一下用 Tab 键在 build（可写）和 plan（只读）两种模式间切换；遇到疑难问题时到项目对应的 Discord 社区提问。

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