輕鬆將外部模型 API 連接到 Claude Code

了解如何為 Claude Code 設定 API 金鑰並整合外部 LLM 服務。本指南以 Kimi API 為例，說明如何連接第三方模型並將其應用於實際的程式開發場景。

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

將不同的 AI 模型整合到開發工作流程中，通常需要額外的配置與相容性設定。Claude Code 提供了一種實用的方式，讓你連接外部模型，並運用強大的 AI 能力提升程式開發工作流程。本指南將說明如何設定整合、簡化通訊，並有效使用 API，以實現更快速、更高效的開發。

什麼是 Claude Code？它是如何運作的？

Claude Code 是一款由 AI 驅動的程式開發工具，旨在幫助開發者更有效率地撰寫、理解和管理程式碼。它透過使用先進的 AI 模型來分析專案、提出解決方案、自動化程式開發任務，並直接在開發環境中協助除錯。透過 Claude Code API 整合，開發者可以將 AI 能力與外部應用程式連接，並自訂工作流程。

為什麼要在 Claude Code 中使用外部 AI 模型？

Claude Code 本身已提供強大的 AI 能力，但開發者可能會連接外部 AI 模型，以滿足特定需求，例如成本控制、模型彈性，以及與現有工作流程的相容性。這讓團隊能夠使用最適合其專案的模型和基礎架構搭配 Claude Code。以下是在 Claude Code 中使用外部 AI 模型的一些好處。

更好的成本控制

外部 AI 模型讓團隊在管理 AI 使用成本方面擁有更多彈性。開發者可以選擇合適的模型、優化 API 使用方式，並在執行大規模或長期程式開發工作流程時減少不必要的支出。

直接的資料整合

外部整合讓 Claude Code 能夠直接從第三方服務提取資訊。這減少了人工操作，並幫助開發者透過 Claude Code API 建立更順暢的工作流程。

工作流程自動化與工具互通性

外部 AI 模型讓 Claude Code 能夠執行諸如觸發工作流程、更新工單，以及連接 API 或資料庫等任務。這有助於自動化重複的開發流程，並提升生產力。

可擴展且企業級的架構

Claude Code 支援與多個 AI 供應商及外部框架的彈性整合。組織可以建立安全、可擴展的工作流程，同時更有效地管理 Claude Code API 的使用。

如何將外部 LLM API 連接到 Claude Code？

將外部 LLM API 與 Claude Code 連接，讓開發者能夠使用額外的 AI 模型，並打造更具彈性的開發工作流程。這個過程通常包括設定 API 連線、新增身分驗證資訊，以及定義外部服務與 Claude Code 之間的通訊方式。

舉例來說，開發者可以透過 API 金鑰將 Kimi API 連接到 Claude Code，在其程式開發環境中使用 Kimi 模型，並根據專案需求自訂 AI 輔助工作流程。

將 Kimi API 整合到 Claude Code 中

將 Kimi API 與 Claude Code 整合，讓開發者能夠在其開發環境中直接運用 Kimi K3 模型先進的程式碼與 Agent 能力。以下是有效使用 Claude Code API 的逐步概述。

取得你的 API 金鑰

前往 Kimi 開放平台並建立一個 API 金鑰。完整金鑰只會顯示一次——請在離開頁面前複製，並儲存到密碼管理器或金鑰管理工具中。

注意：Kimi API 是按量計費的付費服務。首次呼叫前請確保帳戶有可用餘額——可在控制台的 Billing（帳單）中查看或儲值。如果帳戶餘額為零，僅有新的 API 金鑰也無法發起呼叫。

將 Claude Code 與 Kimi API 連接

安裝 Claude Code

如果已安裝 Claude Code，可略過此步驟。使用官方原生安裝程式（Anthropic 建議）：

macOS 和 Linux：

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

Windows（PowerShell）：

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

如果你的網路無法存取該安裝指令碼（例如回傳 403 錯誤），請改用下面的 npm 安裝方式。

也可以將其作為全域 npm 套件安裝（需要 Node.js 22 或更新版本）：

npm install -g @anthropic-ai/claude-code

如果需要先安裝 Node.js：

macOS 和 Linux：

# 安裝 Node.js curl -fsSL https://fnm.vercel.app/install | bash # 開啟一個新終端機，讓 fnm 生效 fnm install 24.3.0 fnm default 24.3.0 fnm use 24.3.0

