# deepseek-claude-code-worker-mcp

deepseek-claude-code-worker-mcp hands file reading, editing and checks to a DeepSeek V4 worker that runs as background jobs, so Codex keeps its context for planning and review.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 125 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/deepseek-claude-code-worker-mcp/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/deepseek-claude-code-worker-mcp

## What it does

The skill runs a worker MCP server for Codex: file reading, editing and checks go to DeepSeek V4 while Claude keeps planning and review. Each task runs as a background job, which holds down token use on the main thread. The author estimates a 40-60% saving on tasks that fit the pattern.

It is not a DeepSeek client of its own. A `claude-deepseek` launcher points the local Claude CLI at the Anthropic-compatible endpoint DeepSeek provides. `deepseek_start_implementation` kicks off a job and returns a `job_id` right away; `deepseek_get_job`, `deepseek_tail_job` and `deepseek_wait_for_job` report progress, `deepseek_cancel_job` stops a run, and `deepseek_implement_in_workspace` blocks until a small edit is done.

Scope is set up front with `allowed_dirs`, `forbidden_paths` and `validation_commands`. The job report then shows anything that landed outside the allowed area and which checks failed. The `use_case` field picks the model: flash for patches and tests, `deepseek-v4-pro[1m]` for debugging and architecture work. Node.js 20+, the `@anthropic-ai/claude-code` CLI and a DeepSeek key in `DEEPSEEK_API_KEY` or `~/.codex/secrets/deepseek_api_key` are required. Windows is best-effort.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/deepseek-claude-code-worker-mcp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/deepseek-claude-code-worker-mcp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/deepseek-claude-code-worker-mcp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/deepseek-claude-code-worker-mcp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/deepseek-claude-code-worker-mcp
```

2. **Manually: put the files in place**
- File: `.github/skills/deepseek-claude-code-worker-mcp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/deepseek-claude-code-worker-mcp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/deepseek-claude-code-worker-mcp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/deepseek-claude-code-worker-mcp/SKILL.md

## When to use it
- push a multi-file edit into a background job while Claude stays on planning
- cut main-thread token use on code reading and checks
- fence the worker to `allowed_dirs` and keep it away from `.env`
- make passing tests and lint a condition for accepting a patch
- see which files changed and which check failed

## Example prompts
- Hand this edit to the DeepSeek worker: add error handling to the auth module, project at `/home/user/myproject`.
- What is the status of job `dsw_abc123`? Show the changed files.
- Cancel job `dsw_abc123`.

## Similar
- [skill-ollama-deepseek-ocr-tool](https://affpapa.org/en/nevibecode/skills/skill-ollama-deepseek-ocr-tool.md) — skill · 1 install
- [deepseek-ocr](https://affpapa.org/en/nevibecode/skills/deepseek-ocr.md) — skill · 1600 installs
- [deepseek-pentest-ai-burp-extension](https://affpapa.org/en/nevibecode/skills/deepseek-pentest-ai-burp-extension.md) — skill · 262 installs
- [DeepSeek MCP Server](https://affpapa.org/en/nevibecode/mcp/deepseek-mcp-server.md) — MCP server · ★ 367 repo stars
- [deepseek-minimal-anchor](https://affpapa.org/en/nevibecode/hooks/deepseek-minimal-anchor.md) — hook · ★ 1596 repo stars
- [deepseek](https://affpapa.org/en/nevibecode/mcp/deepseek.md) — MCP server · ★ 26 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
