Claude Code 桌面版接入 DeepSeek/第三方模型后能力缺失、不能联网、频繁弹窗的修复 Skill

Claude Code Desktop 3P / DeepSeek / Anthropic-compatible API parity repair skill.

这是一个给 Claude Code / Claude Desktop Mac App 第三方模型模式用的修复 skill。目标是解决接入 DeepSeek、OpenAI-compatible / Anthropic-compatible gateway、LLM gateway 或其他第三方模型后，Claude Code 出现的常见问题：

• 能力像被封印：MCP、浏览器、搜索、Chrome/CDP、插件、skills、subagent 不完整
• bypassPermissions 开了还是频繁弹 Allow / permission prompt
• WebFetch / 联网 / npm / GitHub / Hugging Face 下载不稳定
• Claude Desktop 3P/Cowork 模式和 Claude Code CLI/runtime 配置不一致
• DeepSeek V4 Pro/Flash 模型映射、1M context、subagent model、effort 配置不完整
• 桌面版内置 Claude Code runtime 被固定在旧版本，CLI 更新了但 Desktop 3P 没跟上

这个项目的核心不是“破解 Claude”，而是把第三方模型模式下容易漏掉的本地配置补齐，并且先体检、再计划、再应用。

适用场景

适合你搜索这些问题时使用：

• Claude Code Desktop 接入 DeepSeek 后能力缺失
• Claude Desktop Developer Mode 第三方 API 以后不能联网
• Claude Code 3P DeepSeek bypassPermissions 不生效
• Claude Code Mac App 第三方模型频繁弹窗
• Claude Code DeepSeek MCP / Chrome DevTools / Playwright 不见了
• Claude Code Anthropic-compatible API model discovery 失败
• Claude Desktop 3P runtime 版本太旧

它会做什么

默认 dry-run 只检查，不修改：

• 读取 ~/.claude/settings.json
• 读取 ~/.claude.json
• 读取 ~/Library/Application Support/Claude-3p/ 下的 Desktop 3P 配置
• 读取 MCP 配置状态
• 检查 Claude Code runtime / Desktop 3P runtime 版本
• 检查常见 token/private-key 形态，只报告文件和数量，不打印值
• 静态检查本机 proxy、npm registry、git proxy

用户确认后才会应用：

• 补 ANTHROPIC_BASE_URL
• 补 DeepSeek V4 Pro / Flash 模型 slot、subagent model、effort、capability env
• 补 Claude Code permission allowlist 和 skipDangerousModePermissionPrompt
• 补官方 MCP permission 写法，例如 mcp__playwright__*
• 补 Playwright、Chrome DevTools/CDP、Context7、sequential-thinking、memory MCP
• 通过 claude mcp add-json --scope user 写官方 user-scope MCP，同时兼容旧版 ~/.mcp.json
• 补 Claude Desktop 3P/Cowork 的 trusted workspace、web search、MCP/extension 开关
• 可选配置代理、npm 镜像、Hugging Face mirror、NO_PROXY、自定义 CA
• 可选安装 plugin
• 可选 overlay Desktop 3P 内置 runtime

安装

克隆仓库：

git clone https://github.com/kingcharleslzy-ai/claude-code-deepseek-3p-parity-skill.git
cd claude-code-deepseek-3p-parity-skill
./install.sh

或者手动安装：

mkdir -p ~/.claude/skills
cp -R skills/claude-3p-parity ~/.claude/skills/

安装后重启 Claude Desktop / Claude Code，让 skill metadata 重新加载。

最安全的使用方式

先只检查，不修改：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py --skip-gateway-test

你也可以在 Claude 里说：

Use $claude-3p-parity 先检查我的 Claude Desktop 3P / DeepSeek 配置，不要修改。

检查报告会包含：

• inspection.current：当前配置是什么
• inspection.missing：缺什么
• inspection.planned_changes：如果 apply 会改什么
• connectivity：默认只看本地代理/npm/git 配置，不主动连外网
• secret_scan：是否发现 token/private-key 形态的值
• runtime：CLI 和 Desktop 3P runtime 版本

