Skills Atlas · deepclaude 使用說明書

Open Source Deep Dive · aattaran/deepclaude

Skills Atlas — 單一倉庫深讀讓 Claude Code 跑
DeepSeek 的腦。
同樣 UX，17 倍便宜。

aattaran/deepclaude 不是 fork，也不是重寫 — 它只用一支 bash 與 PowerShell 腳本改寫環境變數，把 Claude Code 的自主代理迴圈導向 DeepSeek V4 Pro、OpenRouter 或 Fireworks。離開時還原原值，整段過程不到 20 KB 的程式碼。Tenten 把整套運作機制、CLI 旗標、實戰場景一次拆給你看。

GitHub Stars

1.1k ★

主分支 15 個 commit，發布僅數週即進入社群熱榜。

支援後端

4 Backends

DeepSeek V4 Pro · OpenRouter · Fireworks · Anthropic 原生。

成本壓縮

17×

Output token 從 $15／M 降至 $0.87／M，月帳單由 $200 級距落到 $50 上下。

授權與驗證

MIT

README、proxy 程式碼、CLI 旗標皆於 2026 年 4 月最後驗證。

01 / 編者手記 FROM THE EDITOR · APRIL 2026 · DEEPCLAUDE DEEP READ

Claude Code 的外殼，已經可以跑別家的引擎。

編者手記 EDITOR'S NOTE

deepclaude 證明了一件事 — Claude Code 的價值不全在底層模型，外殼本身就值得。當你能把後端換成 DeepSeek、OpenRouter、Fireworks，並維持完全相同的 agentic 迴圈與工具呼叫，你就買到了「自由換腦」的選擇權。

不是 fork — 只是改寫環境變數。

deepclaude 不重寫 Claude Code，也不維護 patch。它只在腳本層攔截 ANTHROPIC_BASE_URL 與 ANTHROPIC_AUTH_TOKEN，把流量導向你選的 backend，session 結束時自動還原原值。整支 deepclaude.sh 與 deepclaude.ps1 加起來只有幾百行。

把 80% 的日常題交給 DeepSeek。

DeepSeek V4 Pro 在 LiveCodeBench 拿到 93.5% 高分，超過 Gemini 3.1 Pro 與 Claude Opus 4.6。重構、改 bug、寫測試、調 CSS — 多數日常題它做得起來。剩下 20% 真正硬的推理題，再用 --switch anthropic 切回 Opus，把錢花在刀口上。

中途切換不重啟，slash command 即時換腦。

跑到一半發現 DeepSeek 卡住？打 /anthropic 換 Opus；確認 Opus 已收尾再 /deepseek 切回省錢模式。VS Code 用戶有 Ctrl+Alt+D ／ Ctrl+Alt+A 鍵盤直切。也可呼 http://127.0.0.1:3200/_proxy/mode 由腳本驅動。

02 / 功能總覽 FEATURES & CAPABILITIES · AGENT LOOP · MULTI-BACKEND

功能 Capabilities

deepclaude 用最小程式碼把 Claude Code 的 agentic 迴圈接到便宜後端 — 以下是六個你會天天用到的核心能力。

6 Entries
Agent Loop · Multi-Backend
Verified Apr. 2026

01^/06

aattaran / deepclaude — same UX, 17× cheaper

同樣的 UX，17 倍便宜

Claude Code 自主代理迴圈完整保留，只把後端換成 DeepSeek V4 Pro

核心定價對比：Anthropic Opus 在 $15/M output token，DeepSeek V4 Pro 在 $0.87/M，差距約 17 倍。重度使用者從 Anthropic Max 20× 的 $200／月降到 DeepSeek 的 $50 上下，等於把預算釋出給 Opus 處理真正困難的題目。Note：DeepSeek 促銷價於 2026 年 5 月 31 日後翻倍，但仍遠低於 Anthropic 原生定價。

✓ 17× 成本壓縮 ★ 1.1k Stars DeepSeek V4 Pro LiveCodeBench 93.5%

Output $0.87/M Anthropic $15/M License MIT

