OpenCode 学习教程

🔍 主流 AI 编程工具对比必读

以下是 2026 年主流 AI 编程工具的核心对比，帮助你选择最适合的工具：

对比维度	OpenCode	Claude Code	Codex CLI	CodeBuddy	Qoder
开发商	开源社区	Anthropic	OpenAI	腾讯云	阿里巴巴
开源协议	MIT	闭源	闭源	闭源	闭源
支持模型	75+ 模型	Claude 系列	GPT 系列	混元/GPT/Claude	通义/GPT/Claude
主要形态	终端/桌面	终端	终端	IDE/终端/Web	IDE
本地模型	✓	✗	✗	△	△
MCP 支持	✓	✓	△	✓	✓
隐私保护	强	中	中	中	中
价格	免费	订阅制	订阅制	免费/订阅	免费/订阅
适合人群	全栈/隐私敏感	专业开发者	OpenAI 用户	腾讯生态用户	阿里生态用户

💡 如何选择？

OpenCode：追求开源、隐私、多模型支持的开发者首选
Claude Code：深度 Claude 用户，需要最强推理能力
Codex CLI：OpenAI 订阅用户，习惯 GPT 工作流
CodeBuddy：腾讯云用户，需要 IDE 集成和云端协作
Qoder：阿里云用户，企业级开发场景

⬇️ 安装与环境入门

系统要求

系统	要求	推荐终端
macOS	macOS 10.15+	WezTerm, Alacritty, iTerm2, Kitty
Linux	glibc 2.31+	WezTerm, Alacritty, Ghostty, Kitty
Windows	Windows 10+	Windows Terminal (推荐 WSL)

💡 提示：Windows 用户建议使用 WSL（Windows Subsystem for Linux）以获得最佳体验。

安装方式

bash — 推荐方式

# 安装最新版本
curl -fsSL https://opencode.ai/install | bash

# 安装指定版本
curl -fsSL https://opencode.ai/install | VERSION=0.1.0 bash

bash — macOS/Linux

# Homebrew 安装
brew install opencode-ai/tap/opencode

# 或使用官方 tap
brew tap opencode-ai/tap
brew install opencode

bash — Node.js

# npm 全局安装
npm install -g opencode-ai@latest

# 或使用 bun
bun add -g opencode-ai

# 或使用 pnpm
pnpm add -g opencode-ai

bash — Go 安装

# Go 安装（需要 Go 1.21+）
go install github.com/opencode-ai/opencode@latest

# Arch Linux AUR
yay -S opencode-ai-bin
# 或
paru -S opencode-ai-bin

验证安装

bash

# 检查版本
opencode --version

# 启动 OpenCode
opencode

# 指定工作目录
opencode -c /path/to/project

# 调试模式
opencode -d

桌面应用

OpenCode 也提供桌面应用版本，支持 macOS、Windows 和 Linux。

下载地址

# 官方下载页面
https://opencode.ai/download

# macOS 可通过 Homebrew 安装
brew install --cask opencode

🚀 5分钟上手入门

第一步：配置 API 密钥

OpenCode 需要配置 AI 模型的 API 密钥才能工作。你可以选择以下任一方式：

bash — 设置环境变量

# Anthropic Claude
export ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI GPT
export OPENAI_API_KEY="sk-..."

# Google Gemini
export GEMINI_API_KEY="AIza..."

# GitHub Copilot（需要 GitHub Token）
export GITHUB_TOKEN="ghp_..."

# Groq
export GROQ_API_KEY="gsk_..."

# AWS Bedrock
export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"

💡 建议将环境变量添加到 shell 配置文件：~/.zshrc 或 ~/.bashrc

交互式配置流程

# 1. 启动 OpenCode
opencode

# 2. 在 TUI 中输入命令
/connect

# 3. 访问授权页面
# 打开 https://opencode.ai/auth 登录并获取 API 密钥

