claude-init 中文配置套件實測：裝進來的是素材，不是中文環境

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

claude-init 是 GitHub 上一顆 1,367 星的 Claude Code 中文配置套件，在中文圈多半被介紹成「零門檻的中文 AI 編程環境」。我在乾淨的暫存目錄實際跑完它的一鍵安裝器，結論先講：這份倉庫值得當配置素材庫來挖，不適合當產品來裝。安裝器放進專案的檔案本身沒有問題，問題在兩個落差：README 主打的九個子代理、技能與八條規則，一個都沒有被複製進來；而安裝器自動寫出的設定檔裡，五個掛鉤有四個指向倉庫裡根本不存在的腳本。

先把它講準確。claude-init 不是把 Claude Code 翻譯成中文的軟體，而是一份專案初始化模板：作者把 CLAUDE.md 工作規則、hooks 自動化腳本、斜線指令、文件骨架這些配置檔用中文寫好，讓你搬進自己的專案。作者本人也在 2026 年 3 月的 README 裡把它定位成「僅供學習參考」，並建議大家直接用 Claude Code 官方版本搭配官方中文文件。這個自我定位，比任何行銷文字都更接近它的真實樣貌。

我在乾淨目錄跑了一次安裝器，先看它交付了什麼

它的安裝流程分兩段：install.sh 從 GitHub 下載倉庫打包檔，解開後交給 setup.sh 執行。setup.sh 預設直接把 Context7 與 Gemini 兩個 MCP 伺服器寫進設定，不再逐項詢問，然後把 templates 目錄裡的東西搬進你當時所在的專案。我在一個空的暫存目錄跑完全程，過程順利，沒有連外下載任何額外元件。順帶一提，install.sh 檔頭註解教的 curl 指令指向 install-cn.sh，這個檔名在倉庫裡並不存在，照抄會直接 404，也側面說明這條一鍵安裝路已經一陣子沒人保養了。

安裝結束後清點，專案裡多出來的是：根目錄的 CLAUDE.md 與 MCP-ASSISTANT-RULES.md、docs 目錄下的三層文件模板與 ai-context 專案文件、.claude/commands 底下十支斜線指令、.claude/hooks 底下的腳本與設定，以及 examples 裡三個範例專案。十支指令的名字值得看一眼：plan、tdd、code-review、e2e、build-fix、refactor-clean、test-coverage、update-docs、update-codemaps、learn，等於把「規劃、測試驅動、審查、收尾」的開發循環各配了一個捷徑，對還不知道該幫 Claude 建哪些指令的人，這份清單本身就是答案。到這裡為止，都與安裝器的說明一致。

落差出在 .claude 目錄。安裝完的 .claude 底下只有 commands、hooks、settings.local.json 三樣；templates 裡的 agents（九個子代理）、skills、rules（八條規則）、contexts、mcp-configs 五個子目錄全部留在原地，一個檔案都沒有搬。也就是說，README 在 v1.3.0 說明頁列得最漂亮的那些組件，恰恰是一鍵安裝拿不到的部分，你得自己進 templates 目錄手動複製。倉庫的 issue #28 回報的正是這件事，從 2026 年 2 月開立到現在沒有得到回應。

Pin

自動產生的設定檔，五個掛鉤四個指向不存在的腳本

安裝器寫出的 .claude/settings.local.json 是全文最值得停下來看的一段。它在 PreToolUse 掛了三個 hook：比對 mcp__ 開頭工具呼叫的安全掃描、針對 mcp__gemini 的上下文注入、針對 Task 工具的子代理上下文注入；另外在 Notification 與 Stop 事件掛了兩個通知 hook。五個 hook 分別指向四支腳本：mcp-security-scan.sh、gemini-context-injector.sh、subagent-context-injector.sh、notify.sh。

我把整個倉庫的 shell 腳本清點了一遍，全部只有八支，其中兩支是根目錄的安裝器本身；templates 裡的六支之中，會跟著 hooks 出貨的只有記憶持久化三支與壓縮提示一支，另外兩支放在 skills 目錄，安裝時同樣不會被搬走。上述四支被引用的腳本，一支都不存在。實際後果是：README 說的「MCP 呼叫前自動檢查敏感資訊」與「自訂通知音效」，在開箱狀態是空的，hook 每次被觸發，只會換來一行 bash 找不到檔案的錯誤。issue #27 回報 notify.sh 不存在，同樣掛著沒有人回。

