如何輕鬆在 Windows 與 Mac 上安裝 Claude Code

在 Windows 或 Mac 上快速安裝 Claude Code、設定環境,並搭配 Kimi API 實現進階 AI 工作流程。自動化複雜任務、執行多步驟流程,透過更智慧的 AI 整合提升你的程式開發體驗。

閱讀時長:10分鐘2026-07-22
在 Windows 與 Mac 上安裝 Claude Code

AI 程式開發工具正成為想要更快速、更有效率完成任務的開發者的熱門選擇。許多使用者選擇安裝 Claude Code,以簡化程式開發流程、自動化重複性工作,並在單一環境中管理多步驟流程。在 Windows 或 Mac 上正確設定,有助於確保順暢運作,並與進階 AI 服務更好地整合。繼續閱讀,了解如何在 Windows 與 Mac 上安裝 Claude Code。

如何在 Windows 上安裝 Claude Code?

Windows 11 為執行現代 AI 開發工具提供了順暢的環境。只需幾個簡單的設定步驟,即可確保 Claude Code 正常運作,並與你打算使用的服務順利連接。請依照以下說明完成安裝流程,開始無障礙地使用其功能。

步驟 1:使用 PowerShell 安裝 Claude Code

按下 Win + S 並搜尋「PowerShell」以開啟它。將下方的安裝指令複製貼上到 PowerShell 中,然後按「Enter」執行:

irm https://claude.ai/install.ps1 | iex

PowerShell 會自動下載並安裝 Claude Code。請等待安裝流程完成後再繼續。如果你偏好使用 CMD 或 WinGet,官方文件中也提供了其他安裝方式。

使用 PowerShell 安裝 Claude Code

步驟 2:安裝 Git 並啟動 Git Bash

下載並安裝 Windows 版 Git。保留預設安裝設定,以確保 Claude Code 能存取所需的命令列工具並正常運作。

安裝 Git(必要相依套件)

下載 Git 後,開啟安裝程式並以預設設定完成安裝流程。保持安裝路徑不變,如果出現提示,選擇「Visual Studio Code」作為預設編輯器,並確認在 PATH 設定選項中已勾選「Git from the command line and 3rd-party software」。

執行 Git 安裝程式

安裝完成後,從開始選單開啟「Git Bash」以確認 Git 是否正常運作。Git Bash 提供了 Claude Code 在 Windows 上執行指令所需的終端機環境。

啟動 Git Bash

步驟 3:確認 Claude Code 安裝結果

回到 PowerShell 或命令提示字元,執行:

claude --version

如果出現版本號,代表 Claude Code 已成功安裝。如果沒有出現,請繼續進行 PATH 設定步驟。

確認 Claude Code 安裝結果

步驟 4:安裝完成

完成所有步驟後,登入 Claude Code 並完成設定流程。登入後,這個工具就已準備就緒,可以在 Windows 11 上直接透過終端機執行指令並管理 AI 輔助工作流程。

安裝完成

如何在 Mac/MacOS 上安裝 Claude Code?

macOS 內建終端機支援,能以簡潔的方式設定開發工具,讓安裝過程對開發者來說更加順暢一致。安裝 Claude Code 只需依循清楚的終端機操作流程,整個過程井然有序、容易掌握。以下是在 Mac 上安裝 Claude Code 的方法。

步驟 1:透過終端機(curl 指令)安裝 Claude Code

使用 Spotlight 搜尋(Cmd + Space → 輸入「Terminal」)在 Mac 上開啟「終端機」。將下方的安裝指令複製並貼到終端機中,然後按下「Enter」:

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

終端機會自動下載並安裝 Claude Code。請等待安裝完成後再進行下一步。

透過終端機(curl 指令)安裝 Claude Code

步驟 2:確認 Claude Code 安裝完成

請等待安裝過程完全結束。完成後會顯示一則確認訊息,說明 Claude Code 已成功安裝。如果終端機要求進一步設定,請執行建議的指令,將 Claude Code 加入你的 zshrc 設定檔以確保正常存取。

