Claude Code 配合 DeepSeek 封面

這就是原本教學背後的核心做法；坦白講，它正正解決了好多開發者一直遇到的問題：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 或 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 文件