企业官网建设流程全解析

OpenCode 安装与配置指南：终端 AI 编程助手如何装好、配好、跑通

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

OpenCode 是一个开源的终端 AI 编程助手（coding agent），直接运行在命令行里：给它任务，它能读项目、改代码、执行命令，并支持在不同模型提供商之间切换。这篇文章带你完成三件事：把 OpenCode 装到机器上，验证安装是否成功，配置好 API Key 跑通第一次使用；最后整理常见报错的排查路径。

开始之前，先确认这 3 点

不需要预装任何依赖，但建议先花 30 秒核对环境：

另外有一条官方提醒：如果机器上装过 0.1.x 之前的旧版本，先卸载干净再装新版，避免新旧二进制互相冲突。

安装：按平台选一条路径

默认推荐：一键脚本

这条命令会自动下载并安装最新版 OpenCode，路径配置也一并处理，无需其他操作：

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

用包管理器安装

如果你更习惯走包管理器，按平台选对应命令即可：

想控制安装位置？

安装脚本按以下优先级决定装到哪里：$OPENCODE_INSTALL_DIR→$XDG_BIN_DIR→$HOME/bin→ 默认的~/.opencode/bin。需要装到系统级目录时，在命令前显式指定即可：

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

桌面应用（Beta，可选）

OpenCode 也提供桌面客户端，覆盖 macOS（dmg）、Windows（exe）和 Linux（deb / rpm / AppImage），例如brew install --cask opencode-desktop。日常在终端里工作不受影响，桌面版属于可选项。

验证安装：两条命令确认成功

第一条确认二进制可用、并查看当前版本号：

opencode --version

第二条列出可用命令和参数，顺便熟悉一下 CLI 结构：

opencode --help

能打印出版本号即说明安装成功；如果提示 command not found，直接跳到文末的排查一节。

配置 API Key：OpenCode 怎么连上模型

OpenCode 本身不内置模型，需要接一个提供商的 API Key。以最常见的 Anthropic 和 OpenAI 为例，通过环境变量传入：

export ANTHROPIC_API_KEY=你的密钥 export OPENAI_API_KEY=你的密钥

临时 export 只对当前 shell 生效。想让之后打开的每个终端都能读到，把导出语句写进 shell 配置文件（bash 用~/.bashrc，zsh 用~/.zshrc），然后重载：

echo 'export ANTHROPIC_API_KEY=你的密钥' >> ~/.bashrc source ~/.bashrc

第一次使用

在项目目录下直接启动：

opencode

启动后进入交互式终端界面：上方是 AI 的回复和代码 diff，下方是输入框。内置两个 agent，用Tab键切换：

• build：默认模式，具备完整的读写与执行权限，适合直接开发；
• plan：只读模式，默认不改文件、执行 shell 命令前会先询问，适合先摸清陌生代码库的结构再动手；
• 遇到复杂的多步检索任务，可以在消息里用@general调用 general 子 agent。

换用其他模型提供商时，用--provider参数指定，例如：

opencode --provider openai

遇到问题，按这个顺序排查

opencode: command not found

先确认它装到了哪里：默认目录是~/.opencode/bin，或你通过OPENCODE_INSTALL_DIR指定的目录。确认路径存在后，把它加进 PATH 并重载配置：

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

安装过程异常中断

按顺序检查三项：网络是否稳定（脚本需要联网下载）；磁盘剩余空间是否足够；是否残留了 0.1.x 之前的旧版本。

模型调用失败或提示无权限

依次确认：Key 在当前 shell 是否已生效（echo $ANTHROPIC_API_KEY能看到值）；Key 复制是否完整；--provider指定的提供商与所持 Key 是否匹配。

维护建议

• 升级：重跑一遍上文的一键安装脚本即可拉到最新版，装完用opencode --version对比版本号；
• 按任务复杂度选模型：日常补全和分析用轻量快速的模型，复杂重构再切更强的模型；
• 提供商尽量选网络延迟低的，响应体感差异会比较明显。

到这里安装、验证、模型配置和排查路径都已就位，可以直接在任意项目目录里运行opencode开始干活了。

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