OpenCode CLI

OpenCode 是一款完全开源的 AI 编码代理，可作为终端界面、桌面应用或 IDE 扩展使用。由 neovim 用户和 terminal.shop 创建者构建，专注于推动终端体验的极限。

核心特性

完全开源：代码公开透明，社区驱动发展
多模型支持：支持 75+ 模型提供商，包括 Claude、OpenAI、Google、本地模型等
Plan/Build 双模式：Plan 模式分析方案，Build 模式执行修改，Tab 键一键切换
LSP 原生集成：内置 30+ 语言服务器，提供代码智能和诊断
MCP 服务扩展：支持 Model Context Protocol，轻松扩展工具能力
客户端/服务器架构：支持远程驱动，可通过移动设备控制
GitHub 集成：在 PR/Issue 评论中 @opencode 自动执行任务

快速开始

bash

# 一键安装（推荐）
curl -fsSL https://opencode.ai/install | bash

# 或使用 npm
npm install -g opencode-ai

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

# 启动
opencode

# 指定模型启动
opencode --model anthropic/claude-sonnet-4-5

# 非交互模式执行任务
opencode run "修复这个 bug"

使用模式

Plan 模式

代理分析代码库并提出实现方案，不会直接修改文件。适合探索和规划阶段。

Build 模式

代理可以直接执行代码修改。适合实际开发工作。

切换方式：按 Tab 键在两种模式间切换。

文档导航

入门指南

安装指南 - 多种安装方式与环境配置

配置详解

基础配置 - 配置文件结构与选项
Provider 配置 - 75+ 模型提供商配置
MCP 服务 - MCP 服务集成配置
LSP 配置 - 语言服务器配置

高级功能

Agents 代理系统 - 主代理与子代理配置

常用命令

命令	功能
`/init`	分析项目，创建 AGENTS.md 配置文件
`/connect`	配置 LLM 提供商凭证
`/models`	查看和切换可用模型
`/undo`	撤销代理所做的更改
`/redo`	恢复撤销的更改
`/share`	分享对话给团队成员
`Tab`	在 Plan 和 Build 模式间切换

配置文件示例

OpenCode 使用 opencode.json（支持 JSONC）作为配置文件：

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "enabled": true
    }
  },
  "lsp": {
    "typescript": {
      "command": ["typescript-language-server", "--stdio"],
      "extensions": [".ts", ".tsx", ".js", ".jsx"]
    }
  },
  "agent": {
    "review": {
      "mode": "subagent",
      "description": "代码审查专家",
      "tools": {"write": false, "edit": false}
    }
  }
}

与其他 CLI 工具对比

特性	OpenCode	Claude Code	Codex CLI	Gemini CLI
完全开源	✅	❌	❌	❌
多模型支持 (75+)	✅	❌	❌	❌
Plan/Build 模式	✅	✅	❌	❌
LSP 原生集成	✅	❌	❌	❌
MCP 支持	✅	✅	❌	✅
GitHub Actions 集成	✅	❌	❌	❌
远程控制架构	✅	❌	❌	❌
桌面应用	✅	❌	❌	❌

OpenCode CLI ​

核心特性 ​

快速开始 ​

使用模式 ​

Plan 模式 ​

Build 模式 ​

文档导航 ​

入门指南 ​

配置详解 ​

高级功能 ​

常用命令 ​

配置文件示例 ​

与其他 CLI 工具对比 ​

更多资源 ​