在 ZCode 中使用 Claude:自訂供應商設定

把 AI in IDE 以自訂供應商的方式加入 Z.ai 的 ZCode 桌面應用程式,就能在內建 GLM 模型之外使用 Claude Opus 5.5、Sonnet 5.5 或 Haiku 4.5。

本頁依據 ZCode 的模型接入指南 撰寫。本頁未在 ZCode 中完整實測;Base URL 的值沿用 ZCode 文件中 DeepSeek 範例的慣例,而這些值已在其他用戶端上對 AI in IDE 測試過。

快速設定

  1. 建立 API Key。 打開 API Keys 建立金鑰,渠道選 AWSQ 或 CCMAX。
  2. 新增供應商。 打開 模型設定,在供應商清單底部點 添加供應商。
  3. 填寫欄位。
    • 名稱: AI in IDE
    • Anthropic 端點: https://api.aiinide.com
    • OpenAI 端點: https://api.aiinide.com/v1
    • API Key: 你的控制台金鑰
  4. 新增模型。 點 添加模型,手動輸入 ID:claude-sonnet-5-5、claude-opus-5-5、claude-haiku-4-5-20251001。
  5. 啟用。 打開該供應商的開關,選一個 Claude 模型,送出一段簡短的提示。這筆請求會出現在 Usage。

為什麼兩個端點不一樣

ZCode 的 DeepSeek 範例中,Anthropic 填 https://api.deepseek.com/anthropic,OpenAI 填 https://api.deepseek.com/v1。https://api.deepseek.com/anthropic 也是 DeepSeek 提供給 Claude Code 的值,而 Claude Code 會加上 /v1/messages,所以 ZCode 的 Anthropic 欄位要填不含 /v1 的 API 根路徑。對 AI in IDE 來說,這個根路徑就是主機位址本身。OpenAI 的值包含版本號,所以要填 https://api.aiinide.com/v1。

如果請求以 404 失敗,請確認 Anthropic 端點結尾沒有 /v1。如果以 400 This endpoint requires a CODEX API key 失敗,代表 OpenAI 端點少了 /v1。

設定檔

ZCode 把供應商存在 ~/.zcode/v2/config.json。供應商的 options 只接受 apiKey、baseURL、apiKeyRequired 與 headers;其他欄位會被忽略,且不會報錯。除非需要把設定複製到另一台電腦,否則請使用設定面板。

支援模型

模型 ID渠道適合
claude-opus-5-5AWSQ、CCMAX高難度重構、長時間自動執行
claude-sonnet-5-5AWSQ、CCMAX日常寫程式
claude-haiku-4-5-20251001AWSQ、CCMAX快速修改、便宜的驗證呼叫

ZCode 允許修改自訂供應商模型的上下文視窗;修改會套用到新的工作階段。費率請看模型與定價。

常見問題

ZCode 接 AI in IDE 要用哪個 Base URL?

Anthropic 端點欄位填 https://api.aiinide.com,OpenAI 端點欄位填 https://api.aiinide.com/v1。

這會取代我的 GLM Coding Plan 嗎?

不會。GLM 模型仍使用你的 Z.ai 或 BigModel 帳號。AI in IDE 的請求只會計費到你的 AI in IDE 金鑰。

為什麼調整推理等級後出現 400 錯誤?

ZCode 說明,第三方部署可接受的推理等級可能與官方端點不同。請調低或關閉該模型的推理等級後再試一次。

相關頁面

在 ZCode 中使用 Claude:自訂供應商設定|AI in IDE