# 4. 在 TUI 中粘贴密钥完成配置

第二步：初始化项目

bash

# 进入项目目录
cd /path/to/your/project

# 启动 OpenCode
opencode

# 在 TUI 中执行初始化命令
/init

📄 AGENTS.md 文件

/init 命令会自动分析项目并生成 AGENTS.md 文件，包含：

项目结构说明
技术栈信息
编码规范
关键文件位置

建议将 AGENTS.md 提交到 Git，帮助 OpenCode 更好理解项目上下文。

第三步：开始对话

示例对话

# 理解代码
"解释一下这个项目的身份验证流程"

# 搜索文件并提问（使用 @ 符号）
"@packages/auth 如何处理用户登录？"

# 添加功能
"在设置页面添加深色模式切换开关"

# 修复 Bug
"修复这个错误：TypeError: Cannot read property 'id' of undefined"

# 重构代码
"重构 UserService 类以使用依赖注入模式"

第四步：切换工作模式

使用 Tab 键在两种模式间切换

💡 最佳实践：复杂任务先用计划模式分析，确认方案后再切换到构建模式执行。

💬 基础命令入门

斜杠命令

命令	说明	示例
`/init`	初始化项目，生成 AGENTS.md	`/init`
`/undo`	撤销上一次更改	`/undo`
`/redo`	重做已撤销的更改	`/redo`
`/share`	生成对话分享链接	`/share`
`/connect`	配置 API 密钥	`/connect`
`/help`	显示帮助信息	`/help`
`/clear`	清空当前对话	`/clear`

CLI 参数

bash

# 正常启动
opencode

# 指定工作目录
opencode -c /path/to/project

# 调试模式
opencode -d

# 非交互式提示（管道模式）
opencode -p "解释这个函数的作用"

# JSON 格式输出
opencode -p "分析代码" -f json

# 静默模式（无加载动画）
opencode -p "解释代码" -q

# 查看帮助
opencode --help

文件引用语法

使用 @ 符号快速引用文件：

对话示例

# 搜索并引用文件
"@auth 解释这个登录逻辑"

# 引用多个文件
"@user.model @user.service 分析这两个文件的关系"

# 引用目录
"@src/api 列出所有 API 端点"

非交互式使用

OpenCode 支持管道模式，可用于脚本和自动化：

bash

# 单次提问
opencode -p "这段代码有什么问题？" < code.py

# 与其他命令结合
cat error.log | opencode -p "分析这些错误日志"

# 在脚本中使用
RESULT=$(opencode -p "生成一个 React 组件" -f json)
echo "$RESULT" | jq '.code'

🤖 模型配置入门

支持的 AI 提供商

OpenCode 支持 75+ AI 提供商，通过统一接口调用

模型列表

🟠 Anthropic Claude▶

模型	特点	环境变量
Claude 3.7 Sonnet	最新版本，编程能力强	`ANTHROPIC_API_KEY`
Claude 3.5 Sonnet	性价比高，推荐日常使用	`ANTHROPIC_API_KEY`
Claude 3.5 Haiku	速度快，适合简单任务	`ANTHROPIC_API_KEY`
Claude 3 Opus	最强推理能力	`ANTHROPIC_API_KEY`

🔵 OpenAI▶

模型	特点	环境变量
GPT-4.1	最新版本，编程优化	`OPENAI_API_KEY`
GPT-4.1-mini	轻量级，快速响应	`OPENAI_API_KEY`
GPT-4o	多模态支持	`OPENAI_API_KEY`
O1/O3/O4	深度推理模型	`OPENAI_API_KEY`

🟣 Google Gemini▶

模型	特点	环境变量
Gemini 2.5 Pro	最新旗舰模型	`GEMINI_API_KEY`
Gemini 2.5 Flash	快速响应版本	`GEMINI_API_KEY`
Gemini 2.0 Flash Lite	轻量级模型	`GEMINI_API_KEY`

