Skip to content

OpenCode#

OpenCode 是一个开源的 AI 编程助手工具，支持多种大语言模型，可在终端中直接使用。

主要特点#

  • 🚀 多模型支持：支持 OpenAI、Anthropic、阿里云百炼等多种模型提供商
  • 💻 终端集成：直接在终端中使用，与开发工作流无缝集成
  • 🔧 灵活配置：支持自定义模型配置和参数
  • 📦 易于安装：通过 npm 一键安装

安装#

前置要求#

  • Node.js >= 18.x
  • npm >= 9.x

安装步骤#

# 配置国内镜像源（可选，推荐国内用户使用）
npm config set registry https://registry.npmmirror.com

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

验证安装#

# 查看版本
opencode --version

# 启动 opencode
opencode

配置#

配置文件位置#

配置文件位于 ~/.config/opencode/opencode.json

配置阿里云百炼 Coding Plan#

1. 订阅 Coding Plan#

访问 阿里云百炼控制台 - 订阅套餐，根据实际需求选择并购买套餐。

2. 获取 API Key 和 Base URL#

  • API Key：访问 Coding Plan 页面 获取专属 API Key，格式为 sk-sp-xxxxx

    ⚠️ 注意：请勿与百炼通用 API Key（格式为 sk-xxxxx）混用

  • Base URL：根据 API 协议选择对应的 Base URL

协议类型 Base URL
OpenAI 兼容协议 https://coding.dashscope.aliyuncs.com/v1
Anthropic 兼容协议 https://coding.dashscope.aliyuncs.com/apps/anthropic

⚠️ 注意：请勿和百炼通用 Base URL（格式为 dashscope.aliyuncs.xxx）混用

3. 配置示例#

将以下内容保存到 ~/.config/opencode/opencode.json，并将 YOUR_API_KEY 替换为您的 Coding Plan 专属 API Key：

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "bailian-coding-plan": {
            "npm": "@ai-sdk/anthropic",
            "name": "Model Studio Coding Plan",
            "options": {
                "baseURL": "https://coding.dashscope.aliyuncs.com/apps/anthropic/v1",
                "apiKey": "YOUR_API_KEY"
            },
            "models": {
                "qwen3.5-plus": {
                    "name": "Qwen3.5 Plus",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 1024
                        }
                    }
                },
                "qwen3-max-2026-01-23": {
                    "name": "Qwen3 Max 2026-01-23",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 1024
                        }
                    }
                },
                "qwen3-coder-plus": {
                    "name": "Qwen3 Coder Plus"
                },
                "qwen3-coder-next": {
                    "name": "Qwen3 Coder Next"
                }
            }
        }
    }
}

配置 OpenAI 兼容模型#

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "openai-compatible": {
            "npm": "@ai-sdk/openai",
            "name": "OpenAI Compatible",
            "options": {
                "baseURL": "https://api.openai.com/v1",
                "apiKey": "YOUR_OPENAI_API_KEY"
            },
            "models": {
                "gpt-4": {
                    "name": "GPT-4"
                },
                "gpt-3.5-turbo": {
                    "name": "GPT-3.5 Turbo"
                }
            }
        }
    }
}

使用#

启动 OpenCode#

opencode

常用命令#

命令 说明
/models 查看并切换模型
/help 查看帮助信息
/config 查看当前配置
/exit 退出 OpenCode

切换模型#

  1. 在命令行输入 /models
  2. 输入模型名称（如 Model Studio Coding Plan）
  3. 选择要使用的模型后即可开始对话

参考链接#