什么是 OpenCode
OpenCode 是一款开源的 AI 编程助手，在 GitHub 上获得了超过 150K 的星标。它提供了三种使用方式：
- Terminal (TUI)：终端界面，适合喜欢命令行的开发者
- Desktop：桌面应用，提供图形化界面
- IDE Extension：VS Code 等 IDE 插件
本文以 Terminal 版本为主线，介绍从零开始使用 OpenCode 的完整流程。
安装方式
方式一：curl 一键安装（推荐）
最简单的方式是使用官方安装脚本：
curl -fsSL https://opencode.ai/install | bash这个脚本会自动检测你的操作系统和架构，下载对应的二进制文件并放到合适的位置。
方式二：npm 安装
如果你已经安装了 Node.js，可以通过 npm 安装：
npm install -g opencode方式三：Homebrew（macOS/Linux）
brew install opencode方式四：手动下载
访问 https://github.com/anthropics/opencode/releases 下载对应平台的二进制文件。
验证安装
安装完成后，运行以下命令验证：
opencode --version如果输出版本号，说明安装成功。
配置 LLM Provider
OpenCode 需要连接 LLM 服务才能工作。首次运行时会引导你完成配置：
opencode你可以选择以下 Provider 之一：
| Provider | 所需环境变量 |
|---|---|
| Anthropic Claude | ANTHROPIC_API_KEY |
| OpenAI | OPENAI_API_KEY |
| GitHub Copilot | GitHub 登录 |
| OpenCode Zen | OpenCode 账号 |
| Ollama（本地） | 无需配置 |
推荐新手使用 Anthropic Claude 或 OpenAI，API Key 可以在各自官网申请。
初始化项目
进入你的项目目录，使用 /init 命令初始化：
cd your-project
opencode
# 在 OpenCode 中输入：
/init/init 会分析项目结构，生成 AGENTS.md 文件，帮助 AI 理解你的项目上下文。
第一次 AI 辅助编程
初始化完成后，你可以直接输入自然语言描述你的需求：
> 帮我写一个函数，计算数组中所有数字的平均值OpenCode 会：
- 分析你的请求
- 生成代码建议
- 询问你是否接受修改
- 应用修改到文件
提示：使用Tab键可以接受建议，Esc键可以拒绝。
常用命令速查
| 命令 | 说明 |
|---|---|
/init | 初始化项目，生成 AGENTS.md |
/compact | 压缩对话历史，释放上下文空间 |
/models | 切换 LLM 模型 |
/undo | 撤销上一次修改 |
/help | 显示帮助信息 |
Ctrl+C | 取消当前操作 |
Ctrl+D | 退出 OpenCode |
下一步
恭喜你完成了 OpenCode 的安装和第一次使用！接下来建议阅读：
- Plan-Build-Review：AI 辅助编程的高效工作流 — 学习如何高效使用 AI 编程助手
- OpenCode 连接 75+ LLM 提供商 — 了解更多 Provider 配置