deepclaude — backends

四種 Backend，即插即換

DeepSeek · OpenRouter · Fireworks · Anthropic 原生

指令格式 --backend {ds|or|fw|anthropic}，縮寫 -b ds。OpenRouter 路由百家模型、Fireworks 提供低延遲推論、Anthropic 原生則保留 Opus 給硬題。任一家都得是 Anthropic-相容端點，所以 Claude Code 不需要任何修改。

DeepSeek (ds) OpenRouter (or) Fireworks (fw) Anthropic 原生

Flag --backend Short -b

deepclaude — live switch

中途切換 — 不重啟 Session

Slash command、CLI 旗標、HTTP API 三條路任選

在 Claude Code 內直接打 /deepseek、/anthropic、/openrouter 即可換腦，原本的對話歷史與工具狀態都保留。終端使用者亦可呼 --switch ds（或 -s ds）；自動化腳本則直接 POST /_proxy/mode。

/deepseek /anthropic --switch / -s

Endpoint /_proxy/mode State Preserved

deepclaude / proxy / model-proxy.js

DeepSeek 自動Context Caching

同一輪上下文重複命中，token 成本再降一個量級

DeepSeek API 對重複的上下文片段提供大幅折扣，作者宣稱在 cache hit 情況下能再壓到原本 token 費的 1/120。對長文件審閱、巨大 codebase agentic 操作這種「同一份 context 反覆讀」的情境，效益最明顯。

120× Cache 折扣長 Context 友善 Codebase agent

Provider DeepSeek Mode Auto

deepclaude — cost API

Token 流量與成本追蹤 API

_proxy/cost endpoint 即時回算節省金額

呼 curl -s http://127.0.0.1:3200/_proxy/cost 直接拿到當下 session 的 input／output token 統計與「若用 Anthropic 原生會花多少」的對照。--cost 旗標則顯示靜態比價表，--benchmark 同時對三家 backend 跑延遲測試。

/_proxy/cost --cost --benchmark

Port 3200 Format JSON

deepclaude / proxy / start-proxy.js

遠端瀏覽器控制模式

--remote 旗標啟動 WebSocket bridge，從手機接管 Claude Code

deepclaude --remote -b ds 會啟動本地 proxy 並透過 Anthropic 的 OAuth bridge 開出可從瀏覽器存取的遠端 session — 認證走 Anthropic、實際模型呼叫走 DeepSeek。出差、外出開會時手機接管 agentic 任務特別實用。

--remote WebSocket bridge Anthropic OAuth

Auth Anthropic Model DeepSeek

03 / 安裝與設定 INSTALLATION · ENV VARS · BACKEND ROUTING

安裝 Setup

五分鐘把 deepclaude 接上你既有的 Claude Code — 從 API key 設定、proxy 啟動到 VS Code 鍵盤快捷鍵。

6 Entries
Bash · PowerShell · Node 18+
Cross-Platform

01^/06

aattaran / deepclaude — install scripts

Bash 與 PowerShell 雙腳本對齊

macOS / Linux 用 deepclaude.sh，Windows 用 deepclaude.ps1

macOS／Linux 安裝：chmod +x deepclaude.sh 後 sudo ln -s "$(pwd)/deepclaude.sh" /usr/local/bin/deepclaude。Windows 端則 Copy-Item deepclaude.ps1 "$env:USERPROFILE\.local\bin\deepclaude.ps1"。整支腳本只重寫環境變數、啟動本地 proxy，session 結束時還原 — 無需 fork、無需 Docker。

✓ 跨平台 No Docker No Fork ~5 分鐘

macOS/Linux deepclaude.sh Windows deepclaude.ps1 Runtime Node 18+

deepclaude — API keys

三個 API Key 環境變數

擇一即可，多放可隨時切後端

DEEPSEEK_API_KEY、OPENROUTER_API_KEY、FIREWORKS_API_KEY — 同時設定多家、執行時用 -b ds|or|fw 選擇。Windows 用 setx 永久寫入，Unix 系列寫進 ~/.zshrc 或 ~/.bashrc。

