OpenCode 入门使用

OpenCode Simple Using

OpenCode 入门使用和介绍

Abstract

本文主要是介绍OpenCode安装之后的入门使用，要了解OpenCode设计理念和结构基础

1. 背景

OpenCode 是一个开源的 AI 编程代理（AI coding agent），支持在终端（Terminal）、桌面应用和主流 IDE（如 VS Code）中与 AI 交互完成代码相关任务。

OpenCode 可以帮助我们理解代码库、编写新功能、重构代码、修复 Bug 等，大幅提升开发效率。OpenCode 类似于 Claude 的 Code 模式或 Cursor 的 Agent 功能，但完全开源、隐私优先，支持多种大语言模型（LLM），并强调终端体验。

OpenCode is an open source agent that helps you write code in your terminal, IDE, or desktop.

软件工程领域最热门的“OpenCode”。它是由 Jay V 和 Frank Wang（滑铁卢大学校友）创办的开源 AI 编程工具。

• 正式发布（2025年6月19日）： OpenCode 正式上线。它主打“零摩擦”体验（无需账号、无需信用卡）和“模型无关性”（支持所有主流 AI 模型）。

• 现状（2026年）： 截至 2026 年初，它已成为全球最受欢迎的开源编程 Agent 之一，因其不存储任何用户代码的隐私设计，被 Cloudflare 等大型企业广泛采用。

• 启用了 LSP（Language Server Protocol），会自动为当前使用的大语言模型（LLM）加载合适的语言服务器。

• Multi-session Start multiple agents in parallel on the same project

• 可以把某一次使用 OpenCode（或类似工具）的会话生成一个链接，方便他人查看、参考或排查问题（debug）。

• Claude Pro Log in with Anthropic to use your Claude Pro or Max account

• ChatGPT Plus/Pro Log in with OpenAI to use your ChatGPT Plus or Pro account

• Any model 75+ LLM providers through Models.dev, including local models

• Any editor Available as a terminal interface, desktop app, and IDE extension

Opencode可看作开源版本的Claude Code

2. 安装

有多种方式进行安装

2.1 终端安装

OpenCode可以和Claude 一样成为终端版安装使用，使用下面的命令进行不同操作系统的安装

curl

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

npm nodejs安装

npm i -g opencode-ai

bun

bun add -g opencode-ai

brew macos

brew install anomalyco/tap/opencode

paru

paru -S opencode

安装后之后，在目录之下，输入opencode即可启动OpenCode

opencode

2.2 桌面版安装

从OpenCode 官网进行不同操作版本桌面版下载,测试版目前还没有稳定

opencode install

2.3 扩展安装

The OpenCode extension for VS Code, Cursor, and other IDEs。OpenCode 可以与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在终端中运行 opencode 即可开始使用。

IDE install

在VSCode搜素opencode插件进行安装，安装好之后，输入shift+command+p，打开控制面板，然后输入opencode，打开opencode功能

2.4 云端安装

3.使用

OpenCode也是使用/命令，调用功能

3.1 模型更改

使用/model查看可使用的模型

• Big Pickle
  • GLM-4.7
  • Grok Code Fast 1
  • MiniMax M2.1
• Popular providers
  • OpenCode Zen
  • Claude
  • Github Copilot
  • OpenAI

3.2 Antigravity 插件

启用 Opencode 通过 OAuth 对 Antigravity（Google 的 IDE）进行身份验证，以便您可以使用 Google 凭据使用 Antigravity 速率限制和访问 gemini-3-pro 和 claude-opus-4-5-thinking 等模型。

opencode-antigravity-auth 是目前最热门的开源 AI 编程助手 OpenCode（由 SST 团队开发）的一个核心插件。可以通过 Google 账号登录 OpenCode，并调用 Google 内部或特定 IDE 环境（代号为 “Antigravity”）中的高性能 AI 模型。

该插件充当了一个“认证网桥”。它允许 OpenCode 绕过标准的 API 密钥限制，直接使用 Google Antigravity 环境提供的配额。通过它，你可以在 OpenCode 中使用以下顶级模型：

• Gemini 3 Pro / Gemini 3 Pro High（具备极强推理能力的模型）。
• Claude 4.5 / Claude 3.5 Sonnet (Thinking)（Google Antigravity 环境中有时会提供这些模型的访问权限）

安装

将此内容粘贴到任何 LLM 代理（Claude Code、OpenCode、Cursor 等）中：自动安装

Install the opencode-antigravity-auth plugin and add the Antigravity model definitions to ~/.config/opencode/opencode.json by following: https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/dev/README.md

等待自行安装成功，提示

> Thinking: The config file has been created with the plugin and model definitions. Now the user needs to run opencode auth login to authenticate with their Google account.

已安装 opencode-antigravity-auth 插件并添加了 Antigravity 模型配置到 ~/.config/opencode/opencode.json。
接下来需要运行 opencode auth login 进行 Google 账户认证

认证 退出当前opencode，然后在终端中输入opencode auth login

opencode auth

选择google，然后一直Enter，直到跳转到google浏览器，进行账户认证,直到出现

Add another account? (1 added) (y/n):
│
●  Multi-account setup complete (1 account(s)).
│
◇  Login successful
│
└  Done

表示设置成功

切换模型

在opencode中输入/models,找到gemini-3-pro-thinking 或 claude-4.5-thinking，输入问题，响应成功即可

3.2 OpenRuter接入

OpenRouter 就是一个大模型 API 路由器，旨在将各种 AI 模型和服务集成到一个统一的接口中。它允许用户通过简单的配置就能调用不同大模型的能力。

• 统一接口：提供标准化的 API，简化了模型的集成和部署过程。
• 多模型支持：支持多种预训练模型，如 GPT-4、Claude、Gemini 等。
• 无需 GPU 服务器：通过调用预训练模型的 API，用户无需自建 GPU 服务器。

进入openrouter官网 注册之后，创建API key，然后把key复制

Tip

一定要及时复制，关闭之后就无法复制

Connect

在opencode中输入/connect,输入openrouter，然后把APIkey输入

openrouter

4. 亮点功能