如何在 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. 疑難排解

• 無效的 token 錯誤 → 請確認 ANTHROPIC_AUTH_TOKEN 已設定為你的有效 DeepSeek API 金鑰。
• 無回應 → 請確認 ANTHROPIC_BASE_URL 是否正確（https://api.deepseek.com/anthropic）。
• 工具/函式呼叫 → 在 deepseek-chat 支援；deepseek-reasoner 可能會回退到 deepseek-chat。

---

✅ 你現在已準備好使用 Claude Code 搭配 DeepSeek V3.1 作為你的 AI 程式碼助理。