docs: 更新 GLM Coding Plan 端点和兼容性说明

- 修正端点为: https://api.z.ai/api/coding/paas/v4
- 验证 curl 直接调用成功
- 记录 Codex/Gemini CLI 不兼容问题
- 推荐直接使用 Claude Code + GLM-5.2

docs/design/02-design-v0.2.md

@@ -85,8 +85,8 @@ CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模
 
 | 组件 | Base URL | 环境变量 |
 |------|----------|---------|
-| **Codex CLI** | `https://open.bigmodel.cn/api/paas/v4` | `OPENAI_API_BASE` |
-| **Gemini CLI** | `https://open.bigmodel.cn/api/paas/v4` | `OPENROUTER_BASE_URL` |
+| **Codex CLI** | `https://api.z.ai/api/coding/paas/v4` | `OPENAI_API_BASE` |
+| **Gemini CLI** | `https://api.z.ai/api/coding/paas/v4` | `OPENROUTER_BASE_URL` |
 
 ### 3.3 API Key 配置
 
@@ -94,12 +94,12 @@ CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模
 
 **环境变量**:
 ```bash
-# Codex (GLM-5.2)
-export OPENAI_API_BASE="https://open.bigmodel.cn/api/paas/v4"
+# Codex (GLM Coding Plan)
+export OPENAI_API_BASE="https://api.z.ai/api/coding/paas/v4"
 export OPENAI_API_KEY="你的智谱API_Key"
 
-# Gemini (GLM-5.2)
-export OPENROUTER_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
+# Gemini (GLM Coding Plan)
+export OPENROUTER_BASE_URL="https://api.z.ai/api/coding/paas/v4"
 export OPENROUTER_API_KEY="你的智谱API_Key"
 ```
 
@@ -510,25 +510,21 @@ gotty -a 0.0.0.0 -p 8089 tmux attach -t sanguo_dev
 
 | 项目 | 状态 | 说明 |
 |------|------|------|
-| **GLM-5.2 端点** | ✅ 正确 | `https://open.bigmodel.cn/api/paas/v4/chat/completions` |
-| **API Key 有效性** | ⚠️ 余额不足 | 端点正确，Key 有效，但账户余额不足 |
-
-### 待充值
-
-| Key | 状态 |
-|-----|------|
-| Codex Key (6903e8...) | ❌ 余额不足 |
-| Gemini Key (4ae9f9...) | ❌ 余额不足 |
+| **GLM Coding Plan 端点** | ✅ 正确且可用 | `https://api.z.ai/api/coding/paas/v4/chat/completions` |
+| **API Key 有效性** | ✅ 有效 | Coding Plan Key 可正常调用 |
 
 ### 配置更新
 
-**GLM-5.2 正确端点**:
+**GLM Coding Plan 正确端点**:
 ```bash
-# Codex CLI
-export OPENAI_API_BASE="https://open.bigmodel.cn/api/paas/v4"
+# Codex CLI (OpenAI 兼容)
+export OPENAI_API_BASE="https://api.z.ai/api/coding/paas/v4"
 
-# Gemini CLI
-export OPENROUTER_BASE_URL="https://open.bigmodel.cn/api/paas/v4"
+# Gemini CLI (OpenAI 兼容)
+export OPENROUTER_BASE_URL="https://api.z.ai/api/coding/paas/v4"
+
+# Claude Code (Anthropic 兼容)
+export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
 ```
 
 **ttyd 使用方式**:
@@ -545,7 +541,44 @@ ttyd -p 8088 tmux attach -t sanguo_dev
 **最后更新**: 2026-06-30
 **作者**: Claude Dev
 **审核状态**: 待审核
-**实施状态**: 环境准备完成 ✅ - 组件已安装，API 端点已验证，待充值测试
+**实施状态**: 环境准备完成 ⚠️ - GLM Coding Plan 端点验证成功，但 Codex/Gemini CLI 不兼容
+
+## 14. GLM Coding Plan 兼容性说明
+
+### 验证结果
+
+| 组件 | 端点 | 状态 | 说明 |
+|------|------|------|------|
+| **curl 直接调用** | `https://api.z.ai/api/coding/paas/v4/chat/completions` | ✅ 成功 | 返回完整响应 |
+| **Codex CLI** | 同上 | ❌ 失败 | 需要 `/responses` WebSocket 端点 |
+| **Gemini CLI** | 同上 | ❌ 失败 | 使用 OpenRouter 格式，不兼容 |
+
+### 推荐方案
+
+**直接使用 Claude Code + GLM-5.2**（无需 CCB 桥接）：
+
+```json
+// ~/.claude/settings.json
+{
+  "env": {
+    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]"
+  }
+}
+```
+
+**Claude Code GLM-5.2 端点**：
+- Anthropic 兼容：`https://api.z.ai/api/anthropic`
+- 使用 1M 上下文：模型名称加 `[1m]` 后缀
+
+### CCB 替代方案
+
+如果仍需多 AI 协作，可考虑：
+1. 使用支持 OpenAI 标准格式的其他 CLI 工具
+2. 直接通过 HTTP API 调用 GLM-5.2
+3. 等待 Codex/Gemini CLI 支持更多端点格式
 
 **文档版本**: v0.2
 **最后更新**: 2026-06-29