确认计划没问题后再应用：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py --apply --skip-gateway-test

默认会把当前目录作为 trusted workspace。要指定项目目录：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --apply \
  --workspace-dir ~/Projects/my-app \
  --skip-gateway-test

如果你明确想给 Claude Code 更大的本机访问范围：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --apply \
  --allow-home-directory \
  --skip-gateway-test

DeepSeek 默认配置

默认按 DeepSeek V4 Pro / Flash 配置：

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
ANTHROPIC_MODEL=deepseek-v4-pro[1m]
CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
CLAUDE_CODE_EFFORT_LEVEL=max

如果你用其他 Anthropic-compatible provider：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --apply \
  --gateway-base-url https://your-provider.example/anthropic \
  --pro-model your-pro-model \
  --flash-model your-fast-model \
  --pro-name "Your Pro Model" \
  --flash-name "Your Fast Model"

默认不会把 API key 写入 ~/.claude/settings.json 的 env。只有你明确要求时才写：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --apply \
  --gateway-api-key sk-... \
  --write-api-key-to-env

为什么默认不做网络连通检查

因为网络连通检查会让 Claude 启动的进程访问 npm、GitHub、Hugging Face、Claude release bucket 等外网地址。在 Claude Desktop / Claude Code 内部运行时，这可能触发：

• Claude Code permission prompt
• Claude Desktop 3P/Cowork 安全弹窗
• macOS 防火墙或代理客户端提示
• 企业代理/证书提示

所以默认只做静态检查。真正需要诊断网络时再显式开启：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --network-check \
  --skip-gateway-test

在中国大陆网络环境中，可以显式配置代理和 npm 镜像：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --apply \
  --proxy-url http://127.0.0.1:7890 \
  --no-proxy localhost,127.0.0.1,::1 \
  --set-npm-registry https://registry.npmmirror.com \
  --skip-gateway-test

--set-npm-registry 会修改用户级 npm 配置，所以脚本不会默认做。

常用命令

只检查：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py --skip-gateway-test

应用基础修复：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py --apply --skip-gateway-test

更少弹窗的激进权限模式：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --apply \
  --permission-profile aggressive \
  --skip-gateway-test

运行 Claude 自检：

python3 ~/.claude/skills/claude-3p-parity/scripts/claude_3p_parity.py \
  --run-claude-checks \
  --skip-gateway-test

注意：claude doctor / claude mcp list 可能启动 MCP server，因此默认不跑。

这个工具不能解决什么

• 不能让第三方模型拥有第一方 Claude 模型的所有产品能力
• 不能绕过 macOS Accessibility、Screen Recording、Automation、文件隐私等系统级弹窗
• 不能修复 provider 本身不支持 tool call、image、cache、/v1/models 等能力缺口
• 不能保证 Claude Desktop 未来更新不会覆盖 Desktop 3P runtime overlay
• 不能让 SOCKS 代理直接生效；Claude Code 主要走 HTTP/HTTPS proxy env，需要本地 HTTP proxy adapter

安全说明

• 默认 dry-run 不写文件
• 写文件前会备份已有 JSON
• 报告会 redacts API key、token、proxy credential
• 默认不会安装 plugin
• 默认不会修改 npm registry/proxy
• 默认不会把 API key 写进 env
• 默认不会 live probe 外网
• 默认不会把整个 home 目录加入 trusted workspace，除非传 --allow-home-directory

项目结构

skills/claude-3p-parity/
├── SKILL.md
├── agents/openai.yaml
├── references/limits.md
└── scripts/claude_3p_parity.py

关键词

Claude Code Desktop, Claude Desktop 3P, DeepSeek V4 Pro, DeepSeek V4 Flash, third-party model, Anthropic-compatible API, LLM gateway, MCP, Chrome DevTools MCP, Playwright MCP, Claude Code permissions, bypassPermissions, permission prompt, no internet, WebFetch, Claude Code Mac App, Developer Mode.