文档 / 智能体 / 如何在 Orca ADE 中使用 GLM-5.2

GLM-5.2 可通过你已在使用的代理框架在 Orca 中运行。请在 Claude Code、OpenCode、Cline、Kilo Code、Roo Code、Droid、OpenClaw 或其他 CLI 代理中配置 GLM-5.2，然后从 Orca 的选择器中启动该代理。

Orca 提供隔离的 worktree、终端窗格、浏览器标签页、审查流程和会话管理。你的 Z.ai CodePlan 订阅 和代理配置提供模型访问权限。

在代理框架中配置 GLM-5.2 之前，你需要一个有效的 Z.ai CodePlan 订阅，并且具有 GLM Coding Plan 访问权限。兼容 OpenAI 的框架还需要一个 Z.ai API 密钥。Orca 不包含或转售 GLM 访问权限。

本页记录经过 Orca 测试的 GLM-5.2 配置。Z.ai 的模型指南 可能列出了更新的模型；在替换模型之前，请在那里核实模型名称、上下文限制和框架兼容性。

Claude Code¶

Claude Code 从 ~/.claude/settings.json 读取模型覆盖设置。要在 Orca 中使用 GLM-5.2：

1. 打开 ~/.claude/settings.json。
2. 添加或更新下面的 env 块。
3. 在 Orca 中重启 Claude Code 会话，以加载新的环境变量。
4. 在 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 的压缩窗口与该上下文大小匹配。如果 Claude Code 提示 [1m] 模型不存在，请更新 Claude Code 后重试。

对于编码任务，Z.ai 建议使用 /effort 将 Claude Code 的 effort 设置为 max。Claude Code 的较低 effort 设置对应 GLM-5.2 的高 effort，而 xhigh、max 和 ultracode 对应 GLM-5.2 的最大 effort。

OpenCode, Cline, Kilo Code, Roo Code, and Droid¶

对于暴露兼容 OpenAI 提供商的代理框架：

1. 在 Orca 外部或内部打开框架设置。
2. 选择兼容 OpenAI 的提供商选项；如果框架有 Z.ai 提供商选项，则选择该选项。
3. 将 base URL 设置为 https://api.z.ai/api/coding/paas/v4。
4. 添加你的 Z.ai API 密钥。
5. 将自定义模型名称设置为 glm-5.2。
6. 如果框架暴露了该字段，请将上下文窗口大小设置为 1000000。
7. 除非框架明确记录该提供商路径支持图像，否则请禁用图像支持。

保存后，从 Orca 的代理选择器中启动该框架。Orca 将在所选 worktree 中运行相同配置的 CLI。

OpenClaw¶

如果 OpenClaw 无法直接从其提供商模型列表中选择 GLM-5.2，请在 ~/.openclaw/openclaw.json 中手动添加该模型。

将 glm-5.2 添加到 models.providers.zai.models：

{
  "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
}

然后设置默认主模型：

{
  "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 网关：

openclaw gateway restart

然后从 Orca 启动 OpenClaw，或在 Orca 终端中运行 openclaw tui，以确认 GLM-5.2 已激活。

关键规则很简单：在框架存储提供商/模型设置的任何位置配置 GLM-5.2，然后让 Orca 在正确的 worktree 中启动该框架。