🟢 GitHub Copilot▶

模型	说明	环境变量
GPT-4o	Copilot 默认模型	`GITHUB_TOKEN`
Claude 3.5 Sonnet	Copilot 支持	`GITHUB_TOKEN`
Gemini 2.0	Copilot 支持	`GITHUB_TOKEN`

需要 GitHub Copilot 订阅，使用 Personal Access Token。

🟡 Groq▶

模型	特点	环境变量
Llama 4 Maverick	Meta 最新模型	`GROQ_API_KEY`
Llama 3.3 70b	高性能开源模型	`GROQ_API_KEY`
Deepseek R1	深度推理模型	`GROQ_API_KEY`
QWEN QWQ-32b	阿里开源模型	`GROQ_API_KEY`

切换模型

在 OpenCode TUI 中按 Ctrl+O 打开模型选择对话框，或使用斜杠命令：

模型切换

# 快捷键切换
Ctrl+O  → 打开模型选择对话框

# 命令行指定
opencode --model claude-3.7-sonnet
opencode --model gpt-4.1
opencode --model gemini-2.5-pro

OpenCode Zen（推荐）

🌟 什么是 Zen？

OpenCode Zen 是官方提供的精选模型服务，专为编程代理优化：

稳定可靠：经过严格测试和基准验证
无需配置：无需管理多个 API 密钥
统一体验：避免不同模型间的性能差异

bash — 使用 Zen

# 配置 Zen
/connect
# 选择 Zen 选项，按提示完成授权

# 或使用环境变量
export OPENCODE_ZEN_KEY="your-zen-key"

🔄 工作模式入门

双模式详解

维度	🧠 计划模式 (Plan)	🔨 构建模式 (Build)
权限	只读	可读写
文件操作	只能查看	可以修改、创建、删除
命令执行	不能执行 shell	可以执行 shell 命令
适用场景	理解代码、制定计划	实现功能、修复 Bug
安全性	高（无副作用）	中（需要确认操作）
切换方式	按 `Tab` 键

撤销与重做

OpenCode 提供完整的撤销/重做功能：

撤销重做

# 撤销上一次更改
/undo

# 重做已撤销的更改
/redo

# 查看更改历史
/log

⚙️ 配置详解中级

配置文件位置

OpenCode 按以下顺序查找配置文件（后者覆盖前者）：

配置文件优先级

# 1. 用户全局配置
~/.opencode.json

# 2. XDG 标准位置
$XDG_CONFIG_HOME/opencode/.opencode.json

# 3. 项目配置（优先级最高）
./.opencode.json

配置示例

json — opencode.json

{
  "model": "claude-3.7-sonnet",
  "provider": "anthropic",
  "autoCompact": true,
  "theme": "dark",
  "editor": "vim",
  "formatOnSave": true,
  "lsp": {
    "enabled": true,
    "languages": ["typescript", "python", "go"]
  },
  "tools": {
    "bash": {
      "enabled": true,
      "timeout": 30000
    },
    "fetch": {
      "enabled": true
    }
  },
  "providers": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}"
    },
    "openai": {
      "apiKey": "${OPENAI_API_KEY}"
    }
  }
}

配置项说明

配置项	类型	默认值	说明
`model`	string	auto	默认使用的模型
`provider`	string	auto	默认提供商
`autoCompact`	boolean	true	自动压缩上下文
`theme`	string	dark	主题（dark/light）
`editor`	string	vim	内置编辑器模式
`formatOnSave`	boolean	true	保存时自动格式化

AGENTS.md 项目配置

在项目根目录创建 AGENTS.md 文件，帮助 OpenCode 理解项目：

markdown — AGENTS.md

# 项目说明

## 技术栈
- 前端：React 18 + TypeScript + Tailwind CSS
- 后端：Node.js + Express + PostgreSQL
- 测试：Jest + Playwright

