EP 24 5 min with Stella & Liam

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

  1. 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.
  2. 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.
  3. Copy the docs' environment block exactly, including the Opus, Sonnet and Haiku slot mappings and the subagent model.
  4. 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.
  5. 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

Liam

Hey hey hey, welcome to Agentic Pod! I'm Liam.

Stella

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?

Liam

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.

Stella

Gotchas. Okay. I love a gotcha.

Liam

Uh, you will. Let's go.

What DeepSeek actually changed

Stella

So what's new? I thought DeepSeek already had a Flash model.

Liam

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.

Stella

And they bill at Flash price. Right?

Liam

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.

Stella

Wait, any tool? Not just Claude Code?

Liam

The docs list Claude Code, Codex, OpenCode, OpenClaw, Hermes, Reasonix, CodeBuddy and Qoder. And there's something called DeepSeek Harness, in developer preview.

Stella

Okay, so Claude Code is just one door. Show me how to walk through it.

The setup, step by step

Liam

Step one, you need Node eighteen or newer. Then install Claude Code with npm, and check the install by asking it for its version.

Stella

Step two is the API key?

Liam

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.

Stella

And my key goes where?

Liam

In the auth token setting. Then the model setting is deepseek-flash.

Stella

That's it?

Liam

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.

Stella

You say that like it's a cake recipe.

Liam

It kind of is. Skip one ingredient and the cake changes.

Stella

Step three?

Liam

cd into your project, and type claude. That's the whole thing.

Stella

Give me a first prompt I can try.

Liam

Try this. "Read this repo and list the three riskiest functions, with one test idea each. Don't change any files."

Stella

Read-only, so my repo's safe. Smart.

Liam

Yeah. And once that works, you hit the part that surprised me.

Gotchas and limits

Stella

Which is?

Liam

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.

Stella

So an Opus slot can cost more than I expect.

Liam

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.

Stella

Okay, what else is lurking?

Liam

Some fields are ignored. Prompt caching hints, MCP servers passed in the request, and a few content types like documents are not supported.

Stella

Hold on. MCP servers are ignored?

Liam

In the API request, yes. Check how your own MCP setup behaves before you trust it with real work.

Stella

Anything on web search?

Liam

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.

Stella

So, watch the meter. And prices?

Liam

The pricing page is your source, not me. Numbers have been moving, so check it the day you start.

Stella

Okay. But is it actually good?

Who it's for, and the verdict

Liam

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.

Stella

So run your own test.

Liam

Exactly. Take one real task, like a bug you fixed last week, and give it to both. Compare the diff and the bill.

Stella

Who should bother?

Liam

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.

Stella

And who shouldn't?

Liam

If your project depends on MCP servers or document inputs, test those first.

Stella

Okay, honest verdict. And no hedging this time.

Liam

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!