两个 Max 20 账号接连被封后，我用 Claude Code + DeepSeek 续命：一切丝滑，唯独不识图——这边教你一招搞定

两个 Max 20 账号接连被封后，我用 Claude Code + DeepSeek 续命：一切丝滑，唯独不识图——这边教你一招搞定

JeecgBoot AI专题研究| 给 DeepSeek 装上"眼睛"：claude-code-vision-skill 视觉外挂配置实战

从封号说起：被逼出来的 Claude Code + DeepSeek 组合

先交代背景：最近一周，我的两个 Claude Max 20 账号（200 美元/月的顶配订阅）先后被 Anthropic 封禁，没有警告、没有申诉余地，剩余订阅周期直接作废。这波封号潮波及面之广，圈内不少大佬都中了招，这里不再展开。

账号没了，活还得干。我把 Claude Code 的后端切到了DeepSeek 的 Anthropic 兼容端点，主力模型用deepseek-v4-pro[1m]（100 万 token 超长上下文版本），快速任务走deepseek-v4-flash。跑了几天下来的真实体感是：一切都很丝滑。写代码、改 Bug、跑自动化脚本、大仓库长上下文，撑得住日常开发强度，成本还便宜了一大截。

给同样想切换的朋友贴一下我的~/.claude/settings.json关键配置：

