搭配 DeepSeek 的 Claude Code 封面

如果你想讓 Claude Code 在 WSL 或 Linux 內執行，而不依賴 Anthropic 的直接端點，目前最乾淨的做法就是把它指向 DeepSeek 的 Anthropic 相容 API。

這正是原始教學背後的核心做法，而且老實說，它解決了許多開發者一直遇到的確切問題：Claude Code 安裝沒問題，但第一次真正的工作階段會因為區域存取、端點路由或模型設定而失敗。

所以與其把這篇變成模糊的「AI 程式開發工具總覽」，不如保持實用。我們會做四件事：

• 在 WSL 或 Linux 上安裝 Claude Code

• 透過 DeepSeek 進行路由

在浪費時間除錯 CLI 之前，先測試端點

• 修正常見且通常最先出現的錯誤

Claude Code 與 DeepSeek 設定流程

為什麼這個設定很重要

紙面上看，Claude Code 只是另一個以終端機為基礎的程式開發助理。實際上，讓它有用的是它可以讀取你的 repo、執行指令、檢查檔案，並留在真正的開發工作流程中，而不是像一個剛好懂一些程式碼的聊天框。

當連線開始出問題時，摩擦也就開始了。

對於在受限網路環境中工作的開發者來說，官方預設路徑可能會變成真正的阻礙。這就是 DeepSeek 做法吸引人的原因：你保留 Claude Code 的工作流程，但把後端路徑換成 DeepSeek 提供的 Anthropic 相容端點。

這也讓這份指南比隨機的「複製這些指令」文章更有用。看起來正確的設定和真正能運作的設定之間，差異通常取決於：

• 你設定了哪些環境變數

• 你把它們持久化在哪裡

• 你使用哪個模型名稱

• 你是否在啟動 claude 之前先測試端點

步驟 1：在 WSL 或 Linux 上安裝 Claude Code

來源文章使用基於 npm 的安裝路徑，而當你已經在 WSL 或 Linux 中準備好 Node 時，這仍然很好用。

如果你的網路不穩定，請先切換到官方 npm registry，全域安裝 Claude Code，然後再切回你平常使用的鏡像：

# 切換到官方 npm registry

npm config set registry https://registry.npmjs.org

# 全域安裝 Claude Code

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

# 切回你偏好的鏡像

npm config set registry https://registry.npmmirror.com

如果你的網路沒問題，簡短版本就夠了：

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

接著確認安裝：

claude --version

如果你取得版本號，代表 CLI 本身已正確安裝。這不代表模型端點已經準備好，但代表本機安裝步驟已完成。

關於官方安裝路徑的簡短說明

Anthropic 目前的文件也建議 macOS、Linux 和 WSL 使用原生安裝程式：

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

這是目前更「官方」的路徑，但對於已經在 WSL 內使用 Node 工具鏈的開發者來說，npm 路徑仍然完全合理，而且能清楚對應到原始文章中的工作流程。

步驟 2：準備 Claude 設定目錄

原文指出了一個非常真實的麻煩：有時你想編輯 Claude Code 的本機設定，卻立刻遇到權限阻擋。

如果 vim 或其他編輯器無法寫入 ~/.claude，請先修正擁有者與權限：

mkdir -p ~/.claude

chown -R "$USER":"$USER" ~/.claude

chmod -R 755 ~/.claude

這不華麗，但很省時間。出乎意料地多「Claude Code 設定問題」其實都是檔案權限問題。

步驟 3：將 Claude Code 指向 DeepSeek

有兩種合理的做法：

• 暫時性的 shell 環境變數

• 持久化的 ~/.claude/settings.json

來源文章使用第二種做法，而對於重複使用來說，我認為這是更適合日常使用的設定。

開啟設定檔：

vim ~/.claude/settings.json

然後貼上像這樣的最小可用設定：

{

"env": {

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",

"ANTHROPIC_AUTH_TOKEN": "your-deepseek-api-key",

"ANTHROPIC_MODEL": "deepseek-v4-flash",

"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash"

}

}

這呼應了來源指南的精神：簡單、持久，而且足以讓你開始前進。

根據最新 DeepSeek 文件整理的更完整版本

DeepSeek 官方的 Claude Code 整合文件現在展示了更完整的設定，針對 Opus、Sonnet、Haiku、subagents 與 effort level 分別提供預設值。如果你想要更完整的設定，請使用這個：

{

"env": {

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",

"ANTHROPIC_AUTH_TOKEN": "your-deepseek-api-key",

"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",

"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",

"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",

"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",

"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",

"CLAUDE_CODE_EFFORT_LEVEL": "max"

}

}

你實際上應該使用哪個模型？

簡單規則如下：

• 如果你想要較低成本與更快的日常寫程式體驗，請使用 deepseek-v4-flash

• 如果你想要更強的推理能力與更大量的長上下文工作，請使用 deepseek-v4-pro[1m]

如果你只是想讓第一次設定成功，先從 Flash 開始。等流程穩定後，再切換到 Pro 處理更困難的任務。

步驟 4：在啟動 Claude Code 前測試端點

理論上這一步是選用的，但在實際情況中，它可以讓你不用瞎猜。

在啟動 CLI 之前，直接呼叫 DeepSeek 的 Anthropic 相容端點：

curl -X POST https://api.deepseek.com/anthropic/v1/messages \

