> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Claude Code / Codex 接入 DeepSeek 新版（deepseek-flash）配置教程：Windows 写法、opus 映射和 11 月搜索收费
- URL: https://tbbbk.com/claude-code-codex-deepseek-flash-setup/
- Published: 2026-10-25T13:37:34.000Z
- Updated: 2026-10-25T13:37:34.000Z
- Description: 按 DeepSeek 官方最新文档整理的 Claude Code、Codex 接入配置，含 Windows 写法、opus 映射矛盾和 11 月搜索收费前的关闭方法。
- Author: TuBaiBai
- Tags: AI 编程工具, Claude Code, DeepSeek

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 开放平台](https://platform.deepseek.com/api%5Fkeys) 建一个 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 修法](https://tbbbk.com/codex-windows-daemon-fix/)。

## 最后

参考：DeepSeek 官方文档（[Claude Code](https://api-docs.deepseek.com/zh-cn/quick%5Fstart/agent%5Fintegrations/claude%5Fcode)、[Codex](https://api-docs.deepseek.com/zh-cn/quick%5Fstart/agent%5Fintegrations/codex)、[1017 更新公告](https://api-docs.deepseek.com/zh-cn/news/news261017)）。

想接别的中转或第三方 Key，可以看 [Claude Code 接第三方 Key 教程](https://tbbbk.com/claude-code-third-party-api-key-relay-guide-2026/)。