Claude Code接入DeepSeek配置教程：低成本AI编程实战

Claude Code是Anthropic推出的终端AI编程助手，默认调用官方模型，但国内用户直连并不方便。好在DeepSeek提供了兼容Anthropic协议的接口，只需设置几个环境变量，就能让Claude Code接上DeepSeek，以更低的成本获得强大的AI编程能力。

核心公式很简单：Claude Code + DeepSeek^广告 = 终端AI编程助手 + 高性价比大模型，中间的桥梁就是环境变量。

准备工作：安装与环境清理

配置之前需要完成两步准备。

确认Claude Code已安装。如果尚未安装，在终端执行官方安装脚本，完成后运行 claude --version 验证版本号。如果遇到登录校验卡住，可以找到用户目录下的 .claude.json 文件，写入 hasCompletedOnboarding: true，保存后重启终端即可跳过引导。

然后前往DeepSeek开放平台，登录后创建API Key并妥善保存。这里有一个安全提醒：API Key拥有账户操作权限，千万不要提交到代码仓库，建议通过环境变量文件统一管理。

千万别提交到代码仓库

什么是 Anthropic 兼容协议？

Claude Code 默认只与 Anthropic 官方 API 通信，通信格式由 Anthropic 自家定义。所谓「兼容 Anthropic 协议」，指的是第三方服务商（这里是 DeepSeek）在服务端实现了与 Anthropic Messages API 相同的请求/响应结构和鉴权方式，使得客户端无需任何改动就能把请求发过去。

Claude Code 读取 ANTHROPIC_BASE_URL 决定把请求发往哪个域名，读取 ANTHROPIC_AUTH_TOKEN 作为鉴权凭证。只要目标服务能正确解析这套请求格式，Claude Code 就「以为」自己在和官方对话。这正是整个方案不需要改代码、也不需要代理的根本原因——它利用的是客户端可配置 base url 这一设计，而非逆向或破解。

核心配置：7个环境变量搭起整座桥

整个配置围绕一组环境变量展开：

ANTHROPIC_BASE_URL：指向DeepSeek兼容Anthropic协议的接口地址
ANTHROPIC_AUTH_TOKEN：填入你的DeepSeek API Key
ANTHROPIC_MODEL：设置默认模型
模型映射：Opus对应复杂推理任务，Sonnet对应日常编程，Haiku对应快速轻量任务，Agent建议用较快的模型
CLAUDE_CODE_EFFORT_LEVEL：思考深度，可选Low、Medium、Max

一共7个变量，搭起从Claude Code到DeepSeek的完整通路。

把Auth Token换成你的Key

模型映射为什么要分三个档位？

Claude Code 内部会按任务类型调用不同档位的模型：Opus 用于需要长链推理的复杂任务，Sonnet 用于日常编码，Haiku 用于摘要、文件命名、命令补全等高频轻量调用。这个分层是 Claude Code 硬编码的调用策略，用户无法直接关闭。

当后端换成 DeepSeek 时，就需要把 Opus/Sonnet 映射到 DeepSeek 的强模型（V4 Pro），把 Haiku 映射到快模型（V4 Flash）。这样既保证复杂任务拿到足够强的推理能力，又避免每次轻量调用都消耗昂贵的大模型算力。映射不当的典型症状是：简单操作也走 Pro，成本飙升；或复杂任务落到 Flash，输出质量明显下降。

Windows与macOS/Linux配置实操

Windows（PowerShell）：使用 $env: 前缀设置环境变量。将Base URL设为 https://api.deepseek.com/anthropic，Auth Token换成你的Key，Model设为 deepseek-v4-pro[1m]，同时把Opus、Sonnet映射到Pro，Haiku和Agent用Flash，最后把Effort Level设为Max。需要注意 $env: 赋值只对当前会话生效——想永久生效，可以在系统属性的环境变量中添加，或写进PowerShell配置文件。

Linux和macOS：用 export 命令做同样的设置。Base URL指向DeepSeek接口，Auth Token换成Key，Model设为 deepseek-v4-pro[1m]，Opus、Sonnet映射到Pro，Haiku和Agent用Flash，思考强度设Max。这些export命令只在当前终端会话生效，要永久生效就把命令追加到 .bashrc、.zshrc 等配置文件末尾，然后执行 source 让它立即生效。

想要永久生效

环境变量的会话级与永久级区别

环境变量本质是进程启动时继承的一小块键值内存。$env:FOO="bar" 或 export FOO=bar 只在当前 Shell 进程及其子进程中有效，关闭终端即消失。因此新开一个终端窗口，Claude Code 就会重新退回到默认的 Anthropic 官方地址。

要让配置长期生效，需要把它写进 Shell 的启动脚本——macOS/Linux 是 ~/.zshrc（zsh 为 macOS 默认）或 ~/.bashrc，Windows 则是 PowerShell 的 $PROFILE 文件，或通过「系统属性 → 环境变量」写入用户级变量。写入后必须重启终端或执行 source 才会被重新加载。选择哪种方式取决于你是想在单个项目里临时实验，还是希望所有终端都默认走 DeepSeek。

验证配置是否生效

配置完成后，进入项目目录执行 claude 启动。在交互界面输入 /status，如果看到Base URL是DeepSeek、Model是DeepSeek V4 Pro、小模型是Flash，就说明配置成功，Claude Code已经在用DeepSeek推理了。

之后直接用自然语言描述需求即可，比如让它梳理项目目录结构、给用户文件新增查询方法，或者分析测试报错原因。

模型怎么选：Pro与Flash的分工

DeepSeek目前有两个主力模型。DeepSeek V4 Pro[1m] 是最强推理版本，适合复杂架构设计、深度代码审查和疑难调试；DeepSeek V4 Flash 主打快速推理，适合批量文件生成、简单增删改查和文档编写。两者都支持1M上下文窗口。

选择逻辑一目了然：重活用Pro，轻活用Flash。复杂架构设计、深度代码重构、日常功能开发和代码补全用Pro；快速问答、简单修改和子任务用Flash，响应更快、成本更低。

DeepSeek V4 Flash快速推理

小结

本期核心思路是用环境变量桥接：Base URL指向DeepSeek兼容接口，Auth Token填Key，Model选模型。Windows用PowerShell的 $env:，Linux和macOS用export；想永久生效就写进Shell配置文件。配置完用 /status 验证。记住模型选择——重活用Pro，轻活用Flash。下一期将开始第一次上手使用，看看Claude Code在真实项目里怎么干活。