DEEPSEEK_API_KEY OPENROUTER_API_KEY FIREWORKS_API_KEY

Required 至少 1 個 Recommended DS + OR

deepclaude — base URL override

關鍵環境變數改寫機制

ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 是整個 trick 的核心

Claude Code 讀 ANTHROPIC_BASE_URL 決定流量送去哪、讀 ANTHROPIC_AUTH_TOKEN 帶哪把 key。deepclaude 在啟動時把這兩個值指向本地 proxy（預設 127.0.0.1:3200）與 DeepSeek key，session 結束自動還原原值 — 不會污染你的全域環境。

ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN Auto-revert

Mechanism Env rewrite Scope Per session

deepclaude / proxy

本地 Proxy Server 架構

model-proxy.js + start-proxy.js，跑在 port 3200

start-proxy.js 啟動一支 Node 18+ HTTP 伺服器；model-proxy.js 把 /v1/messages 請求路由到 DeepSeek（或所選 backend），其餘請求（OAuth、bridge）原封不動回 Anthropic。整支實作不到 200 行 — 讀完一杯咖啡的時間。

port 3200 model-proxy.js ~200 LOC

Endpoint /v1/messages Bridge Anthropic

deepclaude — model tier mapping

三段模型階層 +Subagent 客製

Opus / Sonnet / Haiku 名稱可被替換成任意模型

設 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 把對應階層改寫成你要的模型；另設 CLAUDE_CODE_SUBAGENT_MODEL 把所有 spawn 出去的 subagent 切成更便宜的型號 — 大型重構任務這項最有感。

OPUS / SONNET / HAIKU CLAUDE_CODE_SUBAGENT_MODEL 三段階層

Tiers 3 Subagent Custom

deepclaude — VS Code shortcuts

VS Code 鍵盤快捷鍵

Ctrl+Alt+D 切 DeepSeek，Ctrl+Alt+A 切回 Anthropic

把 Ctrl+Alt+D 與 Ctrl+Alt+A 綁進 VS Code 的 keybindings.json，跑到一半發現任務超出 DeepSeek 能力時手指肌肉記憶就能切回 Opus，跑完再切回。對在 IDE 裡開 Claude Code 內嵌終端的開發者特別自然。

Ctrl+Alt+D Ctrl+Alt+A keybindings.json

IDE VS Code Bind 2 keys

04 / 進階用法 POWER-USER PATTERNS · CLI · CHAIN-WITH

六個值得記住的進階用法

Tenten 在實測過程中歸納出最值得寫進 dotfile 的六個 deepclaude 招式 — 全部可在 README 與 --help 輸出裡驗證，沒有自行延伸的捷徑。

deepclaude — slash commands

/deepseek、/anthropic、/openrouter 即時換腦

不離開當前 session 就把後端切走

在 Claude Code 對話中直接打 /deepseek 切便宜模式，遇到硬題改 /anthropic。等同於把「我這條 session 是哪家在跑」變成可隨時調整的選項。指令在 README 明確列出，無需額外設定。

/deepseek /anthropic /openrouter

Scope Session

deepclaude --benchmark

--benchmark 一次比較三家延遲

同一份 prompt，三家 backend 同時跑、列出 ms 級數據

執行 deepclaude --benchmark 會對 DeepSeek、OpenRouter、Fireworks 三家發出同樣的測試請求，比較 first-token 延遲與完整回應時間。北美使用者多選 Fireworks，亞洲使用者多選 DeepSeek 直連 — 用實測數據決定，而非聽說。

--benchmark 延遲實測三家比較

Output ms / req

deepclaude --status

--status 即時看認證狀態

列出哪些 backend 已配 key、目前活躍的是誰

deepclaude --status 會掃描 DEEPSEEK_API_KEY、OPENROUTER_API_KEY、FIREWORKS_API_KEY 是否設定、proxy 是否在跑、目前路由到哪家。新環境第一件事就是它，避免「為什麼還在跑 Anthropic 原生」的迷茫五分鐘。

