Claude Code / Codex 接入 DeepSeek 新版（deepseek-flash）配置教程：Windows 写法、opus 映射和 11 月搜索收费

DeepSeek 10 月 17 日把 V4.1 Flash 更新到了 1017 版，网页、App 和 API 都换成了新模型，官方文档里的模型名也改成了 deepseek-flash。网上很多 Claude Code / Codex 接 DeepSeek 的教程还是之前写的，模型名是老的 deepseek-v4-flash，照着抄容易出问题。

另外有个要注意的：11 月 1 日起，通过 Claude Code、Codex 调用的 Search / Fetch 工具开始收费，5 元一千次。

这篇按 DeepSeek 官方最新文档整理了两边的配置，顺便把文档里自相矛盾的地方和怎么关掉搜索说清楚。

Claude Code 接 DeepSeek

先装好 Claude Code（需要 Node.js 18+，Windows 还要装 Git for Windows）：

npm install -g @anthropic-ai/claude-code
claude --version

去 DeepSeek 开放平台 建一个 API Key，然后设环境变量。

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的 DeepSeek API Key"
$env:ANTHROPIC_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

Mac / Linux

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=你的 DeepSeek API Key
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

设完在项目目录里运行 claude 就行。模型名后面的 [1m] 是开 100 万上下文的意思，CLAUDE_CODE_AUTO_COMPACT_WINDOW 配合它调大自动压缩的阈值。

不想每次都设：写进 settings.json

上面 PowerShell 的 $env: 只对当前窗口有效，关了就没了。更省事的办法是写进 Claude Code 自己的配置文件 ~/.claude/settings.json（Windows 是 C:\Users\你的用户名\.claude\settings.json），用它的 env 字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的 DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "786432"
  }
}

文件里原来有别的设置的话，把 env 这一段加进去就行，别整个覆盖。想切回 Claude 官方账号，把这段删掉即可。

文档里的矛盾：opus 到底用的是 flash 还是 pro？

DeepSeek 文档里有两处说法看起来打架：

• 环境变量示例里，ANTHROPIC_DEFAULT_OPUS_MODEL 设的是 deepseek-flash
• "模型映射"一节又说，claude-opus 开头的模型名会映射到 deepseek-v4-pro，按 Pro 的价格计费

其实两条说的是不同情况。映射只在客户端发过来的是 claude-opus-xxx 这种 Claude 原生模型名时才起作用，比如 Claude Desktop 只改了地址和 Key、没设模型名的时候。按上面那样设了环境变量，Claude Code 发给 DeepSeek 的模型名直接就是 deepseek-flash，映射根本用不上。

所以：照官方示例设了环境变量，全程都是 flash；想让复杂任务用 pro，就把 opus 那一行改成 deepseek-v4-pro，在 Claude Code 里用 /model opus 切过去。pro 更贵，按需用。

11 月 1 日前，要不要关掉搜索

DeepSeek 的接口原生支持 Claude Code 的 Web Search，模型觉得需要就会自己去搜。11 月 1 日零点（北京时间）起，Search 和 Fetch 都要按次收费，每千次 5 元，搜回来的内容还要另算总结的 token。

官方文档没写怎么关。用不上联网的话，可以用 Claude Code 自带的权限设置把这两个工具禁掉，在同一个 settings.json 里加：

"permissions": {
  "deny": ["WebSearch", "WebFetch"]
}

需要联网查资料的时候再删掉这两项。

Codex 接 DeepSeek

Codex 这边官方给了一键脚本，也可以手动改配置。

一键脚本（Windows）

先装好 Codex CLI 并运行过一次（让 ~/.codex 目录生成出来），然后在 PowerShell 里：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup.ps1 | iex

它会让你输入以 sk- 开头的 Key，然后选：1 用 deepseek-flash，2 用 deepseek-v4-pro，9 恢复默认配置。脚本会先把原来的 config.toml 备份到 ~/.codex/backup-deepseek/，写入前也会校验格式，出错就不改任何文件。

不过 irm ... | iex 是直接执行网上下载的脚本，稳妥起见可以先把链接下载下来看一眼内容再运行。

手动改 config.toml

不想跑脚本的话，编辑 ~/.codex/config.toml，官方给的写法是：

model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
web_search = "disabled"
show_raw_agent_reasoning = true
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "你的 DeepSeek API Key"

几个注意点：

• model_catalog_json 指向的 models.json 是模型信息文件，一键脚本会帮你生成；手动配的话需要自己准备，嫌麻烦就直接用脚本
• web_search = "disabled" 就是关掉联网搜索，正好躲开 11 月 1 日的收费。官方说内置联网搜索只有 deepseek-v4-pro 支持
• 图片输入只有 deepseek-flash 支持
• Key 是明文写在配置里的，别把 config.toml 发给别人或传到 GitHub

切换后，之前的会话怎么"没了"

这个很多人以为是记录丢了。其实 Codex 会把用第三方 API 的会话和用 ChatGPT 账号的会话分开放，只显示当前配置对应的那一组。切回 ChatGPT（一键脚本选 9），原来的会话就回来了，DeepSeek 的那些会被藏起来。用桌面版的话，切换后重启一下客户端。

如果 Codex 升级之后出现各种奇怪报错，可能是后台 daemon 版本没跟上，可以看我之前写的 Codex daemon 修法。

最后

参考：DeepSeek 官方文档（Claude Code、Codex、1017 更新公告）。

想接别的中转或第三方 Key，可以看 Claude Code 接第三方 Key 教程。