繼續之前請開啟一個新終端機（或在目前的終端機執行 eval "$(fnm env)"）——否則 fnm install 會出現錯誤 "We can't find the necessary environment variables"。

Windows（PowerShell）：

# 在 Windows 按鈕上按右鍵，點選「終端機」，然後執行： winget install OpenJS.NodeJS Set-ExecutionPolicy -Scope CurrentUser RemoteSigned # 關閉終端機視窗，開啟一個新視窗

安裝 Node.js 後，執行一次初始化腳本。它會將首次啟動引導標記為已完成，讓 Claude Code 直接啟動：

node --eval " const fs = require('fs'); const path = require('path'); const os = require('os'); 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(Object.assign({}, content, { hasCompletedOnboarding: true }), null, 2), 'utf-8'); } else { fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }, null, 2), 'utf-8'); }"

不是首次安裝？先清理舊設定

如果你之前用第三方工具或手動修改過 ~/.claude/settings.json，其 env 欄位中殘留的舊值會覆寫你在終端機中匯出的環境變數，導致新設定不生效，或模型請求被靜默改寫。請先執行以下清理腳本：

node --eval " const fs = require('fs'); const path = require('path'); const os = require('os'); const settingsPath = path.join(os.homedir(), '.claude', 'settings.json'); if (fs.existsSync(settingsPath)) { const content = JSON.parse(fs.readFileSync(settingsPath, 'utf-8')); if (content && typeof content === 'object' && content.env && typeof content.env === 'object') { for (const key of [ 'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL', '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', 'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME', 'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL', ]) { delete content.env[key]; } fs.writeFileSync(settingsPath, JSON.stringify(content, null, 2), 'utf-8'); } }"

該腳本只會從 env 中移除端點、憑證與模型相關的變數，不會影響 settings.json 中的其他設定（如權限、主題等）。

同時檢查 ~/.zshrc、~/.bashrc 等 shell 設定檔中是否有殘留的 ANTHROPIC_* 匯出（Windows 使用者：檢查使用者環境變數），如有請刪除，否則它們會干擾新設定。

在 Claude Code 設定中配置 Kimi

將以下變數寫入 ~/.claude/settings.json 的 env 欄位，然後重新啟動 Claude Code 使其生效。本範例將 HAIKU 檔位設為 kimi-k2.7-code，其餘檔位均設為 kimi-k3[1m]。在 Windows 上，該檔案位於 %USERPROFILE%\.claude\settings.json。

{ "env": { "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic", "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY", "ANTHROPIC_MODEL": "kimi-k3[1m]", "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k3[1m]", "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k3[1m]", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.7-code", "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k3[1m]", "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3[1m]", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000", "CLAUDE_CODE_EFFORT_LEVEL": "max" } }

將 YOUR_MOONSHOT_API_KEY 替換為上面複製的金鑰。如果你的金鑰是在中國平台（platform.moonshot.cn）建立的，請將 ANTHROPIC_BASE_URL 的值改為 https://api.moonshot.cn/anthropic。

注意：settings.json 中的 env 區塊會覆寫終端機中匯出的同名變數。此檔案以明文儲存你的 API 金鑰，請勿提交到 git。

Claude Code 在不同情境（主對話、背景摘要、子 agent 等）使用不同的模型檔位。只配置部分變數會導致對應情境靜默失敗：

變數	用途	未配置時
`ANTHROPIC_BASE_URL`	Kimi 端點位址	請求會發往 Anthropic 官方端點並驗證失敗
`ANTHROPIC_AUTH_TOKEN`	Kimi API 金鑰	回傳 401 驗證錯誤
`ANTHROPIC_MODEL`	主對話模型	出現找不到模型的錯誤
`ANTHROPIC_DEFAULT_OPUS_MODEL` / `ANTHROPIC_DEFAULT_SONNET_MODEL` / `ANTHROPIC_DEFAULT_HAIKU_MODEL` / `ANTHROPIC_DEFAULT_FABLE_MODEL`	各任務檔位使用的模型	對應檔位的任務失敗
`CLAUDE_CODE_SUBAGENT_MODEL`	子 agent 模型	子 agent 任務失敗或明顯退化
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	觸發自動壓縮的上下文視窗	太小會過早壓縮並遺失上下文；太大會導致上下文長度錯誤
`CLAUDE_CODE_EFFORT_LEVEL`	推理強度	設為 `max`；較低的值可能降低複雜任務的品質

