OpenCode 安装使用教程

项目介绍

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

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

核心功能

Oh My OpenCode

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

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

多智能体协作

高级功能

• 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 等顶级模型！

支持的免费模型

核心功能

• 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

安装步骤

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

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

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

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

# 或使用 winget
winget install sst.opencode

方式二：从源码编译

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

# 需要 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

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 服务器，包含用户登录和注册接口

常用命令

快捷键

常见问题

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 账户，限速时会自动轮换使用。