確認 Claude Code 安裝完成

步驟 3:載入環境設定

安裝完成後,執行提供的指令或重新載入你的 shell 設定檔。這個步驟會更新環境變數,讓 Claude Code 能在終端機中全域使用而不會發生路徑問題,確保每次開啟新的終端機視窗時都能順利存取。

載入環境設定

步驟 4:啟動 Claude Code

在終端機中輸入:

claude

按下 Enter 啟動 Claude Code CLI。此時會出現設定畫面,你可以在其中選擇偏好的主題與登入方式,完成最後的設定。

啟動 Claude Code

如何將其他 LLM API 整合進 Claude Code?

在 Claude Code 中使用外部 AI 模型能讓開發更加靈活。連接第三方 LLM API 可讓開發者在同一個環境中執行不同的模型,更有效率地管理任務。舉例來說,具備強大長上下文理解能力與結構化輸出能力的 API,能進一步提升編碼工作流程。以下步驟以 Kimi 為例,示範如何將外部 LLM API 連接至 Claude Code。

步驟 1:從主控台取得 Kimi API 金鑰

要取得 Kimi API 金鑰,請先前往Kimi 開放平台。註冊帳號,或若已有帳號則直接登入。進入主控台後,前往「API Keys」頁面並建立新的 API 金鑰。

從主控台取得 Kimi API 金鑰

步驟 2:略過登入(選用設定腳本)

安裝完成後,先不要啟動 Claude Code。在終端機中執行以下腳本,以略過預設的引導/登入流程:

node --eval " const homeDir = os.homedir(); const filePath = path.join(homeDir, '.claude.json'); if (fs.existsSync(filePath)) { const content = JSON.parse(fs.readFileSync(filePath, 'utf-8')); fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } else { fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }), 'utf-8'); }"

步驟 3:設定環境變數並啟動 Claude Code

設定所需的環境變數,將 Claude Code 連接到 Kimi API。

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/ export ANTHROPIC_API_KEY=Your API Key export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 claude

Windows

在 PowerShell 或系統設定中設定相同的環境變數,然後執行:

$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" claude

如果系統詢問是否使用這個 API 金鑰,請確認繼續。之後依照提示選擇你信任的專案資料夾,完成授權。

使用新設定執行 Claude Code

步驟 4:確認整合狀態

啟動後,執行:

/status

如果 Base URL 顯示為:

https://api.kimi.com/coding/

那就代表整合成功。即使介面上仍顯示 Claude 模型,所有請求實際上都是透過 Kimi Code API 傳送的。

確認整合狀態

使用 Kimi API 的優點

在開發中使用進階 AI 工具,已成為加快工作速度、提升整體程式碼品質的實用做法。Kimi API 為實際專案中的理解、自動化與團隊協作流程提供了強大支援。以下說明它如何幫助開發者更有效率地建構與管理系統。

  • 針對開發任務的多模態內容理解

Kimi API 能理解文字、設計稿、架構圖、流程圖甚至影片等各種形式的輸入內容,並將這些資訊轉換成開發者可直接使用的清晰技術方案,減少手動規劃的工作量,加快從構想到可執行程式碼的轉換。

  • 透過內容重複利用降低成本

Kimi API 支援上下文重複使用,開發者可以延續現有的對話與專案上下文,而不必重複傳送相同的資訊。這有助於減少不必要的 token 用量、降低 API 成本,並讓長期的開發流程更有效率。

  • 自動化重複性的工程流程

常規且重複的編碼任務可以透過腳本或 AI 驅動的工作流程來自動化。這些任務只需簡單的指令即可執行,不必每次都靠人工操作。這樣可以節省時間,並降低日常開發過程中人為出錯的機率。

  • 運用技能與工具打造可自訂的開發流程

