在Claude Code中使用DeepSeek v3.1模型:完整指南
你可以直接在命令行对话进行代码协作与修改。:在代码修复(SWE)与复杂终端任务(Terminal-Bench)上显著提升,更适合工具调用/多步任务。:V3.1 对分词器与 chat template 有较大调整,与 V3 存在差异,迁移前请阅读新版说明。:在思维链压缩后,V3.1-Think 用更少的 tokens 达到与 R1-0528 近似的效果。:Beta 接口支持严格模式,确保函数输出满足
DeepSeek v3.1 模型介绍
DeepSeek v3.1 于 2025 年 8 月 21 日发布,是在 V3 基础上的重要升级,具有以下核心特性:
-
• 混合推理架构:同一模型支持“非思考模式”和“思考模式”,分别对应
deepseek-chat与deepseek-reasoner,便于在速度与推理深度间灵活取舍。 -
• 128K 上下文长度:更长上下文,适合代码库分析、长文档处理与多文件协作。
-
• 思考效率提升:在思维链压缩后,V3.1-Think 用更少的 tokens 达到与 R1-0528 近似的效果。
-
• 工具与智能体能力增强:在代码修复(SWE)与复杂终端任务(Terminal-Bench)上显著提升,更适合工具调用/多步任务。
-
• Function Calling(strict)支持:Beta 接口支持严格模式,确保函数输出满足 schema(详见官方文档)。
-
• Anthropic API 兼容:可直接以 Anthropic API 形式接入 Claude Code 与其生态。
参考:
-
• DeepSeek V3.1 发布说明:DeepSeek V3.1 发布 2025/08/21[1]
Claude Code 安装指南
系统要求
-
• macOS、Windows 或 Linux 系统
-
• Node.js 16+ 版本
-
• 稳定的网络连接
安装步骤
-
1. 下载 Claude Code
npm install -g @anthropic-ai/claude-code
-
• 访问 Claude Code 官网[2] 下载对应版本的安装包
-
• 或者通过 npm 安装:
在 Claude Code 中配置 DeepSeek v3.1
按照 Anthropic API 兼容规范,Claude Code 只需设置以下环境变量即可切换到 DeepSeek 模型:
设置环境变量(临时会话)
# DeepSeek 提供的 Anthropic 兼容入口
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
# 使用 DeepSeek 的 API Key(Claude Code 读取 ANTHROPIC_AUTH_TOKEN)
export ANTHROPIC_AUTH_TOKEN="${DEEPSEEK_API_KEY}"
# 默认主模型(非思考模式)
export ANTHROPIC_MODEL=deepseek-chat
# 快速小模型(同样可设为 deepseek-chat)
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
若希望在 Claude Code 中启用“思考模式”,将 ANTHROPIC_MODEL 改为:
export ANTHROPIC_MODEL=deepseek-reasoner
提示:上述方式仅对当前 shell 会话生效。若需长期生效,可将这些
export行加入~/.zshrc或~/.bashrc。
启动与验证
cd your-project
claude
启动后,Claude Code 将读取环境变量并使用 DeepSeek 模型。你可以直接在命令行对话进行代码协作与修改。若需确认模型,查看启动日志或在会话中询问当前模型配置。
更多兼容细节与字段支持矩阵,参考官方文档:Anthropic API 指南[3]。
常见问题与注意事项
-
• 模型与模式选择:
-
-
•
deepseek-chat:非思考模式,响应更短更快。 -
•
deepseek-reasoner:思考模式,适合复杂多步推理场景。
-
-
• 上下文长度:V3.1 API 默认支持 128K 上下文,适合长文档/多文件协作。
-
• 工具调用与函数:支持
tools与tool_choice(none/auto/any/tool)。Beta 接口支持 strict Function Calling 以保证输出符合 schema(以官方文档为准)。 -
• 字段兼容性要点:
-
-
•
temperature(0.0~2.0)、max_tokens、system、stream均支持。 -
•
thinking字段在兼容模式下被忽略;图片/文档/搜索结果等部分复杂 message 类型暂不支持。
-
-
• Tokenizer/模板差异:V3.1 对分词器与 chat template 有较大调整,与 V3 存在差异,迁移前请阅读新版说明。
参考:
-
• 发布说明:DeepSeek V3.1 发布 2025/08/21[4]
-
• 兼容说明:Anthropic API 指南[5]
-
AI交流社群
我创建了一个AI交流社区,发送“加群”给公众号拉你进去
引用链接
[1] DeepSeek V3.1 发布 2025/08/21:https://api-docs.deepseek.com/zh-cn/news/news250821[2]Claude Code 官网:https://claude.ai/code[3]Anthropic API 指南:https://api-docs.deepseek.com/zh-cn/guides/anthropic_api[4]DeepSeek V3.1 发布 2025/08/21:https://api-docs.deepseek.com/zh-cn/news/news250821[5]Anthropic API 指南:https://api-docs.deepseek.com/zh-cn/guides/anthropic_api[6]DeepSeek V3.1 发布 2025/08/21:https://api-docs.deepseek.com/zh-cn/news/news250821[7]Anthropic API:https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。
更多推荐
所有评论(0)