第16章 在 Orca ADE 中使用 GLM-5.2
在 Orca ADE 中使用 GLM-5.2 配置 Claude Code 及其他 CLI agent harness,以便在 Orca worktree 中运行 GLM-5.2。
GLM-5.2 通过你已在使用 agent harness 在 Orca 中工作。只需在 Claude Code、OpenCode、Cline、Kilo Code、Roo Code、Droid、OpenClaw 或其他 CLI agent 中配置 GLM-5.2,然后从 Orca 的 picker 中启动该 agent 即可。
Orca 负责提供隔离的 worktree、终端面板、浏览器标签页、审查流程及会话管理。你的 Z.ai CodePlan 订阅和 agent 配置则负责提供模型访问权限。
Claude Code Claude Code 会从 ~/.claude/settings.json 读取模型覆盖设置。要在 Orca 中使用 GLM-5.2:
打开 ~/.claude/settings.json。 添加或更新下方的 env 块。 重启 Orca 中的 Claude Code 会话,以加载新环境。 在 Claude Code 内运行 /status,确认当前激活的模型。
{ "env": { "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]" } } 如需使用 GLM-5.2 的 1M 上下文变体,请添加 [1m] 后缀。同时保持 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设为 1000000,使 Claude Code 的 compaction 窗口与该上下文大小匹配。如果 Claude Code 提示 [1m] 模型不存在,请更新 Claude Code 后重试。
对于编码任务,Z.ai 建议通过 /effort 将 Claude Code 的 effort 设为 max。Claude Code 中较低的 effort 设置映射为 GLM-5.2 的 high effort,而 xhigh、max 和 ultracode 则映射为 GLM-5.2 的 max effort。
OpenCode、Cline、Kilo Code、Roo Code 和 Droid 对于暴露 OpenAI 兼容 provider 的 agent harness:
在 Orca 内外打开 harness 设置。 选择 OpenAI 兼容 provider 选项,若 harness 提供 Z.ai provider 选项,则选择该项。 将 base URL 设为 https://api.z.ai/api/coding/paas/v4。 填入你的 Z.ai API key。 将自定义模型名设为 glm-5.2。 如果 harness 暴露了该字段,将 context window 大小设为 1000000。 除非 harness 明确文档说明该 provider 路径支持图片,否则禁用图片支持。
保存后,从 Orca 的 agent picker 中启动该 harness。Orca 将在选定的 worktree 中运行配置好的 CLI。
OpenClaw 若 OpenClaw 无法直接从其 provider 模型列表中选择 GLM-5.2,请在 ~/.openclaw/openclaw.json 中手动添加该模型。
在 models.providers.zai.models 中添加 glm-5.2: { "id": "glm-5.2", "name": "GLM-5.2", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 1000000, "maxTokens": 131072 } 然后设置默认 primary model: { "model": { "primary": "zai/glm-5.2", "fallbacks": ["zai/glm-4.7"] } } 并在 agents.defaults.models 下添加该模型: { "models": { "zai/glm-5.2": { "alias": "GLM" }, "zai/glm-4.7": {} } } 重启 OpenClaw gateway: openclaw gateway restart 随后从 Orca 启动 OpenClaw,或在 Orca 终端中运行 openclaw tui,以确认 GLM-5.2 已激活。
核心规则很简单:在 harness 存储 provider/模型配置的地方配置 GLM-5.2,然后让 Orca 在正确的 worktree 中启动该 harness。