免费开源AI编程智能体OpenCode使用

前言

OpenCode 是开源的终端 AI 编码助手,免费提供4个模型,并且能切换市面上的基本所有的模型。

可在命令行完成代码编写、Bug 修复、项目重构。

提供原生终端界面和上下文感知能力,适合全栈开发者和终端用户使用。

主要特点:

  • 原生终端界面,响应快,支持自定义主题
  • 支持 Claude、GPT-4、Gemini 等多个 AI 模型
  • 自动扫描项目文件,理解代码结构

目前已经8.2万 Star。基本上算是开源版的 Claude Code,而且完全不绑定任何一家模型提供商

官网

OpenCode | The open source AI coding agent

安装

1
2
3
4
5
# npm 安装
npm install -g opencode-ai

# Homebrew 安装(macOS/Linux)
brew install sst/tap/opencode

终端使用

进入opencode

命令行输入

1
opencode

进入聊天状态

切换模型 输入

1
/models

有4个免费的模型

GLM-4.7MiniMax M2.1都是不错的国产编程可用模型。

这里选择 GLM-4.7

image-20260121233129769

网页中使用

1
opencode web

会自动打开网页。

VSCode中使用

安装上面的插件后,安装VSCode插件opencode

快捷键Ctrl + Shift + P

输入Open opencode

如果报错

opencode : 无法加载文件 D:\Tools\nvm\nodejs\opencode.ps1,因为在此系统上禁止运行脚本。

允许脚本运行

Win + X,选择 Windows PowerShell(管理员)终端(管理员)

1
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

首次使用建议先运行 /init 命令,让 OpenCode 分析你的项目,自动生成一个 AGENTS.md 文件。

这个文件是让AI看的,是后续AI生成代码的要求。

1
/init

OpenCode 内置了两种 Agent,用 Tab 键切换:

  1. Build 模式(默认):全权限,可以读写文件、执行命令
  2. Plan 模式:只读模式,只做分析和规划,不会动你的代码

添加模型

TIP

默认提供的就够用了,这个可以跳过。

添加 gemini-3-proclaude-opus-4-5-thinking模型

https://github.com/NoeFabris/opencode-antigravity-auth

opencode输入框中输入

1
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

打开新的终端输入

1
opencode auth login

供应商选择Google

image-20260122002607825

选择登录方式

image-20260122003559903

登录成功后,把浏览器上的地址粘贴到命令行中。

注意

账号必须有使用上述模型的资格才可以。

常用命令

切换模型

1
/models

在不同 AI 模型间切换,比如用 Claude 写代码,用 GPT-4 做审查。

撤销修改

1
/undo

AI 改错了可以一键回滚。

分享会话

1
/share

生成公开链接,把对话记录分享给同事。

更换主题

1
/themes

添加技能

anthropics/skills: Public repository for Agent Skills

下载上面的源码

打开目录

1
explorer %USERPROFILE%\.config\opencode

复制skills文件夹,复制后路径如下

1
%USERPROFILE%\.config\opencode\skills

这时候打开opencode

询问

1
你有哪些skills

如果正确返回,就证明安装好了。