--status 認證檢查 Smoke test

Use first 每次新環境

deepclaude --cost

--cost 顯示靜態比價表

不跑 session 也能查看當前各家 input／output 報價

deepclaude --cost 直接列出 DeepSeek、Anthropic、OpenRouter、Fireworks 的最新單價（input／output／cache hit）。配 curl -s http://127.0.0.1:3200/_proxy/cost 取得當前 session 的累積消耗，兩者一起寫進 dotfile alias 最方便。

--cost /_proxy/cost Pricing table

Live curl :3200

deepclaude — _proxy/mode HTTP API

用 HTTP API 由腳本驅動切換

/_proxy/mode 端點可被任意外部工具呼叫

把切換邏輯寫進 git pre-commit hook、CI 任務、或 IDE 巨集 — POST http://127.0.0.1:3200/_proxy/mode 帶上 {"mode":"ds"} 即切 DeepSeek。比較複雜的工作流可以根據檔案類型自動切（譬如改 docs 切 Haiku、改 src 切 Sonnet 等）。

POST /_proxy/mode Hook 友善 CI 整合

Method POST JSON

deepclaude — subagent tier swap

CLAUDE_CODE_SUBAGENT_MODEL 把子代理打折

主代理保留高階模型、spawn 出去的子代理一律切便宜

設定 CLAUDE_CODE_SUBAGENT_MODEL 把 Claude Code 主動 spawn 的所有 subagent 統一切到便宜階層 — 主代理跑 Sonnet 做規劃、子代理跑 Haiku 做雜工，整體成本再降一階。對大型重構、批量檔案掃描的任務最實用。

CLAUDE_CODE_SUBAGENT_MODEL 主／子分流大型任務

Pattern Tier split

05 / 實戰應用 REAL-WORLD WORKFLOWS · WHO ACTUALLY BENEFITS

實戰 Use Cases

deepclaude 不是一個演示專案 — 以下六個情境是它真正能省下錢、省下時間、或解決政策問題的場合。

6 Entries
Indie · Team · OSS
Verified Workflows

01^/06

deepclaude — indie developer playbook

每天重度使用的獨立開發者

把 $200／月的帳單壓回 $50 上下

原本訂 Anthropic Max 20× 跑滿一整天 agentic 任務的 indie hacker，把日常題交給 DeepSeek、硬題切回 Opus。同樣的 Claude Code UX、同樣的 agent loop，月成本壓縮到原本的四分之一。對 side project、freelance 接案、bootstrap SaaS 特別有感。

✓ 月省 $150 Indie / SaaS Freelance Bootstrap

From $200/mo To ~$50/mo Saving 75%

deepclaude — multi-model routing

依任務難度手動分流

日常題交 DeepSeek，硬推理切回 Opus，文件級任務改 Haiku

對 80% 的 CRUD、UI 微調、改測試任務跑 -b ds；遇到複雜重構或棘手的併發問題打 /anthropic 切 Opus；只要做大量 boilerplate 或文件改寫時切到 Haiku 階層。同一條 session、同樣的 context — 但成本依任務動態浮動。

任務分流 /deepseek + /anthropic 同 session

Logic Manual Switch Mid-session

deepclaude — open source maintainers

沒有 API 預算的開源維護者

教學專案、研究 demo、CS 課程作業

學生、教學者、開源 maintainer 通常沒有公司 API 額度。透過 OpenRouter 或 Fireworks 的 free tier、再走 deepclaude，能用近似免費的方式跑完 Claude Code 的 agentic 流程 — 適合教學課程、coding bootcamp、論文重現。

教學專案課程作業 OpenRouter Free

Audience Students Backend Free tiers

deepclaude — enterprise PoC

企業 PoC 階段控制成本

尚未編到 AI 預算的內部專案，先用便宜後端跑通流程

內部創新團隊在主管簽 AI 預算前，常需要先做 PoC 驗證 ROI。deepclaude 讓 PoC 先跑在 DeepSeek 上、確認 agentic 流程可行後，再向 IT 申請正式的 Anthropic Enterprise 額度，避免在驗證階段就燒掉預算。