-H "Content-Type: application/json" \

-H "Authorization: Bearer your-deepseek-api-key" \

-d '{

"model": "deepseek-v4-flash",

"max_tokens": 10,

"messages": [

{

"role": "user",

"content": "test"

}

]

}'

如果你收到正常的 JSON 回應，代表 你的端點與金鑰都正常可用。

這很重要，因為它可以把失敗原因分成兩類：

• API 路由問題

• Claude Code CLI 問題

如果 curl 測試已經失敗，就不要浪費時間怪 CLI。

步驟 5：啟動 Claude Code

安裝與端點測試都通過後，就可以正常啟動 Claude Code：

claude

到這一步，從 CLI 端來看，使用體驗大致應該是正常的。主要差異只是 模型流量現在會透過 DeepSeek 的 Anthropic 相容介面進行路由。

你最可能遇到的錯誤

這裡是大多數「設定教學」開始變得太客氣、也因此不再實用的地方，所以我們直接講明白。

1. E212: Can't open file for writing

這通常不是 Claude 的問題，而是檔案系統權限問題。

修正方式：

mkdir -p ~/.claude

chown -R "$USER":"$USER" ~/.claude

chmod -R 755 ~/.claude

2. Unable to connect to Anthropic services or 403 Forbidden

這通常表示 Claude Code 仍在嘗試走預設路徑，或是你的端點設定有誤。

請確認：

ANTHROPIC_BASE_URL 必須完全是 `https：//api.deepseek.com/anthropic`

• 你的設定檔是有效的 JSON

• 你沒有不小心把檔案存到錯誤路徑

3. 401 Unauthorized

這幾乎一定是以下其中一種情況：

• API 金鑰錯誤

• 複製金鑰時多了空格或引號

• DeepSeek 帳號有帳務或餘額問題

不要把這個問題想得太複雜。401 通常是金鑰問題，不是模型問題。

4. 404 Not Found

這通常是模型名稱錯誤或路徑錯誤。

先檢查：

端點路徑：https://api.deepseek.com/anthropic

測試用請求路徑：/v1/messages

模型字串：deepseek-v4-flash 或 deepseek-v4-pro[1m]

如果你輸入了舊的或格式錯誤的模型名稱，即使其他設定都正確，請求仍可能失敗。

理解這套設定的更好方式

理解這件事最有幫助的方式，不是把它想成「我在 hack Claude Code」。

它更接近這樣：

Claude Code 是前端工作流程。DeepSeek 是後端模型路由。

一旦你用這種方式理解，設定就會更容易除錯：

• 如果 claude --version 失敗，那是安裝問題

• 如果 curl 測試失敗，那是 API 路由或驗證問題

• 如果兩者都成功但 session 仍然中斷，那就是 Claude 端設定問題

光是這樣區分，就能省下大量無意義的反覆試錯。

與舊教學相比有哪些變化

這點值得特別說明，因為整個生態系一直在變動。

原始教學著重於 最小可用設定，並使用 settings.json 加上 deepseek-v4-flash，這仍然很有用。但最新官方文件加入了一些細節，讓整體脈絡更清楚：

• Claude Code 現在已在 Anthropic 文件中提供官方原生安裝程式

• DeepSeek 提供明確的 Claude Code 整合指南

• DeepSeek 記錄了 Claude 風格模型家族的模型對應關係

• 建議的完整環境變數組合比舊版社群片段更廣泛

所以，如果你正在重寫自己的設定筆記，不要把指南停留在第一次剛好能運作的設定上。保留結構，但更新具體內容。

We0 AI 的定位

如果你正在使用 Claude Code、DeepSeek、WSL，以及以終端機為優先的工作流程來建置，通常在完成設定後，馬上會出現第二個問題：

你可以把東西做出來，但你的網站仍然沒有清楚到足以吸引正確的使用者。

這正是 We0 AI 被打造來解決的領域。

We0 AI 幫助創辦人、創作者、顧問、代理商和技術團隊建立展示型網站，清楚說明產品功能、提升搜尋排名，並將好奇心轉化為潛在客戶。換句話說，不只是「把頁面放上線」，而是真正讓產品變得易懂且容易被發現。

所以，如果你的技術堆疊變得更精準，但你的推廣仍然混亂，那就是下一個需要修正的瓶頸。

結論

原文有一點說得很對：突破點不是安裝 Claude Code 本身，而是讓整條路徑能在實際的 WSL/Linux 工作流程中可用。

如果你想要最短路徑：

• 安裝 Claude Code

• 設定 DeepSeek 的 Anthropic 相容端點

• 安全地儲存你的金鑰

• 先測試 API

• 然後啟動 claude

這就是整個重點。

如果出了問題，不要驚慌並重新安裝所有東西。多數情況下，問題只是以下四項之一：權限、端點路徑、API 金鑰或模型名稱。

參考資料

原始 CSDN 文章

Claude Code 概覽

Claude Code 設定

DeepSeek Claude Code 整合指南

DeepSeek Anthropic API 指南

DeepSeek 快速入門

相關文章與工具

• Claude Code 概覽

• Claude Code 快速入門

• Claude Code 設定

• DeepSeek Claude Code 整合指南

• DeepSeek Anthropic API 指南

• DeepSeek 模型與定價

• DeepSeek API 金鑰

• Node.js 下載

• Microsoft WSL 安裝指南

• npm CLI 文件