OpenCode 教程：开源终端 AI 编程助手接国产模型（2026）

OpenCode 是近两年热度飙升的一款开源终端 AI 编程助手：你在命令行里用自然语言描述需求，它读你的代码库、跨文件改代码、跑测试、改 bug，全程在终端里完成。它和 Claude Code、Codex CLI、Aider 属于同一类「住在终端里的 agentic 编程工具」，最大的卖点是彻底的模型自由——底层对接了数十家模型提供商，想接 DeepSeek、GLM、Kimi 等国产模型只要几步配置。这篇 OpenCode 教程带你从安装、第一次上手，到接国产模型和常用命令一次跑通。

OpenCode 是什么

OpenCode 是一个开源、免费的终端优先（terminal-first）AI 编程代理。你在项目目录里启动它，它会分析整个仓库，然后按你的自然语言指令去读写代码、执行命令、修复问题。它的三个关键特点：一是纯终端 TUI 界面，轻量、跨平台，不绑定任何编辑器；二是模型完全自由，通过统一的接口对接了非常多的模型提供商，既能用 Claude、GPT、Gemini，也能接 DeepSeek、GLM、Kimi 甚至本地模型；三是开源、社区活跃，配置和插件生态都很开放。对喜欢命令行、想低成本用国产模型跑真实项目的开发者特别友好。

安装：Mac / Linux / Windows 任选

OpenCode 提供多种安装方式，Mac/Linux 最快是官方一键脚本，跨平台可以用 npm，Windows 用户用 scoop 或 choco 更顺手。任选其一即可：

# Mac / Linux：官方一键安装脚本
curl -fsSL https://opencode.ai/install | bash

# 跨平台：用 npm 全局安装
npm install -g opencode-ai

# macOS：Homebrew
brew install anomalyco/tap/opencode

# Windows：scoop 或 choco 任选
scoop install opencode
choco install opencode

# 装好后，进到你的项目目录直接启动
cd /path/to/your/project
opencode

第一次上手：/init 与 Build / Plan 模式

在项目目录里启动 opencode 后，先运行 /init。它会扫描你的项目结构，生成一份 AGENTS.md 上下文文件（这套「项目说明书」约定和 Claude Code 的 CLAUDE.md 同源，站内有专门文章讲怎么写）。之后你就能用自然语言下达需求了。OpenCode 内置两种工作模式，用 Tab 键随时切换：

• Build（构建模式，默认）：完整权限，AI 可以真的读写文件、执行命令，用于实际开发。
• Plan（规划模式，只读）：不改代码，只分析仓库、给出实现方案，适合先想清楚再动手。
• 按 Tab 键在两种模式间来回切换——复杂改动建议先 Plan 出方案，确认后再切 Build 落地。

接 DeepSeek：最省事的国产选择

接国产模型时，DeepSeek 是最顺的选择——OpenCode 的模型目录里内置了 DeepSeek，用 /connect 命令交互式添加即可，不用手写配置。先到 DeepSeek 开放平台申请 API Key，然后在 OpenCode 里操作：

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

# 在 TUI 里输入斜杠命令连接模型
/connect
# 选择 deepseek，粘贴你的 DeepSeek API Key

# 再用 /models 选择要用的 DeepSeek 模型
/models

# 也可以先设环境变量再启动（二选一）
# Mac/Linux：export DEEPSEEK_API_KEY=你的密钥
# Windows PowerShell：setx DEEPSEEK_API_KEY 你的密钥（设置后重开终端）

接 GLM / Kimi / 本地模型：OpenAI 兼容配置

智谱 GLM、月之暗面 Kimi（Moonshot）等大多提供「OpenAI 兼容」接口，本地 Ollama、vLLM 也一样。这类模型走 OpenCode 的通用 OpenAI 兼容通道：在配置文件 opencode.json 里加一个 provider，指定 npm 适配器为 @ai-sdk/openai-compatible，填对厂商网关地址和模型名即可。配置文件放在用户目录（~/.config/opencode/opencode.json）或项目根目录都行。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "glm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "智谱 GLM",
      "options": {
        "baseURL": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "{env:GLM_API_KEY}"
      },
      "models": {
        "glm-4.6": { "name": "GLM-4.6" }
      }
    },
    "kimi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kimi / Moonshot",
      "options": {
        "baseURL": "https://api.moonshot.cn/v1",
        "apiKey": "{env:MOONSHOT_API_KEY}"
      },
      "models": {
        "kimi-k2": { "name": "Kimi K2" }
      }
    }
  }
}

常用命令与快捷键速查

OpenCode 和 Claude Code、Aider、Cline 怎么比

它们都是「用 AI 帮你改代码」的工具，但形态不同：Claude Code 是 Anthropic 出品的终端 agent，能力强、生态成熟，但模型偏向 Claude（国内要接第三方网关）；Aider 是老牌开源终端工具，以自动 Git 提交、一键回滚为核心；Cline 是跑在 VS Code 里的插件，带图形界面。OpenCode 的差异点在于：纯开源、终端优先、且模型自由度极高，天然亲和国产 API，还内置了 Build/Plan 双模式。这几个工具并不冲突，可以都装、按任务和预算混着用——想了解 Claude Code 怎么接国产模型、或还有哪些国产平替 CLI，站内都有对应实测教程。

OpenCode 把「在终端里低成本用上 AI 编程」做得很彻底，接国产模型也只是几步配置的事。但工具越顺手，越考验你会不会拆需求、审代码、把 AI 的产出稳定用进真实项目——这才是真正拉开差距的地方。想系统掌握用 AI 工具做出能交付产品的方法，欢迎来 IMAI 看看我们的体系化实战课程。