第21章 OpenCode

OpenCode 是一款终端 AI 编程工具，可以通过按量计费、Coding Plan、Token Plan 个人版或 Token Plan 团队版接入阿里云百炼。 ​安装 OpenCode 安装 Node.js（v18.0 或更高版本）。 在终端中执行以下命令安装 OpenCode： Copynpm install -g opencode-ai 运行以下命令验证安装。若有版本号输出，则表示安装成功。 Copyopencode -v ​配置接入凭证 使用文本编辑器打开： macOS / Linux：~/.config/opencode/opencode.json Windows：C:\Users\<用户名>\.config\opencode\opencode.json 根据所选方案写入对应配置： Token Plan 个人版：个人订阅，按 token 消耗抵扣 Credits。 Token Plan 团队版：按坐席订阅，按 token 消耗抵扣 Credits。 Coding Plan：固定月费订阅，按模型调用次数计量。 按量计费：按实际调用量后付费。 ​Token Plan 个人版 需先购买 Token Plan 个人版套餐且套餐处于有效期内。可在Token Plan 个人版页面购买套餐。 将 YOUR_API_KEY 替换为 Token Plan 个人版专属 API Key。可用模型请参考 Token Plan 个人版支持的模型。 Copy{ "$schema": "https://opencode.ai/config.json", "provider": { "bailian-token-plan-personal": { "npm": "@ai-sdk/anthropic", "name": "Alibaba Cloud Model Studio", "options": { "baseURL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1", "apiKey": "YOUR_API_KEY" }, "models": { "auto": { "name": "Auto", "modalities": { "input": ["text"], "output": ["text"] } }, "qwen3.8-max": { "name": "Qwen3.8 Max", "reasoning": true, "limit": { "context": 983616, "output": 131072 }, "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "effort": "xhigh" } }, "qwen3.8-flash": { "name": "Qwen3.8 Flash", "reasoning": true, "limit": { "context": 983616, "output": 131072 }, "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "effort": "xhigh" } }, "qwen3.7-max": { "name": "Qwen3.7 Max", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.7-plus": { "name": "Qwen3.7 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.6-flash": { "name": "Qwen3.6 Flash", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "glm-5.3": { "name": "GLM-5.3", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "glm-5.2": { "name": "GLM-5.2", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" }, "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }, "deepseek-v4-pro-0813": { "name": "DeepSeek V4 Pro 0813" }, "deepseek-v4-flash-0731": { "name": "DeepSeek V4 Flash 0731" } } } } } ​Token Plan 团队版 需先购买 Token Plan 团队版套餐且套餐处于有效期内。可在Token Plan 团队版页面购买套餐。 将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。可用模型请参考 Token Plan 团队版支持的模型。 Copy{ "$schema": "https://opencode.ai/config.json", "provider": { "bailian-token-plan": { "npm": "@ai-sdk/anthropic", "name": "Alibaba Cloud Model Studio", "options": { "baseURL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1", "apiKey": "YOUR_API_KEY" }, "models": { "auto": { "name": "Auto", "modalities": { "input": ["text"], "output": ["text"] } }, "qwen3.8-max": { "name": "Qwen3.8 Max", "reasoning": true, "limit": { "context": 983616, "output": 131072 }, "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "effort": "xhigh" } }, "qwen3.8-flash": { "name": "Qwen3.8 Flash", "reasoning": true, "limit": { "context": 983616, "output": 131072 }, "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "effort": "xhigh" } }, "qwen3.7-max": { "name": "Qwen3.7 Max", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.7-plus": { "name": "Qwen3.7 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.6-plus": { "name": "Qwen3.6 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.6-flash": { "name": "Qwen3.6 Flash", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" }, "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }, "deepseek-v4-pro-0813": { "name": "DeepSeek V4 Pro 0813" }, "deepseek-v4-flash-0731": { "name": "DeepSeek V4 Flash 0731" }, "kimi-k2.7-code": { "name": "Kimi K2.7 Code", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "kimi-k2.6": { "name": "Kimi K2.6", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "kimi-k2.5": { "name": "Kimi K2.5", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "glm-5.3": { "name": "GLM-5.3", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "glm-5.2": { "name": "GLM-5.2", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "glm-5.1": { "name": "GLM-5.1", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "glm-5": { "name": "GLM-5", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "MiniMax-M2.5": { "name": "MiniMax M2.5" } } } } } ​Coding Plan 将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。可用模型请参考 Coding Plan 支持的模型。 Copy{ "$schema": "https://opencode.ai/config.json", "provider": { "bailian-coding-plan": { "npm": "@ai-sdk/anthropic", "name": "Alibaba Cloud Model Studio", "options": { "baseURL": "https://coding.dashscope.aliyuncs.com/apps/anthropic/v1", "apiKey": "YOUR_API_KEY" }, "models": { "qwen3.7-plus": { "name": "Qwen3.7 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 1024 } } }, "qwen3.6-plus": { "name": "Qwen3.6 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 1024 } } }, "qwen3.5-plus": { "name": "Qwen3.5 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 1024 } } }, "MiniMax-M2.5": { "name": "MiniMax M2.5" }, "glm-5": { "name": "GLM-5", "options": { "thinking": { "type": "enabled", "budgetTokens": 1024 } } }, "kimi-k2.5": { "name": "Kimi K2.5", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 1024 } } } } } } } ​按量计费 将 YOUR_API_KEY 替换为阿里云百炼 API Key。可用模型请参考Anthropic 兼容 API。 baseURL 按地域设置（将 {WorkspaceId} 替换为真实的Workspace ID），API Key 需与所选地域对应： 华北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1 美国（弗吉尼亚）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/apps/anthropic/v1 Copy{ "$schema": "https://opencode.ai/config.json", "provider": { "bailian-payg": { "npm": "@ai-sdk/anthropic", "name": "Alibaba Cloud Model Studio", "options": { "baseURL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic/v1", "apiKey": "YOUR_API_KEY" }, "models": { "qwen3.7-max": { "name": "Qwen3.7 Max", "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.7-plus": { "name": "Qwen3.7 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } }, "qwen3.6-plus": { "name": "Qwen3.6 Plus", "modalities": { "input": ["text", "image"], "output": ["text"] }, "options": { "thinking": { "type": "enabled", "budgetTokens": 8192 } } } } } } } 如需添加其他模型，在 models 中以相同格式追加即可。 ​验证配置 保存配置后，重启 OpenCode，输入 /models，搜索 Alibaba Cloud Model Studio，选择需要使用的模型即可开始对话。 ​常见问题 ​错误码 配置过程中遇到报错，请参考对应计费方案的常见问题文档： 按量付费：Anthropic API 兼容 - 错误码 Coding Plan：Coding Plan 常见问题 Token Plan 个人版：Token Plan 个人版常见问题 Token Plan 团队版：Token Plan 团队版常见问题