Nodejs 人工智能

OpenCode AI 安装与配置指南

blueideaPost a Comment

前言

OpenCode 是一款 AI 编程助手，类似于 Claude Code 和 Cursor 等工具，但它是开源的且可高度自定义。它支持多模型（Anthropic Claude、OpenAI、DeepSeek 等），提供 TUI 终端界面和 Web UI，还拥有丰富的插件系统和 MCP（Model Context Protocol）扩展能力。

本文记录了在 Linux 服务器上安装和配置 OpenCode 的完整过程，包括全局安装、插件安装、MCP 服务配置和基础使用指南。

一、环境准备

  • OS：OpenCloudOS 9 (Linux x86_64)
  • Node.js：v24.18.0
  • npm：最新版
  • 权限：root 用户全局安装

二、全局安装

安装命令非常简单，一行搞定：

npm i -g opencode-ai

安装后验证版本：

opencode --version
# 输出: 1.18.3

三、功能概览

opencode 提供了非常丰富的子命令，核心功能包括：

功能分类命令说明
AI 编程opencode [project]启动 TUI 编程助手
ACP 协议opencode acp启动 Agent Client Protocol 服务
MCP 管理opencode mcp管理 Model Context Protocol 服务器
运行任务opencode run <message>直接运行任务消息
会话管理opencode session管理会话
Provider 管理opencode providers管理 AI 模型和凭证
Agent 管理opencode agent管理自定义 Agent
插件管理opencode plugin <module>安装 npm 插件
GitHub 集成opencode githubGitHub Agent
统计opencode statsToken 用量统计
Web UIopencode web启动 Web 界面
服务模式opencode serve启动无头服务

四、配置

opencode 的配置文件位于以下位置：

  • 项目配置：./opencode.json 或 .opencode/opencode.json
  • 全局配置：~/.config/opencode/opencode.json
  • 全局 Agent：~/.config/opencode/agent/<name>.md
  • 全局 Skills：~/.config/opencode/skill/<name>/SKILL.md
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {},
  "plugin": [],
  "command": {},
  "username": "root"
}

五、安装插件

opencode 通过 opencode plugin <module> 命令安装插件。目前已发现的可安装插件包括：

1. oh-my-opencode

最流行的全能插件，提供多模型编排、后台并行 Agent 和丰富的 LSP/AST 工具。

opencode plugin oh-my-opencode

2. @tarquinen/opencode-dcp

上下文裁剪优化插件，通过移除对话中过期的工具输出来节省 Token。

opencode plugin @tarquinen/opencode-dcp

3. 自动发现插件

将 .ts 或 .js 文件放在 .opencode/plugin/ 目录下即可自动加载。

六、配置 MCP 服务

MCP（Model Context Protocol）允许 opencode 连接外部服务获取增强能力。

在配置文件中添加 MCP 服务器

{
  "mcp": {
    "playwright": {
      "type": "local",
      "command": ["npx", "-y", "@playwright/mcp"],
      "enabled": true
    },
    "filesystem": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
      "enabled": true
    }
  }
}

查看已配置的 MCP 服务器

opencode mcp list

MCP 服务器类型

  • local：本地运行命令启动
  • remote：远程 URL 连接，可配置 Headers 认证

七、配置 AI Provider

opencode 支持多种 AI 模型提供商。配置 API Key：

opencode providers

或在配置文件中指定：

{
  "provider": {
    "anthropic": {
      "options": { "apiKey": "***" }
    }
  }
}

支持的 Provider：Anthropic (Claude)、OpenAI (GPT 系列)、DeepSeek、Google Gemini 等。

八、Skills（自定义技能）

Skills 是 opencode 的可重用指令模块，类似于 AI Agent 的 Skills 概念。

存放位置

~/.config/opencode/skills/my-skill/SKILL.md

Skill 文件格式

---
name: my-skill
description: 这个 skill 在什么场景下触发使用
---

# 我的 Skill

（技能的详细指令、示例、参考）

九、总结

OpenCode v1.18.3 是一款功能强大的 AI 编程助手，具有以下特点：

  • 轻量安装：只需 npm i -g opencode-ai 一行命令
  • 多模型支持：灵活切换各种 AI 提供商
  • 插件生态：支持 npm 插件扩展功能
  • MCP 集成：通过 Model Context Protocol 连接外部服务
  • 多种界面：TUI / Web UI / Headless Server
  • 高度可定制：自定义 Agent、Skills、Commands、Permissions

无论是个人开发者还是团队协作，opencode 都是一款值得尝试的 AI 编码工具。

blueidea

Leave A Comment

Recommended Posts