{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-你的DeepSeek密钥","API_TIMEOUT_MS":"3000000","ANTHROPIC_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_SMALL_FAST_MODEL":"deepseek-v4-flash","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-v4-flash","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-v4-pro[1m]","CLAUDE_CODE_EFFORT_LEVEL":"max"},"model":"deepseek-v4-pro"}

几个要点：deepseek-v4-pro[1m]后缀[1m]表示启用 100 万 token 上下文；把 Sonnet/Opus/Haiku 三个档位全部映射到 DeepSeek 对应模型，Claude Code 内部无论调哪一档都不会打到 Anthropic；API_TIMEOUT_MS拉长避免长任务超时。

但有一个硬伤很快就暴露了——它不识别图片。

痛点：截图贴进去，模型根本"看不见"

DeepSeek 的模型（V4 系列，包括更早的 V3、R1）纯文本能力很强，但至今不支持多模态。而 Claude Code 官方只对 Anthropic 自家的 Claude 模型做了图片支持。两边一凑，就出现了一个很尴尬的局面：

在 Claude Code 里粘贴截图 → 模型收不到图片内容 → 白贴。

对日常开发来说这个缺口不小：报错截图、UI 布局图、架构图、Excel 表格截屏……很多时候一张图比三百字描述高效得多。以前用 Claude 随手一贴就行，换了 DeepSeek 之后，等于把"眼睛"给蒙上了。

好在这个问题有一个近乎零门槛的解法：claude-code-vision-skill。它相当于给 Claude Code 装了一个视觉"外挂"——检测到图片时，自动调用第三方视觉模型（通义千问 / 豆包 / GPT-4o）识图，把识别结果转成文字喂给 DeepSeek。

原理：视觉模型当"眼睛"，DeepSeek 当"大脑"

整条链路非常直白：

你发截图 → Claude Code → vision skill 拦截图片 ↓ Qwen / Doubao / GPT-4o 视觉模型识图 ↓ 返回文字描述 → DeepSeek 文本模型处理

整个过程对使用者完全透明：发图、等几秒、模型就"看到"了图片内容，接着正常对话。本质上是一次职责拆分——视觉模型只负责"看"，DeepSeek 负责"想"，两者通过文字描述衔接。

准备工作：只需要三样东西
你需要说明
Claude Code已配置 DeepSeek 端点
Python 3运行 vision 脚本
视觉模型 API Key三选一（推荐千问，最便宜）

三家视觉模型的获取渠道和费用对比：

提供商模型获取地址费用
通义千问qwen-vl-maxbailian.console.aliyun.com百万 token 约几块钱
豆包doubao-seed-2-0-proconsole.volcengine.com有免费额度
OpenAIgpt-4oplatform.openai.com较贵

选型建议一句话：日常用千问就够了——中文识别准、价格便宜，UI 截图、表格、文档扫描都拿手。豆包胜在速度快且有免费额度，GPT-4o 综合能力最强但贵，留给复杂场景。

懒人版：一句话让 Claude Code 自己配好

最省事的方式，是直接把配置任务丢给 Claude Code 自己干。打开 Claude Code，粘贴这句话：

帮我配置 claude-code-vision-skill，让 DeepSeek 支持看图。 视觉提供商用通义千问，API Key 是 sk-你的key，设为默认。

把sk-你的key换成你的 DashScope API Key（去 阿里云百炼控制台 免费开通即可拿到）。想用豆包或 GPT-4o，把"通义千问"换成对应名字就行。

它会自动完成克隆仓库、安装脚本、写入配置的全部动作。搞定后重启 Claude Code，发张截图试试——模型就能"看见"了。

用 AI 编程工具给 AI 编程工具装外挂，这大概是 2026 年最顺理成章的操作。

手动版：五步配置，全程十分钟

如果你想搞清楚每一步都发生了什么，或者一句话配置中途出了岔子，手动流程也很简单。

第一步：克隆仓库

gitclone https://github.com/xiincs/claude-code-vision-skill.git ~/claude-code-vision-skill

第二步：获取 API Key

以通义千问为例，到 阿里云百炼控制台 开通 DashScope 服务，拿到sk-开头的 Key。

第三步：一键安装

cd~/claude-code-vision-skill python install.py\--api-key qwen:sk-你的key\--default-provider qwen\--merge-claude

安装脚本会做三件事：

  • 把vision.py拷贝到~/.claude/skills/vision/
  • 把 API Key 写入~/.claude/settings.json
  • 把视觉能力指令合并进~/.claude/CLAUDE.md

第四步：安装 Python 依赖

pipinstallopenai

如果环境里 pydantic 版本有冲突，强制重装一次即可：

pipinstall--force-reinstall pydantic pydantic-core

第五步：重启 Claude Code

关掉重开，确认可用 skill 列表里能看到vision，配置就完成了。

验证：贴图即测，也可以命令行手动跑

最直接的验证方式：在 Claude Code 里粘贴一张截图，模型会自动调用 vision skill 识别。

也可以在命令行手动测试脚本本身是否工作：

python ~/.claude/skills/vision/vision.py"screenshot.png""描述这张图的内容"

临时切换提供商用--provider参数：

# 用千问分析 UI 布局python vision.py--providerqwen"ui.png""分析布局问题"# 用豆包快速解读图表python vision.py--providerdoubao"chart.png""解读图表数据"# 用 OpenAI 处理复杂图片python vision.py--provideropenai"photo.jpg""描述图片细节"
进阶：多提供商共存与环境变量

手里有多家的 Key，安装时可以一次全配进去，随用随切：

python install.py\--api-key qwen:sk-千问的key\--api-key doubao:豆包的key\--api-key openai:sk-OpenAI的key\--default-provider qwen\--merge-claude

日常切换有两条路：VISION_PROVIDER环境变量改默认提供商，--provider参数临时指定单次调用。

完整的环境变量清单：

变量说明示例
DASHSCOPE_API_KEY千问 API Keysk-xxx
DOUBAO_API_KEY豆包 API Keyxxx
OPENAI_API_KEYOpenAI API Keysk-xxx
VISION_PROVIDER默认提供商qwen
VISION_MODEL覆盖默认模型qwen-vl-plus
VISION_MAX_TOKENS最大输出 token4096
常见问题

Q：安装后发图没反应？

先检查pip install openai是否成功，再跑一下python ~/.claude/skills/vision/vision.py --help确认脚本能正常运行。两步都通了还不行，重启一次 Claude Code。

Q：千问和豆包到底选哪个？

  • 千问 vl-max：中文识别最准，适合 UI / 表格 / 文档截图
  • 豆包 2.0-pro：速度最快，适合快速扫图
  • GPT-4o：综合最强，适合复杂场景分析

没有特殊需求就用千问，便宜且对中文最友好。

Q：识别一张图要多久？

通常 2-5 秒，取决于图片大小和模型负载。相比原生多模态确实多了一跳，但日常使用完全无感。

Q：支持哪些图片格式？

PNG、JPG、WebP、GIF 都支持。

写在最后

被封号这事固然糟心，但换个角度看，它也逼着我把工具链重新审视了一遍：Claude Code 作为终端 Agent 的交互体验 + DeepSeek 的模型能力 + 千问的视觉识别，三者拼起来的组合拳，成本只有 Max 20 订阅的零头，能力上却没缺什么关键项。

AI 工具链的时代，单一供应商锁定的风险越来越真实。与其把鸡蛋放在一个篮子里，不如学会拼积木——哪块缺了，补哪块。

仓库地址: github.com/xiincs/claude-code-vision-skill