Claude Code 接入 DeepSeek:环境变量、CC Switch 与模型选择总结
1. 当前结论
已经通过环境变量成功让 Claude Code 接入 DeepSeek API,说明核心链路已经跑通。
如果目前只使用 DeepSeek,并且只有一个 API Key、一个常用模型,那么 不一定需要 CC Switch 。
CC Switch 的主要价值不是提升模型能力,而是方便管理多个服务商、多个模型和多个配置 Profile。
2. 直接通过环境变量接入 DeepSeek
DeepSeek 提供 Anthropic API 兼容接口,因此 Claude Code 可以通过 Anthropic 相关环境变量接入。
基础配置
bash
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_API_KEY="的_deepseek_api_key"
export ANTHROPIC_MODEL="deepseek-v4-flash"
claude
如果想使用 Pro 模型:
bash
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_API_KEY="的_deepseek_api_key"
export ANTHROPIC_MODEL="deepseek-v4-pro"
claude
3. 推荐做一个启动脚本
相比每次手动 export,更推荐创建一个专门的启动脚本。
创建脚本
bash
mkdir -p ~/.local/bin
nano ~/.local/bin/claude-deepseek
写入:
bash
#!/usr/bin/env bash
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_API_KEY="的_deepseek_api_key"
export ANTHROPIC_MODEL="deepseek-v4-flash"
exec claude "$@"
保存后赋予执行权限:
bash
chmod +x ~/.local/bin/claude-deepseek
确认 ~/.local/bin 在 PATH 中:
bash
echo $PATH
如果没有,则加入 .bashrc:
bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
之后直接运行:
bash
claude-deepseek
4. 为什么社区会用 CC Switch?
CC Switch 的核心作用是 配置管理,适合多服务商、多模型、多项目切换。
4.1 多 API 服务商快速切换
很多人可能同时使用:
- Anthropic 官方
- DeepSeek
- OpenRouter
- Kimi / Moonshot
- GLM
- 硅基流动
- 本地 LiteLLM
- 本地 OpenAI 兼容代理
如果全部靠手写环境变量,配置会越来越混乱。
4.2 避免频繁修改 .bashrc
不用 CC Switch 时,可能需要频繁修改:
bash
~/.bashrc
~/.zshrc
切换服务商时需要反复改:
bash
export ANTHROPIC_BASE_URL=...
export ANTHROPIC_API_KEY=...
export ANTHROPIC_MODEL=...
CC Switch 可以通过 UI 或命令切换 Profile,避免手动维护多套 export。
4.3 不同项目使用不同模型
例如:
| 项目类型 | 推荐后端 |
|---|---|
| 普通前端项目 | DeepSeek Flash |
| 复杂架构设计 | DeepSeek Pro / Anthropic Sonnet |
| 低成本脚本任务 | DeepSeek Flash |
| 本地实验 | LiteLLM / Ollama 代理 |
不用 CC Switch 也能做到,但需要自己维护多个启动脚本。
4.4 管理多个模型档位
Claude Code 可能会涉及主模型、小模型、快速模型、子 Agent 模型等配置。
常见变量可能包括:
bash
ANTHROPIC_MODEL
ANTHROPIC_SMALL_FAST_MODEL
CLAUDE_CODE_SUBAGENT_MODEL
CC Switch 可以把这些变量作为一组 Profile 管理,减少配置错误。
5. 是否需要 CC Switch?
| 场景 | 是否推荐 CC Switch |
|---|---|
| 只用 DeepSeek | 不需要 |
| 只在一台 WSL 上使用 | 不需要 |
| 只用一个 API Key | 不需要 |
| 想简单透明可控 | 不需要,启动脚本更好 |
| 经常切换 DeepSeek / Anthropic / OpenRouter | 推荐 |
| 多项目使用不同模型 | 推荐 |
| 不想记一堆环境变量 | 推荐 |
| 想用 UI 管理模型配置 | 推荐 |
当前建议
现在已经通过环境变量跑通 DeepSeek,短期内建议:
先不用 CC Switch,直接使用启动脚本。
等后续确实需要同时管理多个 API 服务商或多个模型,再考虑引入 CC Switch。
6. DeepSeek Flash 和 Pro 的区别
总体判断
deepseek-v4-flash:更快、更便宜,适合日常编码和轻量 Agent 任务。deepseek-v4-pro:能力更强,更适合复杂推理、长链任务、多文件重构和疑难 Bug。
7. Flash 与 Pro 对比
| 对比项 | deepseek-v4-flash | deepseek-v4-pro |
|---|---|---|
| 定位 | 高性价比、快速响应 | 更强推理、更强 Agent 编码 |
| 成本 | 更低 | 更高 |
| 速度 | 更快 | 相对较慢 |
| 普通代码任务 | 足够 | 更稳,但不一定必要 |
| 多文件理解 | 可用 | 更推荐 |
| 复杂重构 | 可能吃力 | 更适合 |
| 疑难 Bug | 可能绕圈 | 更稳 |
| 日常 Claude Code 使用 | 推荐默认使用 | 复杂任务时切换 |
8. Claude Code 使用场景建议
默认使用 Flash
适合:
- 解释代码
- 修改小 Bug
- 生成脚本
- 写配置文件
- 写 README
- 写 AGENTS.md
- 整理 prompt
- 修改前端页面
- 处理常规 TypeScript / Python / Shell 问题
推荐默认配置:
bash
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_API_KEY="的_deepseek_api_key"
export ANTHROPIC_MODEL="deepseek-v4-flash"
claude
复杂任务切 Pro
适合:
- 跨多文件重构
- 通读项目并改架构
- 排查复杂 Bug
- 长上下文任务
- 多步骤 Agent 任务
- 后端、前端、数据库联动修改
- 复杂 TypeScript 类型推导问题
- 需要更强稳定性的代码生成任务
临时切换:
bash
export ANTHROPIC_MODEL="deepseek-v4-pro"
claude
9. 推荐使用策略
最实用的策略是:
text
默认:deepseek-v4-flash
卡住:切 deepseek-v4-pro
大重构:直接 deepseek-v4-pro
便宜试错:deepseek-v4-flash
也就是:
Flash 当主力,Pro 当疑难杂症和重活模式。
10. 最终建议
对于当前环境:
- WSL2 Ubuntu 已就绪
- Node.js 已安装
- uv 已安装
- Claude Code 已能通过环境变量接入 DeepSeek
建议采用:
- 默认使用环境变量或启动脚本接入 DeepSeek。
- 默认模型使用
deepseek-v4-flash。 - 遇到复杂任务时临时切换到
deepseek-v4-pro。 - 暂时不引入 CC Switch。
- 等后续需要多服务商切换时,再使用 CC Switch。
一句话总结:
现在的最佳方案是:不用 CC Switch,先用启动脚本 + DeepSeek Flash;复杂任务再切 Pro。