## 项目结构
```
src/
├── components/    # React 组件
├── hooks/         # 自定义 Hooks
├── services/      # API 服务层
├── utils/         # 工具函数
└── types/         # TypeScript 类型定义
```

## 编码规范
- 使用函数式组件和 Hooks
- 遵循 ESLint + Prettier 配置
- 组件命名使用 PascalCase
- 文件命名使用 camelCase

## 关键文件
- src/App.tsx: 应用入口
- src/services/api.ts: API 配置
- .env.example: 环境变量模板

🎯 热门 Skills 推荐中级

Skills 是 OpenCode 的扩展能力模块，以下是最热门的 10 个推荐：

🔍 Deep Research

企业级研究助手，支持多源综合分析、引用追踪和验证。适合需要深度调研的场景。

🌐 Web Search

实时联网搜索能力，支持搜索结果排名、安全搜索、分页等功能。

📊 XLSX

Excel 表格处理专家，支持读取、编辑、创建和分析 xlsx/xlsm/csv 文件。

📄 PDF

PDF 文档全能助手，支持读取、合并、拆分、加密、提取图片和 OCR 识别。

🎨 AI Image Gen

AI 图像生成，支持 FLUX、Gemini、Grok、Seedream 等 50+ 模型。

📝 DOCX

Word 文档处理，支持创建、读取、编辑、格式化和模板应用。

📊 PPTX Generator

PPT 幻灯片生成器，支持创建、编辑、布局管理和 LinkedIn 轮播。

🤖 MCP Builder

MCP 服务器构建指南，帮助创建高质量的 MCP 集成。

🔍 Find Skills

技能发现助手，帮助用户发现和安装适合的智能体技能。

✍️ Humanizer

文本人性化处理，去除 AI 生成痕迹，让文本更自然。

💡 安装方式：在 OpenCode 中使用 /skill install <skill-name> 命令即可安装所需技能。

🔌 热门插件推荐中级

插件可以扩展 OpenCode 的核心功能，以下是最热门的 10 个社区插件：

🔔 Opencode Notify — 任务完成通知 ▶

任务完成时发送原生 OS 通知，让你不错过任何重要完成事件。支持 macOS、Windows 和 Linux。

安装：opencode plugin install opencode-notify

🧠 Opencode Mem — 持久化记忆系统 ▶

为 OpenCode 提供持久化记忆能力，支持本地向量数据库存储。让你的 AI 助手记住之前的对话和偏好。

安装：opencode plugin install opencode-mem

📊 Tokenscope — Token 使用分析 ▶

全面的 Token 使用分析和成本追踪工具，帮助你优化 API 调用成本。

安装：opencode plugin install opencode-tokenscope

🔐 Gemini Auth — Google 账号认证 ▶

使用 Google 账号认证，连接 Gemini 计划，免费使用 Gemini 模型。

安装：opencode plugin install opencode-gemini-auth

🌳 Opencode Worktree — Git Worktree 管理 ▶

零摩擦 git worktree 管理，自动生成终端并清理。适合多分支并行开发。

安装：opencode plugin install opencode-worktree

🔄 Oh My Opencode — 后台 Agent 框架 ▶

后台 Agent、预置工具（LSP/AST/MCP）、精选 Agent 集合。大幅增强 OpenCode 能力。

安装：opencode plugin install oh-my-opencode

✂️ opencode-snip — Token 节省神器 ▶

自动为 shell 命令添加 snip 前缀，减少 Token 消耗 60-90%。适合大型项目。

安装：opencode plugin install opencode-snip

📝 Opencode Snippets — 代码片段扩展 ▶

即时内联文本扩展，支持组合式片段。提高代码复用效率。

安装：opencode plugin install opencode-snippets

⏱️ WakaTime — 编码活动追踪 ▶

集成 WakaTime，自动追踪你的编码活动，生成详细的编程统计报告。

