deepseek-claude-code-worker-mcp — Claude Code skill: what it does
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.
no license 125 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a claude-codeWhat deepseek-claude-code-worker-mcp 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.
What it helps with
- 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_dirsand 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 for the agent
- 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.
How to install deepseek-claude-code-worker-mcp
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/deepseek-claude-code-worker-mcp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deepseek-claude-code-worker-mcp/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a codex2Manually: put the files in place
.agents/skills/deepseek-claude-code-worker-mcp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a cursor2Manually: put the files in place
.cursor/skills/deepseek-claude-code-worker-mcp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/deepseek-claude-code-worker-mcp2Manually: put the files in place
.github/skills/deepseek-claude-code-worker-mcp/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/deepseek-claude-code-worker-mcpManually: put the files in place
.devin/skills/deepseek-claude-code-worker-mcp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about deepseek-claude-code-worker-mcp
How do I install deepseek-claude-code-worker-mcp in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill deepseek-claude-code-worker-mcp -a claude-code. The skill lands at ~/.claude/skills/deepseek-claude-code-worker-mcp/SKILL.md.
What does deepseek-claude-code-worker-mcp do?
It gives implementation work to a DeepSeek V4 worker as a background job, leaving Claude free for planning and review of the changes.
What is needed before the worker runs?
Node.js 20+, the @anthropic-ai/claude-code CLI and a DeepSeek API key. Put the key in DEEPSEEK_API_KEY or in ~/.codex/secrets/deepseek_api_key.