還有一個更隱蔽的接線錯配。有被完整出貨的記憶持久化腳本（session-start、session-end、pre-compact 三支）與壓縮提示腳本，是掛在 hooks.json 這份型錄裡，但 hooks.json 寫的執行路徑是家目錄的 ~/.claude/hooks/，安裝器卻把腳本裝到專案目錄的 .claude/hooks/。兩邊對不上，不手動搬移或改路徑，這些腳本同樣不會生效。換句話說，這份套件「會動的部分」與「宣稱會動的部分」是兩個集合，採用前得自己重新接線。

把五個掛鉤攤開看，你會發現設計者的意圖其實不差：在 MCP 工具呼叫前掃敏感資訊，是想攔住金鑰與個資外流；對 Gemini 工具注入上下文，是想讓第二意見模型知道專案現況；在 Task 工具觸發時注入子代理上下文，是想讓每次分工都帶著專案規則。方向都對，只是倉庫裡少了把這些念頭落地的四支腳本。若你願意自己補，這份設定檔反而是一份不錯的架構藍圖，比多數只在 README 裡喊「安全第一」的模板具體得多。

一千三百多顆星是怎麼來的，作者又怎麼看它

把 git 歷史攤開，這個倉庫的曲線就很清楚了。它在 2025 年 8 月底上架（README 自述專案起於 2025 年 7 月），正好趕上 Claude Code 在中文圈的第一波熱潮，星數快速累積。內容最大的一次更新發生在 2026 年 1 月 22 日的 v1.3.0：把 Anthropic 黑客松冠軍團隊的 everything-claude-code 生產級配置整套中文化，README 特別標注了來源與兩位原作者，九個子代理、十支指令、八條規則與技能目錄都來自這一批。這個動作對星數有幫助，但也埋下期待落差：點讚的人以為買到的是「中文版 Claude Code」，實際上是一份翻譯並重組過的配置合集。

這個落差最後由作者自己收場。2026 年 3 月 12 日，他因為 issue #30（新入門的人按讚之後發現與預期不符）更新 README，明確寫下歸檔說明「僅供學習參考」，並強調「不是 Claude Code 的漢化版本」「建議直接使用官方版本並參考官方中文文件」。這是倉庫的最後一次實質更新，幾分鐘後的合併提交之後就凍結到今天，四個 open issues 從 2026 年 1 月與 2 月開立至今，全部零回應。

Pin

回看版本史，這份倉庫的活躍期其實只有半年。2025 年 9 月中連發 v1.2.4 到 v1.2.5，修 MCP 安裝指令、補上專家代理系統；2025 年 9 月 17 日完成六個章節的 Claude Code 中文課程翻譯；2025 年 10 月 21 日版本推進到 v1.2.8（只記在 CHANGELOG，沒有發 GitHub release），補上 Skills 功能演示與另外兩種技術棧的範例專案；2026 年 1 月 22 日的 v1.3.0 是最後一個大版本。節奏很清楚：作者跟著 Claude Code 的功能演進一路補文件、補範例，直到官方文件自己補齊中文版，這份中介物的歷史任務也就結束了。

「完全中文化」與「免翻牆」這兩個印象，都停在 2025 年秋天

如果你是因為「裝完就有全中文環境」的說法找上它，這裡要潑兩盆冷水。第一盆：整份 templates 找不到任何「請用中文回覆」之類的語言指令設定。CLAUDE.md 是一份用中文寫的工作規則，告訴 Claude 這個專案怎麼分工、怎麼測試、怎麼提交流程，它不是把 Claude 的介面或模型輸出變成中文的開關。issue #29 的標題就寫得很直白：安裝後所有 AI 上下文和提示沒有中文化。裝完之後 Claude 依然照你的專案設定與檔案內容回話，中文程度取決於你怎麼下規則。

第二盆冷水是「免翻牆」的說法。這個印象有歷史依據，但已經過時：2025 年 8 月底，README 曾經有一個轉發服務的贊助商區塊，宣稱中國大陸開發者不需要翻牆就能使用 Claude Code；2025 年 10 月 10 日的提交已經把這個區塊整個移除，只有倉庫自己的簡介欄至今還留著「支持免翻牆訪問」幾個字。中文圈對這個套件的介紹多數發布於 2025 年 9 月初，正好趕在移除之前，之後就沒有跟上。對台灣讀者來說這點本來就影響有限，Claude 的官方服務在台灣可以直接使用，不需要經過第三方轉發，自然也不必把 API 金鑰與程式碼多交給一個來路不明的中間人。