安装：opencode plugin install opencode-wakatime

🌐 Google AI Search — AI 搜索增强 ▶

提供 Google AI Mode（SGE）搜索工具，获取更智能的搜索结果。

安装：opencode plugin install opencode-google-ai-search

🔗 更多插件：访问 Awesome OpenCode 发现更多社区插件。

📝 自定义命令中级

命令文件位置

bash

# 用户命令（全局）
~/.config/opencode/commands/
~/.opencode/commands/

# 项目命令（项目特定）
./.opencode/commands/

创建自定义命令

创建 prime-context.md 文件：

markdown — prime-context.md

RUN git ls-files
READ README.md
READ package.json

提示：分析项目结构和依赖关系

使用命令：按 Ctrl+K，输入 user:prime-context

命名参数

支持使用 $NAME 格式的命名参数：

markdown — view-issue.md

RUN gh issue view $ISSUE_NUMBER --json title,body,comments

提示：分析这个 GitHub Issue 并提供解决方案

使用时输入：user:view-issue ISSUE_NUMBER=123

命令类型

类型	语法	说明
`RUN`	`RUN <command>`	执行 shell 命令
`READ`	`READ <file>`	读取文件内容
`WRITE`	`WRITE <file> <content>`	写入文件
提示文本	自由文本	作为 AI 的提示

⌨️ 快捷键中级

全局快捷键

快捷键	功能
`Ctrl+C`	退出应用
`Ctrl+?`	切换帮助对话框
`Ctrl+L`	查看日志
`Ctrl+A`	切换会话
`Ctrl+K`	命令对话框
`Ctrl+O`	模型选择对话框
`Esc`	关闭当前覆盖层

聊天页面

快捷键	功能
`Ctrl+N`	创建新会话
`Ctrl+X`	取消当前操作
`Tab`	切换计划/构建模式
`i`	聚焦编辑器
`Esc`	退出编辑模式

编辑器

快捷键	功能
`Ctrl+S`	发送消息
`Ctrl+E`	打开外部编辑器
`@`	文件搜索引用

🏗️ 技术架构高级

整体架构

OpenCode 四层架构设计

核心组件

代理调度器▶

OpenCode 采用"主代理 + 子代理"的协作模式：

主代理：总调度，协调子代理执行顺序，处理跨任务依赖
子代理：领域专家（如图像生成、代码重构），执行单一子任务

支持 Self-Healing 自愈机制，任务失败时可自动重试或调整策略。

工具引擎▶

内置 20+ 工具，所有工具实现统一的 Tool 接口：

类别	工具
文件操作	glob, grep, ls, view, write, edit, patch
系统命令	bash, diagnostics
网络	fetch, sourcegraph
代理	agent（子代理调度）

模型适配器▶

统一模型接口设计，所有适配器需实现：

typescript

interface ModelAdapter {
  generate(prompt: string): Promise;
  embed(text: string): Promise;
  chat(messages: Message[]): Promise;
}

支持 OpenAI、Claude、本地模型（Ollama/vLLM），具备模型缓存、本地推理优化。

技术栈

组件	技术	说明
运行时	TypeScript + Bun	启动速度快 3x
TUI 框架	Bubble Tea (Go)	流畅的终端界面
存储	SQLite	会话和对话持久化
LSP	内置支持	代码智能提示

🏠 本地模型高级

为什么使用本地模型？

🔒 隐私优先

代码不会离开本地
无需网络连接
完全离线运行
无 API 费用

支持的本地模型方案

bash — Ollama 配置

# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 下载模型
ollama pull llama3.2
ollama pull codellama:7b
ollama pull deepseek-coder:6.7b

# 配置 OpenCode
export LOCAL_ENDPOINT="http://localhost:11434"

# 启动 OpenCode
opencode --model llama3.2

推荐模型：CodeLlama、DeepSeek-Coder、StarCoder2

bash — vLLM 配置

