# Claude Code Deepseek 3p Parity Skill

> 修复 Claude Code Desktop 接入 DeepSeek/第三方模型后能力缺失、联网失败、频繁权限弹窗的 Claude Skill

- **Type:** MCP server
- **Install:** `agentstack add mcp-kingcharleslzy-ai-claude-code-deepseek-3p-parity-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kingcharleslzy-ai](https://agentstack.voostack.com/s/kingcharleslzy-ai)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kingcharleslzy-ai](https://github.com/kingcharleslzy-ai)
- **Source:** https://github.com/kingcharleslzy-ai/claude-code-deepseek-3p-parity-skill

## Install

```sh
agentstack add mcp-kingcharleslzy-ai-claude-code-deepseek-3p-parity-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## 安装

克隆仓库：

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

或者手动安装：

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

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

## 最安全的使用方式

先只检查，不修改：

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

你也可以在 Claude 里说：

```text
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 版本

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

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

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

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

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

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

## DeepSeek 默认配置

默认按 DeepSeek V4 Pro / Flash 配置：

```text
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：

```bash
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。只有你明确要求时才写：

```bash
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 防火墙或代理客户端提示
- 企业代理/证书提示

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

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

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

```bash
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 配置，所以脚本不会默认做。

## 常用命令

只检查：

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

应用基础修复：

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

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

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

运行 Claude 自检：

```bash
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`

## 项目结构

```text
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.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kingcharleslzy-ai](https://github.com/kingcharleslzy-ai)
- **Source:** [kingcharleslzy-ai/claude-code-deepseek-3p-parity-skill](https://github.com/kingcharleslzy-ai/claude-code-deepseek-3p-parity-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kingcharleslzy-ai-claude-code-deepseek-3p-parity-skill
- Seller: https://agentstack.voostack.com/s/kingcharleslzy-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
