APIMaster.ai

在 Claude Code 中使用 GLM-5.2、GLM-5.3 與 GLM-5.3-Flash:設定與模型切換

使用 APIMaster 在 Claude Code 中設定 GLM。在 Windows、macOS 與 Linux 上配置 settings.json,啟動 claude,以 /model 選擇模型並開始對話。

settings.json 中配置 APIMaster,執行 claude,然後在對話中輸入 /model MODEL_ID 即可使用 GLM。 本文涵蓋的可用 ID 為 glm-5.2glm-5.3glm-5.3-flash。Claude Code 是客戶端;GLM 是回答問題的模型。

開始之前

請先完成環境檢查Claude Code 設定。取得一個餘額充足且可存取所選模型的 APIMaster API 金鑰

claude --version

閘道基底 URL 為 https://apimaster.ai,不含 /v1。Claude Code 會自行附加 /v1/messages

1. 開啟設定目錄

Windows

按下 Win + R,輸入以下路徑並按 Enter:

%USERPROFILE%\.claude

如有需要,請建立該資料夾。開啟或建立 settings.json。確保檔名不是 settings.json.txt

macOS / Linux

在 macOS 上,於 Finder 按 Command + Shift + G 並輸入:

~/.claude

在 Linux 上,使用檔案管理器或編輯器開啟相同目錄。如有需要,請建立它:

mkdir -p ~/.claude

在該目錄中開啟或建立 settings.json。如果您設定了自訂的 Claude Code 設定目錄,請改用該目錄。

2. 編輯 settings.json

Windows、macOS 與 Linux 使用相同的設定。將 YOUR_APIMASTER_API_KEY 替換為您的 APIMaster 金鑰:

{
  "model": "glm-5.3",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

如果檔案已存在,請先備份,再將這些欄位合併到現有的 JSON 物件與 env 物件中。保留您需要的其他設定。不要附加第二個 JSON 物件或重複 env 鍵。JSON 不允許註解或結尾逗號。

一般 Claude Code 指南展示的是權杖認證。本指南使用的是我們整合測試中所驗證的 API 金鑰認證。使用 ANTHROPIC_API_KEY 時,請保持 ANTHROPIC_AUTH_TOKEN 為空,並從其他設定或您的終端機中移除衝突的憑證。此閘道請使用 APIMaster 金鑰。

model 欄位設定啟動時的預設模型。您可以在啟動後選擇其他模型。請將此使用者設定檔保密;不要將真實金鑰提交到共用儲存庫。儲存檔案並重新啟動 Claude Code 以載入新設定。

3. 啟動 Claude Code

在專案目錄中開啟終端機,執行:

claude

完成所有正常的首執行提示,並檢視專案信任提示。起始模型應為 glm-5.3。這是一個正常的互動式工作階段,具備常用的工具與專案設定。

4. 選擇模型並開始對話

Claude Code 對話中,輸入以下其中一個指令並按 Enter:

/model glm-5.2
/model glm-5.3
/model glm-5.3-flash

一次執行一行,選擇您想要的模型。在 Claude Code 確認切換後,傳送一則簡短訊息:

Reply with exactly OK.

收到正常的文字回覆即表示基本連線正常。接著您可以繼續對話,或請它處理您的專案。若要在同一對話中再次切換,請輸入另一個 /model MODEL_ID 指令。

單獨輸入 /model 會開啟模型選擇器。自訂閘道 ID 可能不會出現在其預設清單中。 請改為如上所示輸入完整 ID。斜線指令屬於 Claude Code 內部,而不是 PowerShell 或 Bash。這些模型名稱指的是 GLM 模型,而非 Claude Sonnet 或 Opus。

您也可以在從 終端機 啟動時選擇模型。一次執行一個指令:

claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash

若要明確設定未來工作階段的預設值,請編輯 settings.json 中的 model。啟動旗標、ANTHROPIC_MODEL 環境變數或專案/受管理設定都可能影響所選模型;如果起始模型與您儲存的值不同,請檢查這些項目。

疑難排解

徵狀 檢查項目
401 / 未預期的登入提示 檢查 APIMaster 金鑰、基底 URL 與衝突的認證變數;編輯設定後重新啟動 CLI。
404 使用 https://apimaster.ai,不含 /v1/v1/messages
設定未生效 檢查檔案位置、JSON 是否有效,以及來自終端機、專案或受管理設定的覆寫。
模型未出現在選擇器中 使用確切的 ID 輸入 /model MODEL_ID,或以 claude --model MODEL_ID 啟動。
模型無法使用 / 403 檢查拼字、金鑰允許的模型、帳戶餘額與目前路由的可用性。
unrecognized_model 我們的測試中觀察到自訂 ID 會出現此情況。請檢查實際的回答與工具結果;GLM 未驗證內建 Claude 能力的預設值。
檔案或指令權限被拒 透過一般的權限提示檢視並核准預期的操作。
429 / 5xx / 回覆中斷 保留錯誤訊息、模型 ID、CLI 版本、UTC 時間與請求 ID(如有)以供支援人員處理。

驗證與選用的診斷

記錄的整合測試:2026-09-15 UTCClaude Code 2.1.239Linux。本文列出的所有模型都回傳了預期的文字,並透過工具讀取了本機檔案。這三個模型也都完成了一個小型 Python 修復與測試執行,事後已獨立驗證。Windows 與 macOS 並未包含在這些記錄的測試執行中。

先前的自動化檢查使用裸模式來隔離配置。日常正常使用請遵循上述的 settings.json 與互動式步驟。 裸模式與 --setting-sources "" 會跳過正常整合或已儲存的設定,因此不應將其加入本指南的日常啟動指令。

若要使用已儲存的設定進行快速的非互動式檢查:

claude --model glm-5.3 -p "Reply with exactly OK."

若要檢查工具,請建立包含 FILE_PROBE_739182probe.txt,在該目錄中啟動 Claude Code,並要求它使用工具讀取檔案並回傳其確切內容。確認工具確實執行了。

這些是有範圍限制的整合檢查,並不保證每一項 Claude Code 功能、長時間工作階段的行為或最大上下文。Anthropic 的閘道文件並未正式支援將 Claude Code 路由至非 Claude 模型;本指南說明的是 APIMaster 的整合。

常見問題

我的 Claude 訂閱是否支付這些請求的費用?

否。使用此 APIMaster 配置時,請求使用的是您的 APIMaster 金鑰與餘額。

切換模型後可以繼續對話嗎?

可以,在開啟的對話中使用模型切換指令,並在傳送下一則訊息前等待確認。若要在模型之間進行乾淨的比較,請使用 claude --model MODEL_ID 啟動一個獨立的工作階段。

相關指南與資料來源