Can You Run Claude Code on DeepSeek's Flash Model?
DeepSeek's API docs now list Claude Code as a supported agent, and the model behind the name deepseek-flash is DeepSeek-V4.1-Flash-1017.
AI Stella and Liam are AI hosts with AI-generated voices. About our AI hosts
Key takeaways
- DeepSeek's docs now list Claude Code as a supported agent; the model name to use is deepseek-flash, served by DeepSeek-V4.1-Flash-1017.
- Setup is Node 18 or newer, an npm install of Claude Code, a DeepSeek API key and a few environment variables, then run claude in your project.
- Copy the docs' environment block exactly, including the Opus, Sonnet and Haiku slot mappings and the subagent model.
- Gotcha: a model name starting with claude-opus maps to deepseek-v4-pro and bills at the Pro price; names not starting with claude return a 400 error.
- Prompt caching hints, MCP servers passed in the request and some content types are ignored. Check the pricing page and test one real task before you switch.
Show notes
DeepSeek’s API docs now list Claude Code as a supported agent, and the model behind the name deepseek-flash is DeepSeek-V4.1-Flash-1017. In this episode of Agentic Pod, Liam and Stella cover what changed, the exact setup for Claude Code step by step, a safe first prompt, the gotchas (model name mapping, ignored fields, web search billing) and an honest verdict on who should try it.
What we cover:
- What changed: deepseek-flash now served by V4.1-Flash-1017
- Which agents DeepSeek lists: Claude Code, Codex, OpenCode, OpenClaw, Hermes and more
- The setup: install, DeepSeek API key, environment variables, run claude
- A read-only first prompt to test it safely
- Gotchas: opus names map to deepseek-v4-pro, ignored fields, search billing
- Who it is for and how to test it on your own work
Chapters
Questions answered in this episode
Can Claude Code run on a DeepSeek model?
Yes. DeepSeek's docs list Claude Code as supported and publish the settings: point the base URL at DeepSeek's Anthropic-style endpoint, add your key and set the model to deepseek-flash.
Which other tools work with DeepSeek's endpoint?
The docs list Claude Code, Codex, OpenCode, OpenClaw, Hermes, Reasonix, CodeBuddy and Qoder, and mention DeepSeek Harness in developer preview.
What are the gotchas?
Opus-named slots map to deepseek-v4-pro at Pro pricing, non-claude model names get a 400 error, and caching hints, request-level MCP servers and some content types are ignored.
Is it worth switching?
The hosts say it is worth an afternoon: three settings, easy to undo. Give one real task to both setups and compare the diff and the bill.
Links & resources
Full transcript
Intro
Hey hey hey, welcome to Agentic Pod! I'm Liam.
And I'm Stella! Liam, DeepSeek's docs now list Claude Code as a supported agent. Like, Claude Code, running on a DeepSeek model? That's real?
It's real, and it takes about three settings. DeepSeek's docs call the model deepseek-flash, and they publish the exact setup. Today: what changed, the steps, and the gotchas nobody mentions.
Gotchas. Okay. I love a gotcha.
Uh, you will. Let's go.
What DeepSeek actually changed
So what's new? I thought DeepSeek already had a Flash model.
It did. The new part is the name. The docs now say deepseek-flash is served by DeepSeek-V4.1-Flash-1017. The old names, deepseek-v4-flash and the vision one, still work, but they route to the new model.
And they bill at Flash price. Right?
Right. You also get deepseek-v4-pro, the bigger one. And DeepSeek says its Anthropic-style endpoint works with any tool that speaks that format.
Wait, any tool? Not just Claude Code?
The docs list Claude Code, Codex, OpenCode, OpenClaw, Hermes, Reasonix, CodeBuddy and Qoder. And there's something called DeepSeek Harness, in developer preview.
Okay, so Claude Code is just one door. Show me how to walk through it.
The setup, step by step
Step one, you need Node eighteen or newer. Then install Claude Code with npm, and check the install by asking it for its version.
Step two is the API key?
Yep. Make a key on the DeepSeek platform. Then you set a few environment variables. The first is the base URL. It points Claude Code at DeepSeek's Anthropic-style endpoint, instead of the normal Anthropic address.
And my key goes where?
In the auth token setting. Then the model setting is deepseek-flash.
That's it?
The docs also set the Opus, Sonnet and Haiku slots to deepseek-flash, the subagent model, and a bigger auto compact window. I'd copy that block exactly, uh, every last character.
You say that like it's a cake recipe.
It kind of is. Skip one ingredient and the cake changes.
Step three?
cd into your project, and type claude. That's the whole thing.
Give me a first prompt I can try.
Try this. "Read this repo and list the three riskiest functions, with one test idea each. Don't change any files."
Read-only, so my repo's safe. Smart.
Yeah. And once that works, you hit the part that surprised me.
Gotchas and limits
Which is?
The name mapping. If a tool asks for a model starting with claude-opus, DeepSeek quietly maps it to deepseek-v4-pro, and bills you at the Pro price.
So an Opus slot can cost more than I expect.
Yep. Haiku and Sonnet names map to Flash. And any model name that doesn't start with claude gets a four hundred error on that endpoint.
Okay, what else is lurking?
Some fields are ignored. Prompt caching hints, MCP servers passed in the request, and a few content types like documents are not supported.
Hold on. MCP servers are ignored?
In the API request, yes. Check how your own MCP setup behaves before you trust it with real work.
Anything on web search?
If the model decides to search, Claude Code calls it through DeepSeek's API. That adds token cost for summaries, plus the new Search API billing.
So, watch the meter. And prices?
The pricing page is your source, not me. Numbers have been moving, so check it the day you start.
Okay. But is it actually good?
Who it's for, and the verdict
I can't promise it matches the model you use today. DeepSeek's own claim is that V4.1 Flash beats its old Pro model, and that's their testing, not mine.
So run your own test.
Exactly. Take one real task, like a bug you fixed last week, and give it to both. Compare the diff and the bill.
Who should bother?
Anyone burning a lot of tokens on routine work. Test generation, refactors, repo questions. And people who want a second option when one provider has a bad day.
And who shouldn't?
If your project depends on MCP servers or document inputs, test those first.
Okay, honest verdict. And no hedging this time.
Worth an afternoon. Three settings, easy to undo, and you learn what your own work really needs. The setup block and links are in the description. What task would you test first? Tell us in the comments. See you next time!