模型與 Thinking 行為

可用的 Kimi 模型在 Claude Code 中的行為有所不同：

模型	Thinking 模式	說明
`kimi-k3`（預設）	預設開啟，可關閉	開箱即用，無需額外設定
`kimi-k2.7-code`	強制開啟，無法關閉	使用前必須在 Claude Code 中啟用 Thinking（macOS 按 `Option+T`，Windows/Linux 按 `Alt+T`）
`kimi-k2.6`	可選	適合對延遲敏感的簡單任務

在 Thinking 關閉時，對 kimi-k2.7-code 的請求會被拒絕，錯誤訊息為 400 invalid thinking: only type=enabled is allowed for this model。

驗證設定

設定完成後，先用 curl 驗證端點與 API 金鑰：

curl https://api.moonshot.ai/anthropic/v1/messages \ --header "Authorization: Bearer YOUR_MOONSHOT_API_KEY" \ --header "Content-Type: application/json" \ --data '{"model": "kimi-k3", "max_tokens": 1, "messages": [{"role": "user", "content": "hi"}]}'

回傳正常的 JSON 回應表示端點與憑證都可用；回傳 401 表示 API 金鑰無效或與平台不符。確認無誤後，啟動 Claude Code 並輸入 /status：

Base URL 應顯示 https://api.moonshot.ai/anthropic
Model 應顯示 kimi-k3[1m]

將 Claude Code 與 Kimi API 連接

Claude Code 的 /model 選單會顯示你已設定的模型。最後，傳送任意訊息（例如 hello）。收到正常回覆即確認端到端設定可用。

透過這項整合，你可以在 Claude Code 中充分運用 Kimi API，結合即時 AI 輔助程式撰寫、自動化與多 agent 能力，用於開發專案。

使用 Kimi API 的優勢

將 Kimi API 與 Claude Code 整合，可解鎖強大的 AI 輔助開發功能。相較於單獨使用 Claude Code，Kimi API 為需要持續 AI 協助的團隊提供更具成本效益的選擇，有助於降低 API 支出，同時維持高效的開發流程。

跨大型程式碼庫的擴展情境理解

Kimi API 可以一次分析大量程式碼與專案資料。這讓 Claude Code 能夠理解檔案、模組與元件之間的關係，讓大型專案更容易管理。

更快、更清晰的程式庫分析

Kimi 能快速解讀文件、技術筆記與程式庫結構。開發者無需逐一檢查每個檔案即可取得關鍵資訊，提升 Claude Code API 在專案理解上的使用效率。

更具成本效益的 AI 輔助開發

Kimi API 在能力與成本效益之間取得平衡。團隊可以在 Claude Code 中運用 AI 支援，而不會超出預算，是持續開發流程的實用選擇。

加快跨專案的資訊檢索

Kimi 能從大型程式碼庫中找出相關模式、參考資料與資料。這減少了搜尋時間，讓開發者能更專注於建構功能與提升軟體效率。

更智慧的工作流程自動化與任務支援

Kimi API 可協助處理重複性的工程任務，例如程式碼生成與內容審查。透過與 Claude Code 整合，團隊能長期維持更順暢、更一致的工作流程。

疑難排解

搜尋本機工作區時出現 400 Bad Request

如果 Claude Code 在搜尋你的本機工作區時出現 400 Bad Request 錯誤，這個問題通常與 agent 的網頁或搜尋工具的相容性問題有關。若要解決此問題，請在啟動 Claude Code CLI 之前停用工具搜尋功能。

適用於 macOS/Linux：

export ENABLE_TOOL_SEARCH=false

適用於 Windows（PowerShell）：

$env:ENABLE_TOOL_SEARCH="false"

也可以把 "ENABLE_TOOL_SEARCH": "false" 加入 settings.json 的 env 區塊中，讓該設定長期生效。

設定變數後，重新啟動 Claude Code，再嘗試重新執行你的工作流程。這項調整有助於避免與搜尋相關的衝突，讓 Kimi API 整合更順暢地運作。

401 驗證錯誤

檢查 ANTHROPIC_AUTH_TOKEN 是否為有效的 Kimi API 金鑰，並確認 YOUR_MOONSHOT_API_KEY 已替換為你的金鑰；
確保 ANTHROPIC_BASE_URL 與建立金鑰的平台一致——請在上文「取得你的 API 金鑰」所連結的平台建立金鑰，並使用本頁所示的端點；
如果之前設定過 ANTHROPIC_API_KEY，請將其移除，避免與 ANTHROPIC_AUTH_TOKEN 同時存在時發生衝突。

