OpenCode 安装使用教程

🚀 项目介绍

OpenCode 是一个开源的 AI 编程代理，在终端中直接和 AI 对话写代码。它是 Claude Code 的真正平替，支持 75 种以上的大模型，包括 Claude、GPT、Gemini 以及本地模型。

✨

核心优势：终端优先设计、支持 75+ 模型、完全开源、代码不出境、MIT 许可证！

项目信息	详情
GitHub 地址	github.com/sst/opencode
Star 数量	62,000+ ⭐
开源协议	MIT License
支持平台	Windows / macOS / Linux
支持模型	Claude、GPT、Gemini、本地模型等 75+

⚡ 核心功能

💻

终端优先设计

在命令行里直接和 AI 对话写代码，效率极高

🤖

75+ 模型支持

Claude、GPT、Gemini、本地模型全都支持

🔒

隐私保护

支持本地模型，代码不出境，数据更安全

💚

完全开源

MIT 许可证，自由使用和修改

🧠 Oh My OpenCode

Oh My OpenCode 是 OpenCode 的增强版编排层，加入了多智能体协作功能，让 AI 编程更加强大！

🚀

项目地址：github.com/code-yeongyu/oh-my-opencode

多智能体协作

🧠

Planner 规划师

负责任务分解和整体规划

🔍

Explorer 探索者

负责代码库探索和搜索

📚

Librarian 管理员

负责代码索引和管理

🔮

Oracle 问答者

负责回答技术问题

高级功能

20+ 自动化钩子：支持各种自动化工作流
MCP 协议集成：Model Context Protocol 支持
LSP 支持：语言服务器协议集成

安装方法

bash

# 使用 pip 安装
pip install oh-my-opencode

# 或者克隆源码
git clone https://github.com/code-yeongyu/oh-my-opencode.git
cd oh-my-opencode
pip install -e .

🎉 Antigravity 免费认证

通过 Antigravity（Google 的 IDE）OAuth 认证，可以免费使用顶级 AI 模型！

💡

核心优势：无需 API 密钥，零成本使用 Claude Opus 4.5、Gemini 3 Pro 等顶级模型！

支持的免费模型

模型	说明
Claude Opus 4.5	Anthropic 最强模型
Claude Sonnet 4.5	平衡性能与速度
Gemini 3 Pro	Google 最新模型
Gemini 3 Flash	快速响应版本

核心功能

Google OAuth 授权：使用 Google 账号授权即可
多账户支持：可添加多个 Google 账户，限速时自动轮换
双配额系统：同时使用 Antigravity 和 Gemini CLI 配额
思维模型：支持 Claude 和 Gemini 3 的扩展思维
Google 搜索接地：为 Gemini 模型启用网络搜索
自动恢复：自动处理会话错误和工具故障
插件兼容：可与 oh-my-opencode、dcp 等插件一起使用

启用方法

bash

# 在 OpenCode 配置中启用 Antigravity
opencode config set provider antigravity

# 进行 Google OAuth 认证
opencode auth login

⚙️ 安装步骤

方式一：使用包管理器安装（推荐）

macOS / Linux

bash

# 使用 curl 安装
curl -fsSL https://opencode.run/install.sh | sh

# 或使用 Homebrew (macOS)
brew install sst/tap/opencode

Windows

powershell

# 使用 scoop 安装
scoop bucket add sst https://github.com/sst/scoop-bucket.git
scoop install opencode

# 或使用 winget
winget install sst.opencode

方式二：从源码编译

克隆代码仓库

bash

git clone https://github.com/sst/opencode.git
cd opencode

编译安装

bash

# 需要 Go 1.21+
go build -o opencode ./cmd/opencode

# 移动到 PATH
sudo mv opencode /usr/local/bin/

💡

安装完成后，在终端输入 opencode 即可启动！

🔑 模型配置

OpenCode 支持多种 AI 模型提供商：

方式一：使用 Antigravity（免费推荐）

bash

# 设置为 Antigravity 提供商
opencode config set provider antigravity

# 登录 Google 账号
opencode auth login

方式二：使用 API Key

服务商	环境变量	获取地址
Anthropic	`ANTHROPIC_API_KEY`	console.anthropic.com
OpenAI	`OPENAI_API_KEY`	platform.openai.com
Google	`GOOGLE_API_KEY`	aistudio.google.com

bash

# 设置环境变量
export ANTHROPIC_API_KEY="your-api-key"

# 或在配置文件中设置
opencode config set anthropic.api_key "your-api-key"

方式三：使用本地模型（Ollama）

bash

# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 下载模型
ollama pull deepseek-coder:6.7b

# 配置 OpenCode 使用 Ollama
opencode config set provider ollama
opencode config set ollama.model deepseek-coder:6.7b

💻 使用方法

启动 OpenCode

bash

# 在项目目录下启动
cd your-project
opencode

基本对话

启动后直接输入你的需求，OpenCode 会理解并执行：

示例

帮我创建一个 Express 服务器，包含用户登录和注册接口

常用命令

命令	功能
`/help`	显示帮助信息
`/clear`	清除对话历史
`/model`	切换模型
`/config`	查看配置
`/exit`	退出程序

快捷键

快捷键	功能
`Ctrl + C`	中断当前操作
`Ctrl + D`	退出程序
`↑ / ↓`	浏览历史输入
`Tab`	自动补全

❓ 常见问题

Q1: OpenCode 和 Claude Code 有什么区别？

开源 vs 闭源：OpenCode 完全开源，Claude Code 是 Anthropic 官方工具
模型支持：OpenCode 支持 75+ 模型，Claude Code 只支持 Claude
免费使用：OpenCode 配合 Antigravity 可完全免费

Q2: 如何使用免费模型？

推荐使用 Antigravity 认证，只需 Google 账号授权即可免费使用 Claude Opus 4.5 和 Gemini 3 Pro 等顶级模型。

Q3: 代码数据安全吗？

OpenCode 支持本地模型（如 Ollama），代码完全在本地处理，不会上传到任何服务器。

Q4: 如何切换不同的模型？

bash

# 使用命令切换
opencode config set model claude-3-5-sonnet

# 或在对话中使用
/model gpt-4o

Q5: Oh My OpenCode 有什么优势？

Oh My OpenCode 提供多智能体协作、20+ 自动化钩子、MCP 协议集成等高级功能，适合复杂项目开发。

Q6: 限速了怎么办？

使用 Antigravity 的多账户功能，添加多个 Google 账户，限速时会自动轮换使用。