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

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

閱讀時長：10分鐘更新於：2026-09-28

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.將下方安裝指令複製並貼到 PowerShell 中，再按下「Enter」執行：

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

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

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

下載並安裝適用於 Windows 的 Git.請保留預設安裝設定，確保 Claude Code 能存取所需的命令列工具並正常執行.

下載 Git 後，開啟安裝程式並以預設設定完成安裝.請勿變更安裝路徑；若系統提示，請選擇「Visual Studio Code」作為預設編輯器，並確認在 PATH 設定選項中選取「Git from the command line and 3rd-party software」.

安裝完成後，從開始功能表開啟「Git Bash」，確認 Git 是否正常運作.Git Bash 提供 Claude Code 在 Windows 上執行指令所需的終端機環境.

步驟 3：驗證 Claude Code 安裝

回到 PowerShell 或命令提示字元，並執行：

claude --version

若顯示版本號，即表示 Claude Code 已成功安裝.若未顯示，請繼續進行 PATH 設定步驟.

步驟 4：完成安裝

完成所有步驟後，登入 Claude Code 並完成設定流程。登入後，即可直接在 Windows 11 終端機中使用此工具執行指令及管理 AI 輔助工作流程。

如何在 Mac/macOS 上安裝 Claude Code？

macOS 透過內建的終端機支援，提供簡潔易用的開發工具設定方式，讓開發人員能順暢且一致地完成安裝。設定 Claude Code 時，只需依照清楚的終端機操作流程，即可讓所有項目保持井然有序、易於管理。以下說明如何在 Mac 上安裝 Claude Code。

步驟 1：透過終端機（curl 指令）安裝 Claude Code

使用 Spotlight 搜尋在 Mac 上開啟「終端機」（Cmd + Space → 輸入「Terminal」）。將以下安裝指令複製並貼到終端機中，再按下 Enter：

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

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

步驟 2：確認 Claude Code 已安裝

請等待安裝程序完全結束。完成後，畫面會顯示確認訊息，表示 Claude Code 已成功安裝。若終端機要求進行額外設定，請執行建議的指令，將 Claude Code 加入 zshrc 設定檔，以確保能正常存取。

步驟 3：載入環境設定

安裝完成後，執行提供的指令或重新載入 shell 設定檔。此步驟會更新環境變數，讓 Claude Code 能在終端機中全域運作，避免發生路徑問題。之後每次開啟新的終端機視窗時，都能順利使用。

步驟 4：啟動 Claude Code

在終端機中輸入：

claude

按下 Enter 啟動 Claude Code CLI。設定畫面隨即出現，您可選擇偏好的主題及登入方式，完成最後設定。

如何將其他 LLM API 整合至 Claude Code？

搭配外部 AI 模型使用 Claude Code，可讓開發方式更具彈性。連接第三方 LLM API 後，開發人員可在同一環境中執行不同模型，更有效率地管理工作。例如，具備強大長上下文理解與結構化輸出能力的 API，可進一步改善程式開發工作流程。以下將以 Kimi 為例，說明如何將外部 LLM API 連接至 Claude Code。

步驟 1：取得 Kimi Code API 金鑰

注意：本指南使用的 api.kimi.ai/coding/ 端點屬於 Kimi Code 會員權益。建立金鑰前，請確認您的 Kimi 會員資格仍有效，且已啟用 Kimi Code 權益；免費帳戶的金鑰會在啟動時遭拒。

前往 Kimi Code Console，點選 建立 API 金鑰，輸入名稱並確認，接著立即複製金鑰——完整金鑰只會顯示一次。可用模型及上下文視窗取決於您的會員方案（例如，舊版 Andante 方案使用具備 1M 上下文的 kimi-for-coding；Plus/Moderato 方案可使用 k3-256k；Pro/Allegretto 及以上方案可使用具備 1M 上下文的 k3 或高速版本）。

將 Claude Code 連接至 Kimi API

步驟 2：略過登入（選用設定指令碼）

安裝完成後，請先不要啟動 Claude Code。在終端機中執行以下指令碼，以略過預設的初始設定／登入流程，並清除舊有設定。此指令碼會啟用第三方模型支援與快速模式，並從 ~/.claude/settings.json 移除過時的端點、認證資訊及模型項目（其中殘留的項目會覆寫終端機中匯出的環境變數）：

node --eval " // enable third party model support and fast mode const claudeJsonFilePath = path.join(os.homedir(), '.claude.json'); if (fs.existsSync(claudeJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8')); fs.writeFileSync(claudeJsonFilePath, JSON.stringify(Object.assign({}, content, { penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), null, 2), 'utf-8'); } else { fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } // delete old endpoint, credential and model id const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json'); if (fs.existsSync(claudeSettingsJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8')); if (typeof content === 'object' && typeof content.env === 'object') { for (const element of [ 'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME', 'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME', 'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME', 'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME', 'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL', ]) { delete content.env[element]; } fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8'); } }"

此指令碼需要 Node.js（可用 node --version 檢查；若找不到此指令，請先從 nodejs.org 安裝 LTS 版本）。成功時不會輸出任何訊息，這是正常現象。此外，請檢查 ~/.zshrc、~/.bashrc 等 shell 設定檔中是否有過時的 ANTHROPIC_* 匯出設定（Windows 使用者請檢查使用者環境變數），並將其刪除，否則會干擾新設定。

