需按五步启用Claude多模态功能：一、确认版本≥1.0.43、Node.js≥18.0.0且Ollama已拉取llava:latest等模型；二、在config.json中配置Llava提供商及multimodal路由；三、Web界面设置中启用多模态输入并选multimodal策略；四、设置CLAUDE_MULTIMODAL_ENABLED=true等环境变量；五、通过拖图测试或curl验证multipart请求与响应字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装Claude客户端或集成环境，但无法使用图像上传、文档解析等多模态功能，则可能是由于多模态支持未在运行时启用或配置缺失。以下是开启Claude多模态能力的具体步骤：
一、确认Claude版本与运行环境兼容性
Claude多模态能力（如图像理解、PDF内容提取）仅在特定版本中可用，需确保当前运行的是支持多模态的Claude模型实例，且底层运行时环境满足最低要求。不满足条件将导致API调用静默忽略文件输入或返回格式错误。
1、在终端执行 ccr --version 命令，确认输出版本号不低于 1.0.43；
2、检查Node.js版本是否为 18.0.0+，运行 node --version 验证；
3、若使用本地Ollama后端，需确认已拉取含多模态支持的模型，例如执行 ollama run llava:latest 或 ollama run moe-llava:12b；
二、配置多模态提供商到Claude Code Router
Claude Code Router本身不原生处理图像，需通过配置支持视觉理解的第三方提供商（如Llava、MoE-LLaVA、Gemini 2.5 Pro）作为多模态路由后端，并将其绑定至特定路由策略，使含附件的请求被自动分发至对应服务。
1、编辑配置文件 ~/.claude-code-router/config.json；
2、在 Providers 数组中新增Llava本地服务配置：
{"name": "llava", "api_base_url": "http://localhost:11434/v1/chat/completions", "api_key": "ollama", "models": ["llava:latest"]}；
3、在 Router 对象中添加多模态专用路由键："multimodal": "llava,llava:latest"；
4、保存文件后重启服务：执行 ccr restart；
三、启用Web界面多模态输入控件
Claude Code Router默认Web管理界面禁用文件上传区域，需手动启用前端多模态交互组件，否则用户界面不会显示图片拖拽区或文档选择按钮。
1、启动Web界面：运行 ccr start 后访问 http://localhost:3000；
2、点击右上角齿轮图标进入「界面设置」；
3、勾选 启用多模态输入（支持图片/PDF/文本文件上传）；
4、在「默认路由策略」下拉菜单中选择 multimodal；
5、刷新页面，确认底部出现带「+」号的附件上传区域；
四、通过环境变量强制激活多模态协议栈
某些集成场景（如嵌入NextChat或LobeChat）中，前端可能因安全策略屏蔽二进制载荷。此时需在系统级环境变量中显式声明多模态传输能力，使客户端识别并构造符合MIME multipart/form-data规范的请求。
1、打开系统环境变量设置界面（Windows：系统属性→高级→环境变量；macOS/Linux：编辑 ~/.zshrc 或 ~/.bash_profile）；
2、新增变量：CLAUDE_MULTIMODAL_ENABLED=true；
3、新增变量：CLAUDE_ACCEPTED_MIME_TYPES=image/jpeg,image/png,application/pdf,text/plain；
4、重启所有已运行的终端与前端应用进程；
5、在PowerShell中执行 $env:CLAUDE_MULTIMODAL_ENABLED 验证值为 true；
五、验证多模态功能是否生效
完成上述任一路径配置后，需通过结构化测试确认图像理解、文档解析等核心能力已就绪，避免配置项遗漏导致功能不可见。
1、在Web界面输入提示词：“描述这张图片的内容”，随后拖入一张JPG格式截图；
2、观察请求发出后Network面板中是否出现 multipart/form-data 类型请求头；
3、检查响应JSON中是否包含 "multimodal_input": true 字段；
4、若使用curl测试，执行命令：curl -X POST http://localhost:3000/v1/chat/completions -F "model=multimodal" -F "messages=[{\"role\":\"user\",\"content\":\"分析图表\"}]" -F "files=@chart.png"；
