OpenCode 2.1.280+原生支持LongCat-2.5,需升级并配置config.yaml中model.provider=custom及API密钥;支持图片base64多模态输入与agent长程任务,须正确设置tools参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

确认OpenCode版本兼容性
OpenCode 2.1.280及以上版本原生支持LongCat-2.5,低于此版本将无法识别model.provider=custom配置。打开终端执行opencode --version验证当前版本,若显示低于2.1.280,请先运行pip install --upgrade opencode升级。
配置LongCat-2.5为默认模型
在OpenCode项目根目录下找到.opencode/config.yaml文件,用文本编辑器打开。
将原有provider字段替换为:
model:
provider: custom
name: longcat-2.5
api_base: https://api.longcat.ai/v1
api_key: sk-xxx(从longcat.chat/platform/api获取)
【必须删除原有anthropic或openai相关配置块,否则OpenCode会优先加载旧配置】
启用多模态输入能力
方法一:命令行直接调用
在项目目录中执行opencode run --image ./screenshot.png --prompt "分析这个网页UI结构并生成React组件",支持PNG/JPG格式图片与文本混合输入。
方法二:代码内嵌调用
在Python脚本中使用from opencode import Agent; agent = Agent(model='longcat-2.5'),后续调用agent.chat()时传入含images=[b64_string]的字典即可。
注意:图片需先转为base64字符串,且单次请求总token不能超过1M上限,超长上下文建议分段提交。
运行长程智能体任务
第一步:创建任务描述文件task.md,内容需包含明确目标、约束条件和验收标准,例如:“基于用户提供的Figma设计稿截图,生成可运行的Next.js页面,要求适配移动端,CSS使用Tailwind,禁止使用内联样式”。
第二步:执行opencode agent --task task.md --tools browser,terminal,code_editor,自动调用对应工具链完成端到端开发。
第三步:观察日志输出中的[TOOL_CALL]标记,确认LongCat-2.5是否触发了浏览器检索或终端执行动作——若始终只输出文本响应,说明--tools参数未被正确识别,需检查config.yaml中是否遗漏tools:配置项。
这一步操作起来很简单,直接把文件拖进去就行。


