# 安装 vLLM
pip install vllm

# 启动服务器
python -m vllm.entrypoints.api_server \
  --model codellama/CodeLlama-7b-hf \
  --port 8000

# 配置 OpenCode
export LOCAL_ENDPOINT="http://localhost:8000"

bash — LM Studio 配置

# 1. 下载并安装 LM Studio
# https://lmstudio.ai/

# 2. 在 LM Studio 中下载模型（如 CodeLlama）

# 3. 启动本地服务器（在 LM Studio 中点击 "Start Server"）

# 4. 配置 OpenCode
export LOCAL_ENDPOINT="http://localhost:1234"

硬件建议

模型大小	GPU 显存	内存	示例模型
7B 参数	8GB	16GB	CodeLlama-7b, DeepSeek-Coder-6.7b
13B 参数	16GB	32GB	CodeLlama-13b
34B 参数	24GB	64GB	CodeLlama-34b
70B 参数	48GB+ (多卡)	128GB	Llama-3-70b

💡 提示：Apple Silicon Mac (M1/M2/M3) 的统一内存架构非常适合运行本地模型。

🔌 MCP 集成高级

什么是 MCP？

MCP（Model Context Protocol）是一个开放协议，允许 AI 模型与外部工具和数据源进行标准化交互。

通过 MCP 协议扩展 OpenCode 能力

配置 MCP 服务器

json — opencode.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/playwright-mcp-server"]
    }
  }
}

名称	功能	安装
GitHub	Issue/PR 管理	`npx @modelcontextprotocol/server-github`
PostgreSQL	数据库操作	`npx @modelcontextprotocol/server-postgres`
Playwright	浏览器自动化	`npx @executeautomation/playwright-mcp-server`
Filesystem	文件系统访问	`npx @modelcontextprotocol/server-filesystem`
Brave Search	网页搜索	`npx @modelcontextprotocol/server-brave-search`

🔒 隐私安全高级

隐私保护承诺

🛡️ OpenCode 的隐私原则

不存储代码：OpenCode 不会存储你的代码或上下文数据
本地存储：所有对话和历史记录仅保存在本地 SQLite 数据库
API 直接传递：代码直接传递给 AI 提供商，不经 OpenCode 服务器
支持离线：使用本地模型时完全离线运行

数据流向

数据流向：代码只经本地处理，可选择本地模型完全离线

安全最佳实践

API 密钥管理▶

bash

# ✅ 推荐：使用环境变量
export ANTHROPIC_API_KEY="sk-ant-..."

# ❌ 避免：硬编码在配置文件中
# 不要将 API 密钥写入 .opencode.json

# ✅ 使用 .env 文件（添加到 .gitignore）
echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env
echo ".env" >> .gitignore

敏感项目处理▶

使用计划模式查看敏感文件，避免意外修改
使用本地模型确保代码不离本地
在 .opencode.json 中配置文件排除规则

json

{
  "exclude": [
    "**/.env",
    "**/secrets/**",
    "**/credentials.json"
  ]
}

📋 速查表

安装命令

bash

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

# Homebrew
brew install opencode-ai/tap/opencode

# npm
npm install -g opencode-ai@latest

# Go
go install github.com/opencode-ai/opencode@latest

常用命令

命令	说明
`opencode`	启动 TUI
`opencode -c /path`	指定工作目录
`opencode -p "问题"`	非交互式提问
`opencode -d`	调试模式
`/init`	初始化项目
`/undo`	撤销更改
`/redo`	重做更改
`/share`	分享对话

快捷键

快捷键	功能
`Tab`	切换计划/构建模式
`Ctrl+O`	切换模型
`Ctrl+K`	命令对话框
`Ctrl+N`	新会话
`Ctrl+S`	发送消息（编辑器中）
`@`	文件搜索引用

环境变量

bash