Kimi API 支援自訂技能與工具整合,滿足不同的開發需求。團隊可以將自己內部的工具、腳本與系統直接串接進工作流程中,讓開發過程更靈活,也更貼合專案的實際需求。

  • 多 Agent 協作,提升品質與效率

不同的 AI agent 負責不同的角色,例如編碼、測試、架構設計與文件撰寫。這些 agent 可以依序或並行協作以更快完成任務,同時提升開發速度與整體產出品質。

安裝 Claude Code 的疑難排解

在 Windows 或 Mac 上安裝 Claude Code 時,使用者有時會因環境設定、Node.js 版本或網路狀況而遇到一些小的技術問題。這些問題在以 CLI 為基礎的工具中很常見,通常都能解決。以下是最常見的問題及其實際成因說明。

  • 「command not found: claude」

這個錯誤通常代表 Claude Code 未加入系統的 PATH,導致終端機找不到已安裝的執行檔。重新啟動終端機或修正 PATH 設定,通常能快速且穩定地解決這個問題。

  • 驗證失敗,或瀏覽器沒有開啟

當登入流程無法自動開啟瀏覽器時就會發生這種情況,常見於受限系統或遠端環境。此時可能需要改用 API 金鑰手動完成驗證。設定完成後,登入流程就能正常運作,不會再有問題。

  • 安裝過程中出現「Network Error」或逾時

這通常是網路速度慢、防火牆限制或 npm 存取被封鎖所造成。安裝程式可能因此無法連線到安裝所需的伺服器。調整網路設定、代理伺服器配置,或改用其他連線,通常能有效解決這個問題。

  • Claude Code 執行速度緩慢

效能問題通常不是工具本身造成的,而是網路延遲導致。由於 Claude Code 依賴雲端 API 請求,不穩定的網路連線或使用 VPN 都可能拖慢速度。穩定的連線通常能顯著且持續地改善速度。

結語

了解如何在 Windows 或 Mac 上安裝 Claude Code,能幫助你更順暢地開始使用 AI 輔助的開發流程。設定完成後,你就能更有效率地管理編碼任務,在更整合的環境中簡化日常開發工作。若想嘗試更進階或靈活的應用情境,可以試試 Kimi API,進一步擴充這些功能,改善實際的開發流程。

常見問題

安裝完成後如何執行 Claude Code?
只要打開終端機或 PowerShell 並輸入 claude 指令,就能啟動 Claude Code。按下 Enter 即可啟動 CLI 介面。如果安裝正確,設定畫面會出現並引導你完成登入或選擇專案。之後,你就可以直接在終端機中使用各項指令。
使用 Claude Code 需要付費訂閱 Claude 嗎?
並非一定需要付費訂閱,但部分功能可能取決於你的方案或存取權限。基本使用與設定通常在標準存取權限下就能運作,實際情況視設定而定。進階功能或更高的使用額度則可能需要訂閱。建議查看官方 Claude 方案詳情以確認。
Kimi API 如何提升 Claude Code 中的工作流程?
Kimi API 為 Claude Code 增添了進階上下文處理、自動化及多步驟工作流程的支援。它能更有效率地處理長篇輸入、結構化任務與複雜的開發指令,提升速度並減少人工操作。整體而言,它讓工作流程更靈活、更有效率。
相關推薦
Claude Code API 整合:快速連接外部模型
Claude Code API 整合:快速連接外部模型
2026-07-22
Hermes API 整合指南:設定與運作原理
Hermes API 整合指南:設定與運作原理
2026-07-22
快速安裝 OpenCode:Mac 與 Windows 指南
快速安裝 OpenCode:Mac 與 Windows 指南
2026-07-22
Hermes vs OpenClaw:自我進化的 Agent,還是本地 AI 平面?
Hermes vs OpenClaw:自我進化的 Agent,還是本地 AI 平面?
2026-07-22
2026 年讓自動化更輕鬆的 10 個實用 OpenCode 技能
2026 年讓自動化更輕鬆的 10 個實用 OpenCode 技能
2026-07-22