OpenCode

OpenCode 是一款现代化的 AI 编程助手工具，支持多种 AI 模型提供商。通过自定义 Provider 配置，你可以轻松接入模力方舟的优质编码模型。

模力方舟提供对 OpenCode 的原生支持，你可以使用模力方舟的任一编码模型，享受更优质的中文支持和更低的调用成本。

安装 OpenCode

OpenCode 是在终端中运行的 CLI 工具。

使用安装脚本

curl -fsSL https://opencode.ai/install | bash

使用 npm

npm 安装需要 Node.js。请从 Node.js 官方下载页面下载 LTS 版本：

Windows：选择 Windows Installer (.msi)。
macOS：选择 macOS Installer (.pkg)。
Linux：选择与系统架构对应的 Linux Binary (.tar.xz)。

npm install -g opencode-ai

安装完成后，重新打开终端并运行以下命令验证：

opencode --version

如需下载独立二进制文件，可前往 OpenCode GitHub Releases。安装方式与系统支持可能随版本更新，最新信息请以 OpenCode 官方安装文档为准。

获取访问令牌

开发者首先需要访问 工作台->设置->访问令牌 中获取访问令牌，没有购买 Serverless API 的开发者，可以使用免费体验访问令牌（仅供体验，每日调用次数有限），复制想要使用的令牌即可。

访问令牌页面

配置 OpenCode

OpenCode 支持通过配置文件或命令行的方式添加自定义 Provider。下面介绍两种配置方式。

使用 CC Switch 自动配置（推荐）

CC Switch 可集中管理 OpenCode 的服务商、API Key 和模型配置，并支持一键切换。

在 CC Switch 中选择 OpenCode，添加并启用模力方舟供应商配置即可。包含下载安装、访问令牌、请求地址、模型配置及验证的完整操作，请参阅 CC Switch 快速配置。

OpenCode 的请求地址、上游格式和模型参数，可通过工具配置参考快速获取。

通过配置文件设置

创建或编辑配置文件

使用文本编辑器打开：

macOS / Linux：~/.config/opencode/opencode.json
Windows：C:\Users\<用户名>\.config\opencode\opencode.json

Windows 默认创建 C:\Users\<用户名>\.config\opencode\opencode.jsonc，直接编辑即可。

添加模力方舟 Provider 配置

在配置文件中添加以下内容：

{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "moark": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Moark",
      "options": {
        "baseURL": "https://ai.gitee.com/v1",
        "apiKey": "你的 API 密钥"
      },
      "models": {
        "deepseek-v4-flash-0731": {
          "name": "DeepSeek-V4-Flash"
        },
        "DeepSeek-V4-Pro": {
          "name": "DeepSeek-V4-Pro"
        }
      }
    }
  },

  "model": "moark/deepseek-v4-flash"//默认模型
}

开始使用 OpenCode

配置完成后，你就可以开始使用 OpenCode 了！在任何目录下运行：

opencode

这将启动 OpenCode 交互界面，你可以开始与 AI 编程助手进行对话了。

在 OpenCode 中切换模型

进入 OpenCode 后，使用以下命令选择模型：

/models

常见故障排查

opencode 命令不存在：确认已完成安装，然后完全关闭并重新打开终端；仍不可用时，请重新执行安装命令。
认证失败或无法连接：检查访问令牌是否有效，并确认 baseURL 为 https://ai.gitee.com/v1、apiKey 没有多余空格。
模型不可用：确认 provider 中的模型 ID 正确，并在 OpenCode 中通过 /models 选择已配置的模型。
配置未生效：确认配置文件路径正确；Windows 默认使用 opencode.jsonc。修改后完全退出并重新启动 OpenCode。

安装 OpenCode​

使用安装脚本​

使用 npm​

获取访问令牌​

配置 OpenCode​

使用 CC Switch 自动配置（推荐）​

通过配置文件设置​

创建或编辑配置文件​

添加模力方舟 Provider 配置​

开始使用 OpenCode​

在 OpenCode 中切换模型​

常见故障排查​

更多资源​