一份 settings.json 先被寫成了模板：Claude Code 在 Windows 上的落地，是一頁可複製的介面

2026 年 9 月 30 日，掘金作者「蟲無涯」發布了一篇長文，題為《Windows 下 Claude Code 落地全指南：從安裝配置到避坑優化》。文章整理了這個命令列工具在 Windows 上從安裝、對接國內模型、中文化到效能調校的完整流程。這類教學文向來量大，但這一篇值得從設計角度讀，因為它把一個開發工具的「落地」過程，寫成了一份可以逐行複製的模板。

先從最小的單位看起：那個 settings.json。

安裝路徑本身就是一個設計決定

文章開篇處理的第一件事，並非功能，而是「裝在哪裡」。官方 PowerShell 腳本預設把 Claude Code 裝進 C:\Users\使用者名稱.local\bin，對此作者提供了三條路：WinGet 一行指令安裝、官方腳本安裝，以及手動下載二進位檔部署到 D 槽自訂路徑，並新增一個名為 CLAUDE_CODE_INSTALL_DIR 的環境變數。

這個細節透露的是命令列工具與圖形介面軟體的根本差異。圖形軟體的安裝位置由安裝精靈代管，使用者多半無感；命令列工具的路徑卻直接寫進系統的 Path 環境變數，成為每次敲下 claude 指令時都會被讀取的一行文字。路徑放哪、要不要遷出 C 槽、遷移後如何避免自動更新把它搬回去，這些在圖形介面裡被隱藏的決策，在命令列世界裡全部攤開給使用者自己排。指南的價值正在於把這些決策先排好順序。

settings.json 是一套被排好的信任層級

文章的核心段落是那份可直接複製的全域配置模板。幾個欄位特別值得看。

“permissions” 底下的 “files”: “allow” 與 “commands”: “allow”，等於把檔案存取與指令執行的確認欄位一次全開。作者在文中也提到「頻繁的權限確認彈窗」是實際使用中的痛點，這兩行就是對那個痛點的回答。對照我們先前觀察過的模型的思考量如何被做成可調的 effort 檔位，可以發現同一個產品家族的一貫手法：把反覆出現的決策收斂成少數幾個欄位，讓使用者設定一次、之後不再被打斷。

環境變數區塊則是另一種排版。“ANTHROPIC_BASE_URL” 指向阿裏雲的相容介面，“ANTHROPIC_MODEL” 指定具體模型，“API_TIMEOUT_MS” 設為 600000，也就是十分鐘。作者特別提醒網址末尾不能加 /v1，否則會 404；遇到 Arrearage 400 錯誤代表帳戶欠費。這些提醒的共通點是：它們全都無法從欄位名稱本身推導出來，只能靠踩過坑的人寫下來。一份好的配置模板，因此從來不只是程式碼，而是把錯誤訊息、計費邊界與網路環境的知識，壓縮進幾行鍵值對的註解與說明裡。

這種把外部服務的差異藏在環境變數後面的做法，近年在開發者工具裡越來越常見，我們在開發者用 Claude 寫出支援 JMAP 的開源郵件客戶端一文裡，也看過類似的取捨：介面保持簡單，複雜度全部沉到配置層。

教學文的排版，決定了它的可用性

回到文章本身。這篇指南的結構是典型的「避坑式」寫作：每個段落先給可直接執行的指令，再補上出錯時的對照說明。指令與說明的比例拿捏得節制，沒有把每個參數都展開成原理講解，而是只在會出錯的地方停下來。

這正是命令列工具教學最難的部分。同樣一份配置，寫成官方文件往往按欄位分類，查詢方便但缺少使用時序；寫成個人經驗分享則多了時序，卻常混入難以複製的個別環境。這篇指南選擇了中間路線：以安裝到優化的時間軸為骨架，每個步驟附上可整段貼上的程式碼。對讀者而言，文章本身就是一個介面，它的可用性取決於程式碼區塊能否被原封不動地複製執行。

結語

Claude Code 在 Windows 上的「落地」，表面看是工程問題，實際上是一連串介面設計的累積：安裝路徑被寫進 Path，信任層級被壓縮成兩個 allow，網路環境的差異被藏進三個環境變數。而這篇指南做的事，是把這些散落的欄位排成一份有先後順序、可逐段複製的文件。當一個工具的復雜度無法再從介面上簡化時，把它寫成一份誠實的模板，本身就是一種設計。