GLM 5.2 在 Claude Code 與 Codex 中的完整設定指南與 Reddit 社群最佳實踐

[Aiko]

核心摘要

GLM 5.2 是 Z.ai 推出的開源模型（7560 億參數），透過 Anthropic 相容的 API 端點可直接接入 Claude Code，成本約為 Opus 的 1/5；在 Codex 中則需透過 OpenAI 相容端點配置自訂 provider。Reddit 社群普遍回報其在日常編碼任務（重構、文檔、研究、腳本規劃）上表現接近 Opus 4.7~4.8，但深度推理與邊緣案例仍建議保留 Opus。

---

一、Claude Code 設定 GLM 5.2

1.1 取得 Z.ai API Key

1. 前往 z.ai 註冊並開通 GLM Coding Plan（$16/月起，或按 Token 計費：輸入 $1.40/M、輸出 $4.40/M）
2. 在 API Console 建立 API Key

1.2 修改 settings.local.json（專案級）或 settings.json（用戶級）

專案級設定（推薦，可與 Opus 並存）
在專案根目錄建立 .claude/settings.local.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的_Z.ai_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5.2",
    "CLAUDE_CODE_SUBAGENT_MODEL": "glm-5.2"
  }
}

關鍵細節

• ANTHROPIC_AUTH_TOKEN 放 Z.ai Key，不要填 ANTHROPIC_API_KEY
• 模型名稱加上 [1m] 後綴可啟用 1M context window
• CLAUDE_CODE_AUTO_COMPACT_WINDOW 設為 1000000 配合 1M 上下文

用戶級設定（全域生效）
編輯 ~/.claude/settings.json（macOS/Linux）或 %USERPROFILE%\.claude\settings.json（Windows），只需加入上述 env 區塊即可。

1.3 驗證與切換 Thinking Effort

claude
/status          # 確認 Model 顯示 glm-5.2[1m]，Settings source 指向正確檔案
/effort max      # 切換至 max effort（對應 GLM-5.2 的 max reasoning）

Reddit 實測心得：/effort max 能顯著提升複雜重構任務的穩定性，日常可用 high 平衡速度。

1.4 專案目錄分離策略（社群最佳實踐）

/workspace
  ├── project-glm/     # 含 .claude/settings.local.json → 用 GLM 5.2
  └── project-opus/    # 無 settings.local.json → 回退到 Claude Max 方案

如此可針對任務性質選擇模型：GLM 做大量低風險工作（文檔、測試、研究），Opus 做核心架構決策與邊緣案例。

---

二、Codex 設定 GLM 5.2

Codex 使用 ~/.codex/config.toml 配置自訂 provider，不支援專案級覆蓋 provider 定義（僅限用戶級）。

2.1 基礎 OpenAI 相容端點配置

model = "glm-5.2"
model_provider = "glm_proxy"

[model_providers.glm_proxy]
name = "GLM 5.2 via OpenAI-compatible endpoint"
base_url = "https://api.z.ai/api/coding/paas/v4"
env_key = "GLM_API_KEY"

Shell 中匯出 Key：

export GLM_API_KEY="你的_Z.ai_API_KEY"
codex

2.2 需額外 Header 的進階配置

model = "glm-5.2"
model_provider = "glm_proxy"

[model_providers.glm_proxy]
name = "GLM 5.2 via gateway"
base_url = "https://api.z.ai/api/coding/paas/v4"
env_key = "GLM_API_KEY"
env_http_headers = { "X-Provider-Features" = "GLM_FEATURES" }

export GLM_API_KEY="..."
export GLM_FEATURES="reasoning-preview"
codex

避坑指南（來自 Developers Digest 實測）

• Provider ID 不可使用 openai、ollama、lmstudio（保留字）
• base_url 常見錯誤：重複或遺漏 /v1、/v4 路徑
• 專案內的 .codex/config.toml 無法覆蓋 provider 認證與定義
• model_verbosity 僅在 Responses API 生效，Chat Completions 風格端點不適用

2.3 測試環建議流程

# 1. 唯讀任務驗證連線
codex exec "Read this repo and summarize the test commands. Do not edit files."

# 2. 小範圍編輯驗證工具迴路
codex exec "Add one regression test for the smallest parser edge case. Keep diff minimal."

# 3. 檢查輸出品質
git diff --stat && git diff

---

三、Reddit 社群最佳實踐與經驗彙總

3.1 效能定位共識