PoC 階段企業內部創新預算未定

Stage PoC Promote Anthropic

deepclaude — remote agent

遠端團隊用 --remote 接管

出差、外出、移動辦公時從手機瀏覽器繼續代理任務

deepclaude --remote -b ds 啟動瀏覽器可存取的 session，認證走 Anthropic OAuth bridge，模型呼叫走 DeepSeek。團隊主管在咖啡廳用手機指派 Claude Code 處理小任務，回辦公室再用桌機接續 — 共用同一條 session 與工具狀態。

--remote 手機接管遠端協作

Auth OAuth Backend Configurable

deepclaude — batch refactor

大規模批次重構與 codebase 稽核

DeepSeek 自動 cache 命中率高 — 越大的 codebase 越省

針對單一 monorepo 跑全庫 lint 修復、依賴升級、註釋翻譯這類「同 context 反覆問」的任務，DeepSeek 的 context cache 能把重複 token 費再壓一個量級。配 CLAUDE_CODE_SUBAGENT_MODEL 把 spawn 出來的子代理切 Haiku 階層，整體成本接近原本的 1/30。

批次重構 Codebase 稽核 Cache 命中

Ratio ~30× Best for Monorepo

06 / 社群觀察 COMMUNITY PULSE · HN · MEDIA · 2026

deepclaude 在社群裡怎麼被討論

開源 release 數週內就累積到 1.1k Stars，並進入 Hacker News、Decrypt、Yahoo Tech、Mind Studio、PromptZone 等多家媒體與技術社群的討論。以下是 Tenten 篩選的幾條代表訊號，全部可點擊回原始來源驗證。

Hacker News · DeepClaude – Claude Code agent loop with DeepSeek V4 Pro

Hacker News 登上首頁

主題標題：「DeepClaude – Claude Code agent loop with DeepSeek V4 Pro」

HN 用戶聚焦在三個爭議點：環境變數覆寫的潛在風險、DeepSeek 在 hard reasoning 上是否真能取代 Opus、以及 vision 與平行 tool call 等功能在 DeepSeek 端點不支援的限制。整體討論偏正面，視為「Claude Code 外殼價值」的現實驗證。

Hacker News Front page 技術討論

Item 48002136

Decrypt · DeepClaude Lets You Run Claude Code With DeepSeek's Brain for 17x Cheaper

Decrypt 給出「17×」標題

主流 Web3／AI 媒體首發報導，明確點名成本壓縮為核心賣點

報導重點：「The trick is environment variables — Claude Code reads a handful of them to decide where to send API calls, and DeepClaude rewrites those for the duration of a session.」這句被多家媒體轉述，成為 deepclaude 公開敘事的定錨。

Decrypt 主流媒體 17× 標題

Outlet Decrypt

Yahoo Tech · DeepClaude Lets You Run Claude Code With DeepSeek's Brain for 17x Cheaper

Yahoo Tech 同步轉載

把故事帶進非開發者的科技讀者圈

Yahoo Tech 轉載 Decrypt 的全文，把 deepclaude 帶進主流科技讀者視野。對採購決策者與企業 IT 而言，「Yahoo 報導過」常是觸發內部評估流程的 signal。

Yahoo Tech Mainstream 企業 signal

Outlet Yahoo Tech

MindStudio · How to Run Claude Code Against DeepSeek V4 for $3 a Session

MindStudio 寫成逐步教學

「$3 a Session」的具體成本錨點被工具圈廣泛引用

MindStudio 的部落格把 deepclaude 變成 step-by-step setup 教學，並用「一場 session 約 $3」這個具體錨點，讓「便宜很多」變成讀者可量化感受的數字。對開源 onboarding 來說極具價值。

MindStudio 逐步教學 $3／session

Type Tutorial

PromptZone · DeepClaude: 17x Cheaper AI Coding Agent

PromptZone 與 Let's Data Science 雙轉載

獨立 AI／資料科學社群把 deepclaude 寫進「值得追的開源」清單