export ANTHROPIC_API_KEY="sk-ant-..."   # Claude
export OPENAI_API_KEY="sk-..."           # OpenAI
export GEMINI_API_KEY="AIza..."          # Gemini
export GITHUB_TOKEN="ghp_..."            # GitHub Copilot
export GROQ_API_KEY="gsk_..."            # Groq
export LOCAL_ENDPOINT="http://localhost:11434"  # Ollama

❓ 常见问题

OpenCode 和 Claude Code 有什么区别？▶

维度	OpenCode	Claude Code
开源	✅ MIT	❌ 闭源
价格	免费（API 自付）	$20-200/月
模型	75+ 提供商	仅 Claude
本地模型	✅ 支持	❌ 不支持
高级功能	基础	丰富（Skills/Hooks）

OpenCode 项目状态如何？▶

原 OpenCode 仓库已于 2025 年 9 月归档，项目已迁移至 Crush（由 Charm 团队维护）。

目前仍有大量用户使用 OpenCode，社区活跃。建议关注 Crush 项目的发展。

如何选择模型？▶

推荐：OpenCode Zen（官方优化服务）
性价比：Claude 3.5 Sonnet / GPT-4.1-mini
免费：本地模型（Ollama + CodeLlama）
最快：Groq + Llama 3.3

支持哪些编程语言？▶

OpenCode 内置 LSP 支持，可以处理所有主流编程语言：

TypeScript/JavaScript、Python、Go、Rust、Java、C/C++、Ruby、PHP 等。

如何贡献代码？▶

原仓库已归档，新开发在 Crush 项目中进行。

欢迎参与社区贡献！

🔍 主流 AI 编程工具对比 必读

💡 如何选择？

⬇️ 安装与环境 入门

系统要求

安装方式

验证安装

桌面应用

🚀 5分钟上手 入门

第一步：配置 API 密钥

第二步：初始化项目

📄 AGENTS.md 文件

第三步：开始对话

第四步：切换工作模式

💬 基础命令 入门

斜杠命令

CLI 参数

文件引用语法

非交互式使用

🤖 模型配置 入门

支持的 AI 提供商

模型列表

切换模型

OpenCode Zen（推荐）

🌟 什么是 Zen？

🔄 工作模式 入门

双模式详解

推荐工作流

撤销与重做

⚙️ 配置详解 中级

配置文件位置

配置示例

配置项说明

AGENTS.md 项目配置

🎯 热门 Skills 推荐 中级

🔍 Deep Research

🌐 Web Search

📊 XLSX

📄 PDF

🎨 AI Image Gen

📝 DOCX

📊 PPTX Generator

🤖 MCP Builder

🔍 Find Skills

✍️ Humanizer

🔌 热门插件推荐 中级

📝 自定义命令 中级

命令文件位置

创建自定义命令

命名参数

命令类型

⌨️ 快捷键 中级

全局快捷键

聊天页面

编辑器

🏗️ 技术架构 高级

整体架构

核心组件

技术栈

🏠 本地模型 高级

为什么使用本地模型？

🔒 隐私优先

支持的本地模型方案

硬件建议

🔌 MCP 集成 高级

什么是 MCP？

配置 MCP 服务器

热门 MCP 服务器

🔒 隐私安全 高级

隐私保护承诺

🛡️ OpenCode 的隐私原则

数据流向

安全最佳实践

📋 速查表

安装命令

常用命令

快捷键

环境变量

❓ 常见问题

🔍 主流 AI 编程工具对比必读

⬇️ 安装与环境入门

🚀 5分钟上手入门

💬 基础命令入门

🤖 模型配置入门

🔄 工作模式入门

⚙️ 配置详解中级

🎯 热门 Skills 推荐中级

🔌 热门插件推荐中级

📝 自定义命令中级

⌨️ 快捷键中级

🏗️ 技术架构高级

🏠 本地模型高级

🔌 MCP 集成高级

🔒 隐私安全高级