維度	GLM 5.2	Opus 4.8
編碼基準分數	接近 Opus 4.7~4.8	基準
單價	~5× 更便宜	基準
Context Window	1M（需 [1m] 後綴）	200K
日常編碼（重構/文檔/測試/研究）	80%+ 任務勝任	全勝任
深度推理/架構決策/邊緣案例	偶爾失焦	更穩健
Sub-agent 協作	表現優異（成本優勢大）	但成本高

r/ClaudeAI u/… (2026-06-17)：「GLM 5.2 是首個在 Claude Code 中感覺像原生的非 Claude 模型，80% 知識工作完全勝任，價格 1/5。」
r/codex u/… (2026-06-16)：「Codex 跑 GLM 5.2 甚至比 Claude Code 更順手，工具迴路穩定度更高。」
r/ZaiGLM u/… (2026-06-26)：「重度 Claude Code 用戶轉用 GLM 5.2 後，token 效率極高，配合 per-directory config 可無縫切換。」

3.2 社群推薦的進階技巧

1. Shell Alias 快速切換（來自 aiengineerguide.com）

   function ccg() {
     local zai_api_key="${ZAI_API_KEY:-你的_key}"
     ANTHROPIC_AUTH_TOKEN="$zai_api_key" \
     ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic" \
     API_TIMEOUT_MS="3000000" \
     CLAUDE_CODE_AUTO_COMPACT_WINDOW="1000000" \
     ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-4.5-air" \
     ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2[1m]" \
     ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2[1m]" \
     claude "$@"
   }
   # 使用：ccg 即啟用 GLM；直接下 claude 用 Opus
   

2. Relay.ai 統一代理（r/ArtificialInteligence 2026-06-25）

   npm i -g @jacob/relayai
   relay-ai providers add   # 互動式加入 Z.ai / OpenAI / Anthropic
   relay-ai codex-app       # 或 claude-app
   

   免去手動改設定檔，支援 .model 熱切換。

3. Cline / OpenClaw / Kilo Code 整合
   選 OpenAI Compatible Provider，Base URL 填 https://api.z.ai/api/coding/paas/v4，Context Window 設 1,000,000。

4. 成本控制策略

   • GLM 做「體力活」（大量檔案讀寫、測試生成、文檔）
   • Opus 做「腦力活」（架構審查、疑難雜症、安全審計）
   • 兩者同專案共存：/glm 與 /opus 目錄分離

3.3 常見問題與解法

症狀	可能原因	解法
Codex 忽略自訂 provider	model_provider 與 table 名稱不符	檢查 TOML key 一致性
認證失敗	env_key 指向未設定的環境變數	export GLM_API_KEY=... 後重啟 shell
404 錯誤	base_url 路徑錯誤（漏/重複 /v4）	對照 Z.ai 官方文件修正
本地模型編輯品質差	模型過小/不支援 agentic coding	改用雲端 GLM 5.2 或更大模型
專案設定不生效	Codex 設計：專案 config 不覆蓋 provider	僅在用戶級 ~/.codex/config.toml 設定

---

四、官方文件與參考資源

• Z.ai 官方 Claude Code 整合文件：https://docs.z.ai/devpack/tool/claude
• Z.ai 模型切換指南：https://docs.z.ai/devpack/latest-model
• Developers Digest：Codex 自訂 Provider 完整教學（含 GLM 5.2 範例）
• Nate Herk YouTube 實測影片：「GLM 5.2 in Claude Code is Blowing My Mind」
• Reddit 討論串：
  • r/ClaudeAI: GLM 5.2 via Claude Code is the first non-Claude model that feels...
  • r/codex: GLM 5.2 in Codex and in Claude, Codex did better!
  • r/ZaiGLM: Heavy Claude Code user switching to GLM-5.2
  • r/ArtificialInteligence: Run Codex and Claude with any model including GLM 5.2

---

五、快速備忘錄（複製即用）

Claude Code .claude/settings.local.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_API_KEY": "",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5.2",
    "CLAUDE_CODE_SUBAGENT_MODEL": "glm-5.2"
  }
}

Codex ~/.codex/config.toml

model = "glm-5.2"
model_provider = "glm_proxy"

[model_providers.glm_proxy]
name = "GLM 5.2 via Z.ai"
base_url = "https://api.z.ai/api/coding/paas/v4"
env_key = "GLM_API_KEY"

啟用 1M Context 與 Max Effort

• 模型名加 [1m] + CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000
• Claude Code 內輸入 /effort max

---

結語：GLM 5.2 讓「模型路由」成為實戰技能——用 GLM 做量，用 Opus 做質，用本地模型做控。上述設定經 Reddit 社群大量實測驗證，可直接套用至生產工作流。若遇邊緣案例，優先檢查 base_url 路徑、環境變數注入時機、以及 /effort 等級是否匹配任務複雜度。