PromptZone 與 letsdatascience.com 兩個資料科學／AI 從業者社群同時收錄 deepclaude，把它定位為「2026 年 indie hacker 必裝」級別的工具。社群觀感正面、討論集中於實際成本對照。

PromptZone Let's Data Science DS 社群

Audience DS / AI

GN Crypto · DeepClaude Runs Claude Code on DeepSeek for 17× Lower Cost

跨界 Web3／加密社群同步報導

非典型 AI 受眾也開始把 deepclaude 列為「值得學的工具」

GN Crypto、TechPlanet 等非主流 AI 領域媒體都跟進報導，意味著「便宜跑 Claude Code」這個訴求觸及到主流 AI 工程圈以外的開發者群體 — 包含 Web3、自動化交易、資料量化等對 token 成本敏感的領域。

GN Crypto TechPlanet 跨領域擴散

Reach Web3 / Quant

想把 deepclaude 接進你的團隊？

換腦、省錢、不換 UX。
把多模型路由接上你的
正式工作流，是 Tenten 在做的事。

Tenten 是 AI-First 設計與技術顧問公司。我們把 Claude Code、deepclaude、MCP、Agentic Commerce 接進 Headless CMS、Webflow、Shopify Plus 的企業級交付 — 讓「同樣 UX、17 倍便宜」這個敘事，真正跑在你的 production pipeline 上。

預約 30 分鐘諮詢 → Tenten Awesome List

Tenten 如何部署 deepclaude

多模型路由架構諮詢

為團隊規劃 DeepSeek／OpenRouter／Anthropic 分流規則，建立成本可觀測的路由層。

deepclaude × CI/CD Sprint

兩週固定價格，把 _proxy/mode 與 _proxy/cost 接進 GitHub Actions、把 token 帳單變成可審計的工程資產。

Agentic Commerce Build

Shopify Plus / Webflow / Headless 遷移，搭配 Claude + deepclaude 營運層大幅壓縮日常 token 成本。

Claude Code 的外殼，已經可以跑別家的引擎。

不是 fork — 只是改寫環境變數。

把 80% 的日常題交給 DeepSeek。

中途切換不重啟，slash command 即時換腦。

功能 Capabilities

同樣的 UX，17 倍便宜

四種 Backend，即插即換

中途切換 — 不重啟 Session

DeepSeek 自動Context Caching

Token 流量與成本追蹤 API

遠端瀏覽器控制模式

安裝 Setup

Bash 與 PowerShell 雙腳本對齊

三個 API Key 環境變數

關鍵環境變數改寫機制

本地 Proxy Server 架構

三段模型階層 +Subagent 客製

VS Code 鍵盤快捷鍵

六個值得記住的進階用法

/deepseek、/anthropic、/openrouter 即時換腦

--benchmark 一次比較三家延遲

--status 即時看認證狀態

--cost 顯示靜態比價表

用 HTTP API 由腳本驅動切換

CLAUDE_CODE_SUBAGENT_MODEL 把子代理打折

實戰 Use Cases

每天重度使用的獨立開發者

依任務難度手動分流

沒有 API 預算的開源維護者

企業 PoC 階段控制成本

遠端團隊用 --remote 接管

大規模批次重構與 codebase 稽核

deepclaude 在社群裡怎麼被討論

Hacker News 登上首頁

Decrypt 給出「17×」標題

Yahoo Tech 同步轉載

MindStudio 寫成逐步教學

PromptZone 與 Let's Data Science 雙轉載

跨界 Web3／加密社群同步報導

把 deepclaude 接進不同團隊的工作流

DeepSeek 為日常主力，Opus 留給硬題

建一條分流規則，依任務型態自動切後端

用 OpenRouter 免費額度跑教學案例

PoC 階段先省成本驗證，正式上線再切 Anthropic

換腦、省錢、不換 UX。 把 多模型路由接上你的 正式工作流，是 Tenten 在做的事。

換腦、省錢、不換 UX。
把多模型路由接上你的
正式工作流，是 Tenten 在做的事。