docs: tool use & subagent guide for DeepSeek sessions#1
Open
MitchellkellerLG wants to merge 6 commits into
Open
docs: tool use & subagent guide for DeepSeek sessions#1MitchellkellerLG wants to merge 6 commits into
MitchellkellerLG wants to merge 6 commits into
Conversation
- SUBAGENT-MAPPING.md: env var inheritance, model tier mapping, usage throttle, session launch reference, agent pinning - POWERSHELL-SETUP.md: full Windows setup with throttle-aware functions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add quick launch section with ds-pro/ds-flash/cs commands - Link to POWERSHELL-SETUP.md and SUBAGENT-MAPPING.md - Fix incorrect note: deepseek-v4-pro/flash model names DO work directly Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
deepseek-v4-pro/flash fail in interactive mode — Claude Code validates model names client-side. Use claude-opus-4-6 and claude-haiku-4-5-20251001; DeepSeek maps these server-side to v4-pro/flash respectively. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documents what works and what breaks when using Claude Code tool use through DeepSeek's Anthropic-compatible endpoint. Critical finding: thinking blocks must be round-tripped in multi-turn tool conversations or subagent spawning fails with HTTP 400. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
DeepSeek V4 doesn't natively use Claude Code's Agent tool — it handles basic tools (Read, Write, Bash, Grep) fine but won't spawn subagents. Fix: inject a system prompt via --append-system-prompt-file that teaches the model when and how to use the Agent tool. - Add config/agent-boost-prompt.md with Agent tool usage patterns - Update PowerShell launchers to auto-inject when file exists - Add setup step 3 for copying the prompt file - Update README with the actual fix (prompting, not API compat) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/TOOL-USE-GUIDE.md— comprehensive guide to tool use capabilities, limitations, and workarounds when routing Claude Code through DeepSeekKey findings documented
is_errorignored: Tool failures not signaled to model — workaround: prefix error content withERROR:disable_parallel_tool_useignored: Model decides independentlycache_controlfields ignoredTest plan
ds-prosession (Read, Write, Bash)ANTHROPIC_BASE_URLenv override)🤖 Generated with Claude Code