步驟 3：設定 API 存取並啟動 Claude Code

有兩種設定方式——請擇一使用，不要混用。方法 1 會寫入 ~/.claude/settings.json，永久生效；方法 2 僅在目前終端機中匯出變數，僅對該工作階段有效。以下範例使用 k3-256k（256K 上下文）；若您的方案包含具備 1M 上下文的 k3，請將每個模型值替換為 k3[1m]，並將兩個上下文值都設為 1048576。

方法 1：寫入 settings.json（建議使用，永久生效）

將以下內容寫入 ~/.claude/settings.json 的 env 欄位（Windows：%USERPROFILE%\.claude\settings.json；若檔案不存在，請建立檔案），然後重新啟動 Claude Code 使設定生效：

{ "env": { "ANTHROPIC_BASE_URL": "https://api.kimi.ai/coding/", "ANTHROPIC_API_KEY": "Your API Key", "ANTHROPIC_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k", "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k", "CLAUDE_CODE_EFFORT_LEVEL": "high", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144", "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144" } }

將 Your API Key 替換為您在步驟 1 複製的金鑰。此檔案會以純文字儲存金鑰，請勿將其提交至 git。請注意，settings.json 中的 env 區塊會覆寫終端機中匯出的同名變數。

方法 2：終端機環境變數（僅限目前工作階段）

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.ai/coding/ export ANTHROPIC_API_KEY="Your API Key" export ANTHROPIC_MODEL="k3-256k" export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_EFFORT_LEVEL=high export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144 claude

Windows

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

$env:ANTHROPIC_BASE_URL="https://api.kimi.ai/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:ANTHROPIC_MODEL="k3-256k" $env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_EFFORT_LEVEL="high" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" $env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144" claude

將 Your API Key 替換為您在步驟 1 複製的金鑰。若只設定部分模型變數，對應的情境（主要對話、背景摘要、子 agent）會無提示地失敗，因此請保留完整設定。

若系統詢問是否使用此 API 金鑰，請確認以繼續。接著依照提示選取您信任的專案資料夾，完成授權。

步驟 4：驗證整合狀態

啟動後，執行：

/status

如果 Base URL 顯示：

https://api.kimi.ai/coding/

即表示整合成功。即使介面仍顯示 Claude 模型，所有請求都會經由 Kimi Code API 路由。

使用 Kimi API 的優點

在開發中使用進階 AI 工具，已成為加快工作速度並提升整體程式碼品質的實用途徑。Kimi API 為實際專案中的理解、 автомат化與團隊協作流程提供有力支援。以下說明它如何協助開發人員更有效率地建置與管理系統。

適用於開發任務的多模態情境理解

Kimi API 能理解文字、設計稿、架構圖、流程圖，甚至影片等不同類型的輸入，並將這些資訊轉換為開發人員可直接使用的清楚技術方案。這有助於以更少的人工規劃，將想法轉化為可運作的程式碼。

透過重複使用情境降低成本

Kimi API 支援重複使用情境，讓開發人員能延續既有對話與專案情境，而不必反覆傳送相同資訊。這有助於減少不必要的 token 使用量、降低 API 成本，並讓長期開發流程更有效率。

自動化重複性的工程流程

例行且重複的程式開發工作可透過指令碼或 AI 驅動的流程自動化。這些工作只需簡單指令即可執行，不必每次都投入人工操作。這能節省時間，並降低日常開發流程中人為錯誤的機率。

透過 Skills 與工具自訂開發流程

Kimi API 支援因應不同開發需求的自訂 Skills 與工具整合。團隊可將自有的內部工具、指令碼與系統直接串接至工作流程中，讓開發流程更具彈性，也更貼合專案需求。

多 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 存取遭封鎖所致。安裝程式在設定期間可能無法連線至所需伺服器。調整網路設定、Proxy 設定或切換連線，通常能有效解決問題。

Claude Code 執行速度緩慢

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

結論

學會在 Windows 或 Mac 上安裝 Claude Code，可讓您更順利地開始使用 AI 輔助開發流程。完成設定後，您能更有效率地管理程式開發工作，並在更整合的環境中簡化日常開發作業。如有更進階或更具彈性的使用需求，可嘗試 Kimi API，擴展這些能力並改善實際開發流程。

將 Claude Code 連接至 Kimi API

常見問題

開啟終端機或 PowerShell，輸入 claude 指令即可啟動 Claude Code。按下 Enter 開啟 CLI 介面。若安裝正確，系統會顯示設定畫面，引導您登入或選擇專案。之後即可直接在終端機中使用指令。

不一定需要付費訂閱，但部分功能可能取決於您的方案或存取層級。依設定而定，基本使用與設定通常可透過標準存取權限完成。進階功能或較高額度可能需要訂閱。建議查看 Claude 官方方案詳細資訊以確認。

Kimi API 為 Claude Code 加入進階脈絡處理、自動化及多步驟工作流程支援。它能更有效率地處理長篇輸入、結構化任務與複雜的開發指令，提升速度並減少程式開發時的手動操作。整體而言，讓工作流程更具彈性且更有效率。