教程中心›OpenCode 指南
入门

OpenCode 使用手册：13.8 万 Star 的开源终端编程 Agent

2026.05.07· 25 分钟上手· 💻 OpenCode

OpenCode 是 GitHub 13.8 万+ Star 的开源 AI 编程代理，月活 500 万+。它的核心理念是隐私优先——不存储你的代码、不记录上下文、数据不出本地。支持 75+ 大模型，终端 / 桌面 / IDE 三端覆盖，而且支持 GitHub Copilot 账户直连，不用额外买 API Key。

如果你已经订阅了 GitHub Copilot，可以直接用 Copilot 账户登录 OpenCode，零额外成本！

📋 OpenCode 核心能力

  • 🌐 75+ LLM 提供商：Claude / GPT-4 / Gemini / DeepSeek / 本地模型……应有尽有
  • 🖥️ 三端覆盖：终端界面 + 桌面应用（Beta）+ IDE 扩展
  • 🔀 多会话并行：同一项目可同时启动多个 Agent 处理不同任务
  • 📡 LSP 开箱即用：自动加载对应语言的语言服务器，代码理解更精准
  • 🔗 会话分享：通过链接分享任意会话，团队协作利器
  • 🔑 GitHub Copilot 直连：用 Copilot 订阅直接驱动，免 API Key
  • 🕵️ 隐私优先：不存储代码，不记录上下文，数据不出本地
  • 🏗️ 三种 Agent 模式：build / plan / general，按任务类型选择

步骤一：安装 OpenCode

1 选择你的安装方式
# 方式 A：一行命令安装（推荐，Linux/macOS）
curl -fsSL https://opencode.ai/install | bash

# 方式 B：npm 全局安装
npm install -g opencode-ai

# 方式 C：Homebrew（macOS）
brew install opencode

# 方式 D：Scoop（Windows）
scoop install opencode

验证安装：

opencode --version
Windows 用户推荐用 Scoop 安装，最简单。没有 Scoop？在 PowerShell 中运行：irm get.scoop.sh | iex

步骤二：配置模型

2 选择你的 AI 大脑

方式 A：GitHub Copilot 账户（零成本）

# 登录 GitHub Copilot
opencode auth login --provider github

# 验证连接
opencode auth status

方式 B：API Key

# 设置 API Key（选你有的）
export ANTHROPIC_API_KEY="sk-ant-xxx"    # Claude
export OPENAI_API_KEY="sk-xxx"           # GPT
export DEEPSEEK_API_KEY="sk-xxx"         # DeepSeek

# 编辑配置文件选择默认模型
opencode config edit

推荐配置：

# config.toml
[models]
default = "anthropic/claude-sonnet-4"
plan = "openai/gpt-5.1"
build = "anthropic/claude-sonnet-4"
有 GitHub Copilot 订阅的用户选方式 A 最省事，每月 $10 的 Copilot 直接用，不用再买 API Key。

步骤三：终端模式使用

3 在终端中和 AI 写代码
# 进入项目目录
cd my-project

# 启动 OpenCode TUI
opencode

进入交互界面后：

  • 直接输入文字描述你的需求
  • /plan — 切换到 Plan 模式，AI 先分析后执行
  • /build — 切换到 Build 模式，适合代码生成和修改
  • /general — 通用模式，适合问答和分析
  • /share — 生成当前会话的分享链接
  • Ctrl+C — 中断当前操作
  • Ctrl+D — 退出 OpenCode

实战示例：

> /build
帮我给这个 Node.js 项目添加用户登录功能：
- JWT 认证
- 登录/注册 API
- 密码用 bcrypt 加密
- 写好单元测试

步骤四：多会话并行

4 同时处理多个任务

OpenCode 支持在同一项目中启动多个 Agent 并行工作：

# 终端 1：修复 Bug
opencode --session bugfix
> /build
修复用户登录后 session 丢失的问题

# 终端 2：写新功能
opencode --session feature
> /build
添加用户头像上传功能

# 终端 3：写测试
opencode --session tests
> /build
为 auth 模块补充单元测试
多会话并行是 OpenCode 的杀手锏。三个 Agent 各干各的，互不干扰，效率翻倍。

步骤五：桌面应用和 IDE 扩展

5 不只是终端

桌面应用（Beta）：

# 安装桌面版
opencode desktop install

# 启动
opencode desktop

VS Code 扩展：

  1. 打开 VS Code 扩展商店
  2. 搜索 "OpenCode"
  3. 点击安装
  4. 在 VS Code 中按 Ctrl+Shift+P，输入 OpenCode: Start

IDE 扩展会自动连接本地的 OpenCode 实例，在编辑器内直接使用 AI 编程。

步骤六：会话分享与团队协作

6 分享你的 AI 对话
# 在当前会话中生成分享链接
/share

# 输出类似：
# 🔗 Share link: https://opencode.ai/s/abc123def

团队成员打开链接就能看到完整的对话记录和代码变更，方便知识共享和代码评审。

🎉 你已经会用 OpenCode 了！

接下来你可以：

📚 更多教程 💻 OpenCode 详情 📰 智能体资讯