核心内容摘要
《火影忍者》本钢手书漫画：当青春热血遇上硬核匠心
配置文件结构~/.config/opencode/opencode.json示意{$schema:https://opencode.ai/config.json,plugin:[oh-my-opencode
3.
2],mcp:{feishu-mcp:{type:remote,url:https://mcp.feishu.cn/mcp/...}},provider:{Mify-OpenAI:{npm:ai-sdk/openai,options:{baseURL:http://model.mify.ai.srv/v1/,apiKey:sk-...},models:{azure_openai/gpt-
1-codex:{name:GPT-
1 Codex,attachment:true,reasoning:true,modalities:{input:[text,image],output:[text]},limit:{context:1000000,output:128000}}}}}}
核心能力配置配置项作用说明modalities.input声明模型支持的输入类型可选值text/audio/image/video/pdf需要手动声明否则视为不支持modalities.output声明模型输出类型同上attachment是否允许文件上传true时可在对话中附加文件常与modalities联动reasoning推理模式true时启用“思考过程”显示limit.context/limit.outputToken 限制设定最大上下文与输出长度options.*SDK 接入参数例如baseURL、apiKey、自定义headers、timeout等只有配置了modalities.input包含image的模型才能接收图片输入没有就会提示 “this model does not support image input”。
常见场景示例
1 启用图片/多模态modalities:{input:[text,image],output:[text]},attachment:true
2 开启推理reasoning:true
3 设置 Token 限制limit:{context:1000000,output:128000}
其他可配选项速览plugin: 安装的插件列表mcp: MCP如飞书远程/本地服务描述provider: 多个模型供应商配置含npm包名、默认options、模型清单workspace: 针对特定目录的覆写配置env: 全局环境变量instructions: 额外的规则/指令文件tools: 控制可用工具如禁用bash、write等tui: 终端 UI 参数滚动、diff 样式等
使用建议逐级合并Remote → Global → Custom → Project后者可覆盖前者。
谨慎暴露密钥推荐配合{file:~/.secrets/...}引用。
明确定义模态缺省值即“不支持”尤其图像、音频等必须显式声明。
模型专能化同一 provider 下可配置多个 model entry每个 entry 单独定义能力。