如何在 Claude Code 中使用 DeepSeek-V3.1

大约 2 分钟

如何在 Claude Code 中使用 DeepSeek-V3.1

Claude Code 是一个轻量级的编码助手，通常连接到 Anthropic 的 Claude 模型。得益于 DeepSeek 的 Anthropic 兼容 API，你也可以通过设置几个环境变量，在 DeepSeek V3.1 上运行 Claude Code。

本指南将带你完成安装、配置和使用流程。

1. 安装 Claude Code

Claude Code 有两种安装方式：

选项 A（curl 安装脚本）：

curl -fsSL https://claude.ai/install.sh | bash

选项 B（npm）：

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

2. 配置 DeepSeek V3.1

Claude Code 依赖 Anthropic API 变量。要将其重定向到 DeepSeek 的 Anthropic 兼容端点，请设置以下环境变量：

# 指向 DeepSeek 的 Anthropic 兼容端点
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# 你的 DeepSeek API 密钥
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"

# 使用 DeepSeek V3.1 作为主模型
export ANTHROPIC_MODEL="deepseek-chat"

# 同时使用 DeepSeek V3.1 作为小型/快速模型
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

说明：

deepseek-chat = DeepSeek V3.1（非推理模式）
deepseek-reasoner = DeepSeek V3.1 推理模式（支持详细的“思考”轨迹，但工具使用受限）

如果你想使用推理模型，将 deepseek-chat 替换为 deepseek-reasoner。

3. 一键启动脚本

为了简化使用，你可以创建一个名为 start-claude-deepseek.sh 的 shell 脚本：

#!/bin/bash
# DeepSeek V3.1 配合 Claude Code

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_DEEPSEEK_API_KEY"
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

# 启动 Claude Code
claude "$@"

赋予执行权限：

chmod +x start-claude-deepseek.sh

现在运行 Claude Code：

./start-claude-deepseek.sh

4. 使用方法

进入你的项目文件夹并运行脚本：

cd your-project
../start-claude-deepseek.sh

从此，Claude Code 的行为完全相同——只是现在由 DeepSeek V3.1 驱动。

5. 故障排除

无效令牌错误 → 检查 ANTHROPIC_AUTH_TOKEN 是否设置为你的真实 DeepSeek API 密钥。
无响应 → 确认 ANTHROPIC_BASE_URL 是否正确（https://api.deepseek.com/anthropic）。
工具/函数调用 → 在 deepseek-chat 中支持；deepseek-reasoner 可能会回退到 deepseek-chat。