找不到模型

檢查每個模型變數的拼寫（kimi-k3[1m]），確保沒有多餘的空格或引號。

背景任務或子 agent 錯誤

通常是 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 或 CLAUDE_CODE_SUBAGENT_MODEL 未設定，導致對應情境請求了 Kimi 端點無法辨識的模型名稱。請按照上文的設定參考補齊這些變數。

修改未生效

檢查 ~/.claude/settings.json 的 env 欄位中是否有殘留舊值，如有則執行上文「不是首次安裝？」中的清理腳本；
檢查 ~/.zshrc、~/.bashrc 等 shell 設定檔中是否有殘留的 ANTHROPIC_* 匯出；
修改 settings.json 後重新啟動 Claude Code。

ANTHROPIC_AUTH_TOKEN 優先於已儲存的登入狀態，因此通常無需任何操作。輸入 /status 確認目前生效的憑證來源；執行 /logout 可清除已儲存的登入。

Claude Code 如何在工作流程中協助開發者？

Claude Code 作為一個能理解、規劃並執行複雜工程任務的智慧助理，大幅提升開發生產力。它不僅止於簡單的程式碼生成，更成為整個開發生命週期的一部分。以下說明它如何在工作流程中協助開發者。

端對端任務執行

Claude Code 可以透過分析你的程式碼庫、規劃解決方案、編輯多個檔案，以及執行建置或測試指令，來處理完整的開發任務。這讓 Claude Code API 的使用更為強大，能實現全流程自動化，而非僅是孤立的程式碼片段。

智慧文件說明

它可作為新舊程式碼庫的智慧引導助理。Claude 會解釋函式、找出邊界情況，並協助開發者在進行變更前理解架構，大幅縮短上手時間。

自動化測試與邊界情況偵測

Claude Code 可以根據既有的專案模式生成測試，並找出缺失的測試覆蓋範圍。它也會執行測試套件並協助修正錯誤，提升程式碼可靠性與品質保證。

Git 與發布管理

它與 Git 工作流程整合，管理提交（commit）、解決合併衝突並建立結構化的合併請求（pull request）。這有助於團隊維持更整潔的版本控制與更順暢的發布週期。

工具整合（MCP）

透過 Model Context Protocol（MCP），Claude Code 能與 GitHub、Jira、Slack 及 Figma 等工具連接。這將 Claude Code API 的能力擴展至更廣泛的開發與協作生態系統。

動態工作流程

對於除錯或遷移等複雜任務，Claude Code 可以將工作拆分成多個子任務，並執行多個子 agent。接著它會將結果整合成統一的輸出，提升大型開發專案的效率。

結語

Claude Code API 協助開發者將 Kimi K3 這類強大的 AI 工具整合到工作流程中。它能提供即時上下文、自動化與更智慧的任務管理，進而提升效率、減少錯誤。憑藉端到端執行與無縫的工具整合，Claude Code 讓開發流程更加順暢。使用 Claude Code API，團隊可以更快速、更有信心地處理複雜專案。

將 Claude Code 與 Kimi API 連接

常見問題

是的，Claude Code 透過其 API 整合支援多模型設定。你可以連接多個模型，包括 Kimi K3，並管理它們在不同任務中的互動。這種彈性使 Claude Code API 在大型專案中的應用更加多樣化。

Claude Code 可以與 GitHub、Jira、Slack、Figma 以及自訂 API 等多種服務整合。這些連接讓開發者能夠自動化工作流程、同步資料，並透過 Claude Code API 金鑰擴展 AI 能力。

是的，你可以隨時在 Claude Code 中更換或更新 AI 模型。透過更新 API 金鑰或變更模型設定，開發者可以順暢地切換到更新或不同的模型，以提升效能。

如果外部 API 失效，Claude Code 會停止相關操作並提供錯誤回饋。開發者可以重試請求、切換到備用模型，或調整設定，藉由 Claude Code API 維持工作流程的連續性。

輕鬆將外部模型 API 連接到 Claude Code

什麼是 Claude Code？它是如何運作的？

為什麼要在 Claude Code 中使用外部 AI 模型？