Compare commits

...

4 Commits

Author SHA1 Message Date
claude_dev a1972c7ff9 docs: 更新 v0.2 设计文档中所有旧端点为 GLM Coding Plan 端点
- 统一使用 https://api.z.ai/api/coding/paas/v4
- 移除所有旧的 api.zhipuai.cn 和 open.bigmodel.cn 引用
2026-06-30 08:18:42 +08:00
claude_dev 6d6ef3c319 docs: 更新 GLM Coding Plan 端点和兼容性说明
- 修正端点为: https://api.z.ai/api/coding/paas/v4
- 验证 curl 直接调用成功
- 记录 Codex/Gemini CLI 不兼容问题
- 推荐直接使用 Claude Code + GLM-5.2
2026-06-30 08:07:09 +08:00
claude_dev 5810deb6ec docs: 更新 v0.2 设计 - 修正 GLM-5.2 端点,gotty 替换为 ttyd
- GLM-5.2 端点修正为: https://open.bigmodel.cn/api/paas/v4
- gotty 替换为 ttyd (C 实现,性能更好)
- 验证端点正确,API Key 有效但余额不足
- 更新实施状态: 环境准备完成
2026-06-30 08:03:41 +08:00
claude_dev b23773e9ad docs: 更新 v0.2 设计文档实施状态
- 添加第13节:实施状态
- 标记已完成组件:Go, CCB, Codex CLI, Gemini CLI, tmux
- 记录待解决问题:gotty 安装失败、GLM-5.2 API 连接问题
- 记录待验证项和替代方案
2026-06-29 23:50:33 +08:00
+117 -19
View File
@@ -85,8 +85,8 @@ CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模
| 组件 | Base URL | 环境变量 |
|------|----------|---------|
| **Codex CLI** | `https://api.zhipuai.cn/v1` | `OPENAI_API_BASE` |
| **Gemini CLI** | `https://open.bigmodel.cn/api/coding/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,11 +94,13 @@ CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模
**环境变量**:
```bash
# Codex
export OPENAI_API_KEY="6903e83faf454106aa7529c9e18e2ea5.gYMSjWwk1XDN0U5h"
# Codex (GLM Coding Plan)
export OPENAI_API_BASE="https://api.z.ai/api/coding/paas/v4"
export OPENAI_API_KEY="你的智谱API_Key"
# Gemini
export OPENROUTER_API_KEY="4ae9f90df9514aa8ba61a5ee885d0dab.NIr7DfGQ8rdMN0Cd"
# Gemini (GLM Coding Plan)
export OPENROUTER_BASE_URL="https://api.z.ai/api/coding/paas/v4"
export OPENROUTER_API_KEY="你的智谱API_Key"
```
---
@@ -145,13 +147,13 @@ codex --version
创建 `~/.codex/config.toml`:
```toml
[profile.default]
openai_base_url = "https://api.zhipuai.cn/v1"
openai_base_url = "https://api.z.ai/api/coding/paas/v4"
model = "glm-5.2"
```
设置环境变量:
```bash
export OPENAI_API_BASE="https://api.zhipuai.cn/v1"
export OPENAI_API_BASE="https://api.z.ai/api/coding/paas/v4"
export OPENAI_API_KEY="6903e83faf454106aa7529c9e18e2ea5.gYMSjWwk1XDN0U5h"
```
@@ -176,27 +178,36 @@ npm install
**配置 GLM-5.2**:
```bash
export OPENROUTER_BASE_URL="https://open.bigmodel.cn/api/coding/paas/v4"
export OPENROUTER_BASE_URL="https://api.z.ai/api/coding/paas/v4"
export OPENROUTER_API_KEY="4ae9f90df9514aa8ba61a5ee885d0dab.NIr7DfGQ8rdMN0Cd"
# 启动
npm start
```
#### 1.4 安装 gotty
#### 1.4 安装 ttyd (gotty 替代方案)
```bash
brew install yudai/gotty/gotty
brew install ttyd
```
**配置 gotty**:
**配置 ttyd**:
创建 `~/.gotty`:
创建 `~/.ttyd`:
```
address = "0.0.0.0"
port = "8088"
permit_write = true
enable_basic_auth = false
permit-write = true
enable-basic-auth = false
```
**使用方式**:
```bash
# 共享 tmux 会话
ttyd -p 8088 tmux attach -t sanguo_dev
# 或共享新 shell
ttyd -p 8088 bash
```
---
@@ -363,11 +374,11 @@ Claude: Git 提交
```bash
# Codex (GLM-5.2)
export OPENAI_API_BASE="https://api.zhipuai.cn/v1"
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/coding/paas/v4"
export OPENROUTER_BASE_URL="https://api.z.ai/api/coding/paas/v4"
export OPENROUTER_API_KEY="你的智谱API_Key"
```
@@ -477,13 +488,100 @@ gotty -a 0.0.0.0 -p 8089 tmux attach -t sanguo_dev
- [videotext 方案调查报告](./02-videotext-investigation-report.md)
- [GLM-5.2 - 智谱AI开放文档](https://docs.bigmodel.cn/cn/guide/models/text/glm-5.2)
- [GoTTY GitHub](https://github.com/yudai/gotty)
- [webtmux GitHub](https://github.com/chrismccord/webtmux)
- [ttyd GitHub](https://github.com/tsl0922/ttyd)
- [CCB GitHub](https://github.com/SeemSeam/claude_codex_bridge)
---
## 13. 实施状态
### 已完成
| 组件 | 状态 | 说明 |
|------|------|------|
| **Go** | ✅ 已安装 | v1.26.4 darwin/arm64 |
| **CCB** | ✅ 已安装 | v8.0.4, via npm @seemseam/ccb |
| **Codex CLI** | ✅ 已安装 | v0.142.4, via npm @openai/codex |
| **Gemini CLI** | ✅ 已安装 | 定制版 (feature/openrouter-support分支) |
| **tmux** | ✅ 已安装 | 系统包管理器 |
| **ttyd** | ✅ 已安装 | v1.7.7, via brew (gotty 替代方案) |
### 已验证
| 项目 | 状态 | 说明 |
|------|------|------|
| **GLM Coding Plan 端点** | ✅ 正确且可用 | `https://api.z.ai/api/coding/paas/v4/chat/completions` |
| **API Key 有效性** | ✅ 有效 | Coding Plan Key 可正常调用 |
### 配置更新
**GLM Coding Plan 正确端点**:
```bash
# Codex CLI (OpenAI 兼容)
export OPENAI_API_BASE="https://api.z.ai/api/coding/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 使用方式**:
```bash
# 共享 tmux 会话
ttyd -p 8088 tmux attach -t sanguo_dev
# 访问: http://YOUR_LAN_IP:8088
```
---
**文档版本**: v0.2
**最后更新**: 2026-06-30
**作者**: Claude Dev
**审核状态**: 待审核
**实施状态**: 环境准备完成 ⚠️ - 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
**作者**: Claude Dev
**审核状态**: 待审核
**实施状态**: 进行中 - 环境准备完成,API 连接待排查