企业官网建设流程全解析

如何 5 分钟装好 OpenCode：终端 AI 编程助手新手完整教程

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

如果你也遇到过这种时刻：调试正到关键处，想叫 AI 帮忙重构一整个模块，又不想离开终端——OpenCode 就是为这个场景做的。它是一个开源的 AI 编码代理，全程跑在命令行里，支持 Anthropic、OpenAI、Google 等多家模型服务自由切换，还内置 build / plan 双工作模式。这篇 OpenCode 安装教程会带你从零跑通安装、验证和模型配置，全程不超过 5 分钟。

安装前先确认门槛

最快的一条安装命令

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

脚本会自动识别系统和架构、下载对应二进制，默认装到$HOME/.opencode/bin，并顺手把 PATH 写进 shell 配置，基本零干预。想自定义安装目录时，加一个环境变量即可：

OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

更稳妥的备选：用包管理器装

包管理器版本更新节奏因源而异，macOS/Linux 上推荐带 anomalyco tap 的 brew 源，基本保持最新：

npm i -g opencode-ai@latest # bun、pnpm、yarn 同样可用 brew install anomalyco/tap/opencode # macOS / Linux scoop install opencode # Windows

装完立刻验证：三条命令

opencode --version # 应输出版本号，如 1.x.x opencode --help # 应能看到 providers、serve 等子命令

版本号能正常打印，安装就算完成。接着重开一个终端，进入任意项目目录直接运行opencode，能看到交互式界面就彻底没问题了。

API Key 一次配好，所有项目生效

两种方式任选其一：

交互式保存（推荐）：

opencode auth login

按提示选择服务商并粘贴密钥，凭证会写入全局数据目录（auth.json），一次配置，之后所有项目、所有会话都直接可用，不用重复登录。运行opencode auth list可查看当前已保存的凭证清单。

环境变量方式：

export ANTHROPIC_API_KEY=你的密钥 # 或 OPENAI_API_KEY 等

把这一行追加到~/.bashrc或~/.zshrc即可长期生效。注意：env 凭证和 auth.json 是两套独立体系，任一生效即可，opencode auth list会同时列出两者。

上手之后：先让它干这 4 件事

1. 直接改代码（build 模式）

默认进入的就是 build 代理，具备完整读写权限。打开opencode后直接说"给这个函数加上参数校验并更新测试"，它会自动改文件、跑命令、展示变更结果。

2. 先分析、不动文件（plan 模式）

按Tab切到 plan 代理：它默认拒绝修改文件，执行 shell 命令前会先征求同意，特别适合初次接触陌生代码库、拿重构建议时使用。

3. 用 @general 调查深层问题

需要跨多文件、多步骤检索时，消息开头加@general，内置子代理会接手复杂调查并给出汇总结论。

4. 合并前的质量检查

让它跑一轮"review 一下当前改动，列出风险点和缺的测试"——只读、不改文件，用 plan 模式做这件事最干净。

踩坑 Q&A：高频卡点一次说清

Q：安装中途报错或下载失败？重跑同一条 curl 命令即可；如果网络持续不稳定，换上面的 npm / brew 包管理器路线绕开脚本下载。

Q：提示 opencode 命令找不到？默认安装位置是$HOME/.opencode/bin，把它补进 PATH 并重新加载：

echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc source ~/.bashrc

Q：想装指定版本而不是最新？

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

Q：配了 Key 却提示未认证？先跑opencode auth list看凭证是否真的在列——常见原因是环境变量写进了.profile而当前 shell 读的是.bashrc，两边没对上。

接下来做什么

1. 在当前项目里运行opencode，先问它"读一下 README，讲讲这个项目的结构"
2. 按Tab切到 plan 模式，提一个只读的分析需求，感受两种模式差异
3. 打开 官方文档 看配置与插件选项，按自己的习惯微调

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