跳到主要内容
feedback
feedback

OpenCode

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

提示

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

1. 安装 OpenCode​

安装 OpenCode 最简单的方式是通过安装脚本。

使用安装脚本（推荐）​

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

使用 Node.js​

npm​

npm install -g opencode-ai

Bun​

bun install -g opencode-ai

pnpm​

pnpm add -g opencode-ai

Yarn​

yarn global add opencode-ai

使用 Homebrew（macOS / Linux）​

brew install anomalyco/tap/opencode
提示

推荐使用 OpenCode tap 以获取最新版本。官方的 brew install opencode 由 Homebrew 团队维护，更新频率较低。

使用 Paru（Arch Linux）​

paru -S opencode-bin

Windows 安装​

使用 Chocolatey​

choco install opencode

使用 Scoop​

scoop bucket add extras
scoop install extras/opencode

使用 NPM​

npm install -g opencode-ai

使用 Mise​

mise use -g github:anomalyco/opencode

使用 Docker​

docker run -it --rm ghcr.io/anomalyco/opencode

验证安装是否成功​

安装完成后，打开终端，输入以下命令：

opencode --version

如果显示版本号，说明安装成功了！

备注

你也可以从 GitHub Releases 下载二进制文件直接使用。

2. 获取访问令牌​

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

3. 配置 OpenCode​

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

推荐模型：

  • MiniMax-M2.1（首选）：支持 20 万 tokens 上下文窗口，非常适合处理大型代码库
  • GLM-4.7：智谱最新旗舰模型，支持 128K 上下文，性能卓越

方法一：通过配置文件设置（推荐）​

3.1 创建或编辑配置文件​

OpenCode 的配置文件可以放在以下两个位置：

  • 全局配置：~/.config/opencode/opencode.json （对所有项目生效）
  • 项目配置：项目根目录下的 opencode.json （仅对当前项目生效）

使用以下命令编辑配置文件：

# 编辑全局配置
vim ~/.config/opencode/opencode.json

# 或编辑项目配置
vim opencode.json

3.2 添加模力方舟 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": {
        "MiniMax-M2.1": {
          "name": "MiniMax-M2.1",
          "limit": {
            "context": 200000,
            "output": 200000
          }
        },
        "GLM-4.7": {
          "name": "GLM-4.7",
          "limit": {
            "context": 200000,
            "output": 128000
          }
        }
      }
    }
  }
}

配置说明：

  • provider.moark：自定义 Provider ID，可以自行命名（建议使用 moark）
  • npm：使用 OpenAI 兼容的 SDK
  • name：Provider 的显示名称
  • options.baseURL：API 基础地址
  • options.apiKey：你的 API 密钥（访问令牌）
  • models：可用的模型列表
    • name：模型显示名称
    • limit.context：上下文窗口大小（tokens）
    • limit.output：最大输出长度（tokens）
提示

推荐直接在配置文件中设置 apiKey，也可以使用环境变量方式配置。

方法二：通过环境变量设置（可选）​

你也可以通过环境变量来配置 API Key，而不是直接在配置文件中写入。

Windows (PowerShell)​

临时设置（当前会话）

$env:MOARK_API_KEY = "你的API密钥"

永久设置（用户级）

[System.Environment]::SetEnvironmentVariable("MOARK_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)

macOS / Linux / WSL2​

临时设置（当前会话）

export MOARK_API_KEY="你的API密钥"

永久设置

将以下内容添加到你的 shell 配置文件中：

# 对于 zsh（macOS 默认）
echo "export MOARK_API_KEY=你的API密钥" >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo "export MOARK_API_KEY=你的API密钥" >> ~/.bash_profile
source ~/.bash_profile

然后在配置文件中引用环境变量：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "moark": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "模力方舟",
      "options": {
        "baseURL": "https://ai.gitee.com/v1",
        "apiKey": "${MOARK_API_KEY}"
      },
      "models": {
        "MiniMax-M2.1": {
          "name": "MiniMax-M2.1",
          "limit": {
            "context": 200000,
            "output": 200000
          }
        },
        "GLM-4.7": {
          "name": "GLM-4.7",
          "limit": {
            "context": 200000,
            "output": 128000
          }
        }
      }
    }
  }
}

重要提示：记得将 "你的API密钥" 替换为在步骤 2 中获取的实际访问令牌。

4. 选择模型​

配置完成后，启动 OpenCode：

opencode

在 OpenCode 交互界面中，使用 /models 命令来选择或切换模型：

/models

然后在弹出的模型列表中选择想要使用的模型。

5. 开始使用 OpenCode​

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

opencode

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

常用命令​

启动 OpenCode

opencode

在 OpenCode 中切换模型

进入 OpenCode 后，使用以下命令：

/models

故障排查​

1. 无法连接到 API​

问题现象：提示连接失败或网络错误

解决方案：

  • 检查 baseURL 是否正确配置为 https://ai.gitee.com/v1
  • 确认网络连接正常
  • 检查是否需要配置代理

2. API Key 无效​

问题现象：提示认证失败或 API Key 无效

解决方案：

  • 确认在模力方舟平台正确获取了访问令牌
  • 检查 API Key 是否正确复制（没有多余空格）
  • 尝试重新生成访问令牌

3. 模型不可用​

问题现象：选择模型后无法使用

解决方案：

  • 检查模型 ID 是否正确（访问 AI 模型广场 确认）
  • 确认你的账户有权限使用该模型
  • 检查配置文件中的模型配置是否正确

4. 配置文件不生效​

问题现象：修改配置后没有变化

解决方案：

  • 确认配置文件路径正确
  • 检查 JSON 格式是否正确（可以使用 JSON 验证工具）
  • 退出并重新启动 OpenCode

更多资源​

Copyright © 2026 模力方舟京ICP备2025119063号京公网安备11011502039387号京公网安备11011502039387号