在 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.2、glm-5.3、glm-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 UTC、Claude Code 2.1.239、Linux。本文列出的所有模型都回傳了預期的文字,並透過工具讀取了本機檔案。這三個模型也都完成了一個小型 Python 修復與測試執行,事後已獨立驗證。Windows 與 macOS 並未包含在這些記錄的測試執行中。
先前的自動化檢查使用裸模式來隔離配置。日常正常使用請遵循上述的 settings.json 與互動式步驟。 裸模式與 --setting-sources "" 會跳過正常整合或已儲存的設定,因此不應將其加入本指南的日常啟動指令。
若要使用已儲存的設定進行快速的非互動式檢查:
claude --model glm-5.3 -p "Reply with exactly OK."
若要檢查工具,請建立包含 FILE_PROBE_739182 的 probe.txt,在該目錄中啟動 Claude Code,並要求它使用工具讀取檔案並回傳其確切內容。確認工具確實執行了。
這些是有範圍限制的整合檢查,並不保證每一項 Claude Code 功能、長時間工作階段的行為或最大上下文。Anthropic 的閘道文件並未正式支援將 Claude Code 路由至非 Claude 模型;本指南說明的是 APIMaster 的整合。
常見問題
我的 Claude 訂閱是否支付這些請求的費用?
否。使用此 APIMaster 配置時,請求使用的是您的 APIMaster 金鑰與餘額。
切換模型後可以繼續對話嗎?
可以,在開啟的對話中使用模型切換指令,並在傳送下一則訊息前等待確認。若要在模型之間進行乾淨的比較,請使用 claude --model MODEL_ID 啟動一個獨立的工作階段。