5分钟掌握 OpenCode：开源 AI 编程助手新人完整指南

作者注：OpenCode 是一款基于终端的开源 AI 编程助手，支持 Claude、OpenAI、Gemini 等多种大模型。本文提供完整的安装配置和使用教程，帮助新人快速上手这款 65万+开发者信赖的工具

想在终端中使用 AI 辅助编程，但不想被单一服务商绑定？OpenCode 是目前最受欢迎的开源解决方案，GitHub 星标超过 7万，每月有 65万+开发者在使用。

核心价值: 读完本文，你将学会安装配置 OpenCode、连接多种 AI 模型，并掌握日常开发中最实用的功能。

OpenCode AI 编程助手核心要点

OpenCode 是什么

OpenCode 是一个基于 Go 语言开发的命令行 AI 编程助手。与 Claude Code、Cursor 等商业工具不同，OpenCode 完全开源，允许开发者自由选择 AI 提供商——可以是 Claude、OpenAI、Google Gemini，也可以是本地运行的开源模型。

它采用 Bubble Tea 框架构建了精美的终端用户界面（TUI），提供流畅的交互体验。你可以在 VS Code、Cursor 或任何支持终端的 IDE 中使用它。

OpenCode 核心优势

隐私与安全：OpenCode 默认不向远程服务器发送你的代码。选择模型提供商和数据共享范围完全由你控制。如果使用本地模型，整个工作流都可以保持私密。

灵活的模型选择：虽然官方推荐 OpenCode Zen 服务，但你可以自由接入任何兼容的 AI 服务。通过 API易 等聚合平台，可以使用统一接口调用 Claude、GPT、Gemini 等多种模型。

OpenCode 安装配置指南

安装方式

OpenCode 支持多种安装方式，选择适合你系统的方法：

快速配置流程

安装完成后，按以下步骤配置：

第一步：启动 OpenCode

# 进入你的项目目录
cd your-project

# 启动 OpenCode
opencode

第二步：连接 AI 提供商

在 OpenCode 界面中执行 /connect 命令，选择你的 AI 服务提供商并完成认证。

第三步：初始化项目

执行 /init 命令，OpenCode 会分析你的代码库结构并生成 AGENTS.md 配置文件，帮助 AI 更好地理解项目上下文。

极简示例

以下是使用 API易 接入 OpenCode 的配置示例：

# 设置环境变量
export OPENAI_API_KEY="your-apiyi-key"
export OPENAI_API_BASE="https://vip.apiyi.com/v1"

# 启动 OpenCode
opencode

{
  "providers": {
    "apiyi": {
      "apiKey": "your-apiyi-key",
      "baseURL": "https://vip.apiyi.com/v1",
      "models": [
        "claude-sonnet-4-20250514",
        "gpt-4o",
        "gemini-2.0-flash"
      ]
    }
  },
  "defaultProvider": "apiyi",
  "defaultModel": "claude-sonnet-4-20250514"
}

配置建议: 通过 API易 apiyi.com 平台获取 API Key，可以使用统一接口调用 Claude、GPT、Gemini 等主流模型，无需分别注册多个服务商账号。

OpenCode 核心功能详解

双模式切换

OpenCode 提供两种内置工作模式，按 Tab 键即可切换：

Plan 模式特点：

• 默认拒绝文件编辑操作
• 执行 bash 命令前需确认
• 适合理解代码逻辑后再动手修改

文件引用语法

使用 @ 符号引用特定文件，让 AI 获得更精准的上下文：

@src/components/Button.tsx 这个组件的 props 类型定义有问题，请帮我修复

常用命令

自定义命令

OpenCode 支持创建自定义命令，将常用提示词保存为 Markdown 文件：

<!-- ~/.config/opencode/commands/review.md -->
请对当前文件进行代码审查，关注以下方面：
1. 潜在的性能问题
2. 安全漏洞
3. 代码可读性
4. 最佳实践遵循情况

保存后，在 OpenCode 中执行 /review 即可调用。

OpenCode 进阶功能

GitHub 集成

OpenCode 可以直接集成到 GitHub 工作流中。在 PR 或 Issue 评论中使用 /opencode 或 /oc 触发：

• 问题分析：让 OpenCode 解读和分析 Issue
• 自动修复：OpenCode 在新分支工作，完成后自动提交 PR
• 安全执行：所有操作在 GitHub Actions Runner 中隔离运行

LSP 集成

OpenCode 支持语言服务器协议（LSP），提供：

• 多语言代码智能提示
• 实时错误诊断
• 自动文件变更监控

MCP 协议支持

OpenCode 支持 Model Context Protocol（MCP），可以添加自定义的 MCP 服务器扩展功能边界。

OpenCode 使用技巧

高效工作流建议

最佳实践

1. 善用 Plan 模式：在不确定时先用只读模式探索，避免意外修改
2. 精确引用文件：使用 @filename 给 AI 提供上下文，结果更准确
3. 分步执行复杂任务：将大任务拆解，每步确认后再继续
4. 定期使用 /init：项目结构变化后重新初始化，保持上下文同步

常见问题

总结

OpenCode AI 编程助手的核心要点：

1. 开源免费：MIT 协议，7万+ GitHub 星标，65万+开发者信赖
2. 多模型灵活：支持 Claude、OpenAI、Gemini 等主流模型，可自由切换
3. 隐私可控：代码不经 OpenCode 服务器，支持本地模型完全离线
4. 高效易用：终端原生体验，双模式切换，丰富的自定义能力

对于想要在终端中使用 AI 辅助编程的开发者，OpenCode 是目前最值得尝试的开源方案。

推荐通过 API易 apiyi.com 快速体验多模型切换能力，平台提供免费额度和 OpenAI/Claude/Gemini 原生格式的统一接口。

📚 参考资料

⚠️ 链接格式说明: 所有外链使用 资料名: domain.com 格式，方便复制但不可点击跳转，避免 SEO 权重流失。

1. OpenCode 官网: 项目官方网站，提供安装包下载和文档

   • 链接: opencode.ai
   • 说明: 获取最新版本和官方教程

2. OpenCode GitHub 仓库: 开源代码和 Issue 讨论

   • 链接: github.com/opencode-ai/opencode
   • 说明: 查看源码、提交 Bug 反馈

3. OpenCode 官方文档: 详细的配置和使用指南

   • 链接: opencode.ai/docs
   • 说明: 深入了解高级功能和配置选项

4. API易 开发者平台: 多模型 API 聚合服务

   • 链接: apiyi.com
   • 说明: 获取统一接口调用 Claude、GPT、Gemini 等模型

作者: 技术团队
技术交流: 欢迎在评论区讨论，更多资料可访问 API易 apiyi.com 技术社区