還值得拿走的三類素材

把它當素材庫看，這份倉庫其實相當扎實，我會挑三類東西帶走。

最先值得搬的是 hooks 的設計想法。開發伺服器沒包在 tmux 裡就直接擋掉、git push 前暫停下來等你審查變更、阻止 Claude 順手亂開文件檔、編輯完自動跑格式化與型別檢查、收工前對修改過的檔案清算 console.log。這些 hook 的提示訊息全部中文化，邏輯搬回自己專案、把路徑改掉就能用，對養成紀律很有幫助。

規則與代理的中文範本是第二個寶庫。八條規則涵蓋安全、編碼風格、測試、git 工作流等面向，九個子代理各有完整的職責描述，從規劃器、架構師、TDD 導師到安全審查員都配好了提示詞，對照 everything-claude-code 的英文原文，還能順便學到這類提示詞的寫法。想擴充 Claude Code 的能力邊界，也可以對照把第三方技能裝進 Claude Code 的 UI UX Pro Max，以及收錄現成技能的 Awesome Claude Skills 與 /last30days 這類配置資源；想讓 AI 產出的文字少一點機器感，則有 Claude Code Humanizer 可以參考。

文件骨架與 MCP 設定目錄則是最後一塊。三層文件模板（根目錄 CLAUDE.md 當主上下文、組件層與功能層各一份繼承文件）適合直接套進中大型專案，它的分層想法是讓 Claude 只在碰到特定組件或功能時才載入對應細節，平常佔住的上下文越少越好；docs 目錄裡另外放了整套中文課程，六個章節從核心概念、斜線指令到工作流實踐都翻完了，即使不裝套件，單獨拿來當中文學習材料也站得住。mcp-configs 裡則列了十五個 MCP 伺服器的現成設定，從 GitHub 的 PR 與 issue 操作、Supabase 資料庫、Vercel 與 Railway 部署，到 Cloudflare 的文件搜尋、Workers 構建、路由綁定與日誌觀測四件套，再加 ClickHouse 查詢與網頁抓取，等於一張後端與部署工作的採購清單。檔尾註解那句「保持啟用的 MCP 少於 10 個以節省上下文視窗」，是整份型錄裡最值錢的一行。

採用前要接受的四個條件

把期待校正完，如果你還是想用，有四件事先擺在心上。最前面的是心態：把它當靜態參考資料，倉庫自 2026 年 3 月起凍結、issues 無人處理，而 Claude Code 的設定格式這一年持續演進，抄回來的 hooks 要自己驗證能不能跑。接著是平台：README 明寫只支援 macOS 與 Linux，作者沒有 Windows 環境可以測試。安裝方式也要重新想：一鍵安裝不等於全套，要完整組件得自己進 templates 目錄搬，settings.local.json 裡四個指向不存在腳本的 hook，建議直接刪掉或自己補上實作；我自己會建議的走法是跳過安裝器，直接 clone 倉庫當成一份可以翻閱的型錄，看中哪個檔案再單獨複製進專案，這樣至少不會把壞接線一起帶進去；現版 README 的快速開始其實也是這樣教的，推薦的起手式就是 clone 之後查看 templates/.claude/ 目錄，一鍵安裝器已經不在建議路徑上。最後是 MCP 的金鑰與資料流向要自己把關：Context7 需要申請 API 金鑰（設定檔裡留的是佔位字串），安裝器宣稱 Gemini 端的工具不需要金鑰，但這類第三方套件的資料流向，值得在使用前自己再查一層。

授權與專案狀態

claude-init 採 MIT 授權，LICENSE 檔就在倉庫根目錄，修改與商用都沒有問題；要留意的是 v1.3.0 的主體內容源自 everything-claude-code，沿用時保留出處是基本禮貌，README 的致謝段已經把兩位原作者與原始倉庫列清楚。專案狀態方面，最後提交停在 2026 年 3 月 13 日，最新版本是 2026 年 1 月的 v1.3.0，作者已將它定位為學習參考資料（本文查核日期為 2026 年 8 月 26 日）。一句話收尾：想找中文的 Claude Code 配置範本與規則文字，它仍然是一份好教材；想要裝完就變中文環境的產品，這條路在官方中文文件裡，不在這裡。