Roo Code 接入 Z AIGLM 系列模型完整指南区域路由、模型配置与思考模式解析【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-CodeZ AI智谱 AI为 Roo Code 提供 GLM 系列大模型并通过区域感知路由为国际用户与中国大陆用户分别提供独立接入端点与模型目录。本文将带你从申请 API Key 开始完成在 Roo Code 中的 Z AI 提供商配置并结合仓库源码剖析区域端点映射、模型定价参数、OpenAI 兼容格式以及 GLM-4.7/GLM-5 思考thinking模式的底层实现让你既会配置、也懂原理。Z AI 提供商概览一条线路两套端点Z AIZhipu AI提供 GLM 家族的多款语言模型包括通用模型、轻量模型、免费高速模型与多模态视觉模型。其 API 服务在架构上区分国际版与国内版两个平台因此 Roo Code 在接入时引入了区域Region这一核心概念International国际区面向全球用户API 平台为z.ai默认端点为https://api.z.ai/api/paas/v4China中国大陆区面向中国大陆用户API 平台为 BigModelopen.bigmodel.cn默认端点为https://open.bigmodel.cn/api/paas/v4。区域设置同时决定两件事目标 API 端点与可选模型目录。Roo Code 会根据所选区域自动拉取该区域可用的模型列表无需手动维护。第一步获取 API Key无论使用哪个区域Z AI 都要求携带 API Key 发起请求获取方式一致仅平台入口不同。国际用户访问z.ai的模型 API 页面z.ai/model-api注册或登录账号进入账户控制台找到API Keys区域为你的应用生成一个新的 API Key立即复制并妥善保存——API Key 只在创建时完整展示一次关闭页面后将无法再次查看。中国大陆用户访问 BigModel 开放平台open.bigmodel.cn注册或登录账号进入账户控制台找到API Keys区域生成一个新的 API Key立即复制并妥善保存。注意两个平台的 API Key 相互独立、不可混用请根据你的区域选择在对应平台申请。第二步在 Roo Code 中配置 Z AI打开 Roo Code 设置点击 Roo Code 面板右上角的齿轮图标⚙选择提供商在 API Provider 下拉框中选中Z AI选择区域根据你的访问位置选择区域International默认——全球访问China——中国大陆访问填写 API Key将上一步获取的 Key 粘贴到 Z AI API Key 输入框选择模型在 Model 下拉框中选择目标模型可选模型由当前所选区域决定。默认行为与关键特性Base URL 自动切换选定区域后端点自动确定无需手工填写International →https://api.z.ai/api/paas/v4China →https://open.bigmodel.cn/api/paas/v4动态模型列表切换区域会自动刷新模型目录并同步更新目标端点通常无需自定义 Base URL日常使用不需要额外配置自定义端点。源码级剖析区域与端点的真实映射文档中区域决定端点的描述在源码中有精确对应。在 packages/types/src/providers/zai.ts 中定义了一份线路配置表zaiApiLineConfigs它比 UI 上的两个区域更细共包含四条线路线路键名名称Base URL区域international_codingInternational Codinghttps://api.z.ai/api/coding/paas/v4国际china_codingChina Codinghttps://open.bigmodel.cn/api/coding/paas/v4中国international_apiInternational APIhttps://api.z.ai/api/paas/v4国际china_apiChina APIhttps://open.bigmodel.cn/api/paas/v4中国其中international_coding与china_coding走.../coding/paas/v4编码专用端点international_api与china_api走通用.../api/paas/v4端点。每条线路还带一个isChina布尔标记用于决定加载哪一份模型目录。该线路字段在 packages/types/src/provider-settings.ts 中通过 Zod 枚举校验zaiApiLineSchema z.enum([international_coding, china_coding, international_api, china_api])配合zaiApiKey一起构成 Z AI 的配置 Schema。在提供商实现端src/api/providers/zai.tsZAiHandler继承自BaseOpenAiCompatibleProvider其构造函数会根据options.zaiApiLine缺省时默认international_coding取出对应线路的isChina、baseUrlconst isChina zaiApiLineConfigs[options.zaiApiLine ?? international_coding].isChina const models (isChina ? mainlandZAiModels : internationalZAiModels) as unknown as Recordstring, ModelInfo const defaultModelId (isChina ? mainlandZAiDefaultModelId : internationalZAiDefaultModelId) as string super({ ...options, providerName: Z.ai, baseURL: zaiApiLineConfigs[options.zaiApiLine ?? international_coding].baseUrl, apiKey: options.zaiApiKey ?? not-provided, defaultProviderModelId: defaultModelId, providerModels: models, defaultTemperature: ZAI_DEFAULT_TEMPERATURE, })由此可以推断UI 上的International / China两个区域在底层会继续细分到 coding 与通用 API 线路默认模型与模型目录则随isChina标记自动切换。可用模型与定价参考以仓库配置为准Roo Code 会自动从 Z AI API 拉取模型列表但你无需依赖网络请求仓库内的 packages/types/src/providers/zai.ts 已固化了两份模型目录并附带了上下文窗口、最大输出、价格与缓存价格等元数据。国际区模型目录internationalZAiModels模型上下文窗口最大输出输入价$/1M输出价$/1M备注glm-4.6默认200,00016,3840.62.2最新模型超长上下文glm-4.5131,07216,3840.62.2旗舰模型glm-4.5-air131,07216,3840.21.1轻量版glm-4.5-x131,07216,3842.28.9高性能强推理glm-4.5-airx131,07216,3841.14.5轻量极速glm-4.5-flash131,07216,38400免费高速glm-4.7200,00016,3840.62.2内置思考能力默认开启glm-4.7-flash200,00016,38400免费思考模型变体glm-4.7-flashx200,00016,3840.070.4思考模型极速版glm-5202,75216,3840.62.2下一代模型内置思考glm-4.5v131,07216,3840.61.8多模态视觉glm-4.6v131,07216,3840.30.9多模态视觉glm-4.6v-flash131,07216,38400免费视觉模型glm-4.6v-flashx131,07216,3840.040.4视觉极速版glm-4-32b-0414-128k131,07216,3840.10.132B 参数高效模型中国区模型目录mainlandZAiModels与上述大体对应但存在两个差异点一是价格不同例如glm-4.6输入 0.29、输出 1.14二是glm-4.6/glm-4.7的上下文窗口为 204,800且不包含glm-4-32b-0414-128k。两个区域的默认模型均为glm-4.6见internationalZAiDefaultModelId与mainlandZAiDefaultModelId在 packages/types/src/providers/index.ts 的getProviderDefaultModelId中Z AI 的默认模型也会根据isChina标记分别返回。所有模型的默认采样温度统一为ZAI_DEFAULT_TEMPERATURE 0.6。上表价格取自仓库当前固化的元数据实际计费以对应区域平台的最新定价为准。思考Thinking模式GLM-4.7/GLM-5 的特殊处理这是 Z AI 接入中比较独特的实现细节。在模型目录中glm-4.7与glm-5声明了supportsReasoningEffort: [disable, medium]、reasoningEffort: medium与preserveReasoning: true表示它们原生内置思考能力且 API 默认开启 thinking。这带来一个隐含问题如果用户在 Roo Code 中关闭了推理reasoning而 API 侧 thinking 默认仍为开启就会产生行为不一致。因此ZAiHandler重写了createStream方法src/api/providers/zai.ts当检测到当前模型支持思考Array.isArray(info.supportsReasoningEffort)时会调用自定义的createStreamWithThinking通过shouldUseReasoningEffort判断用户当前是否开启推理并显式向 API 发送 thinking 参数thinking: useReasoning ? { type: enabled } : { type: disabled },即用户开推理 → 显式enabled用户关推理 → 显式disabled避免依赖 API 的默认开启行为。同时请求中仍携带max_tokens、temperature、stream: true、stream_options: { include_usage: true }、tools与parallel_tool_calls等标准 OpenAI 流式参数。为交错思考优化的消息转换器GLM-4.7/GLM-5 的思考模式还要求对话历史中的推理内容能被正确保留与回传。为此仓库提供了一个专用转换器 src/api/transform/zai-format.tsconvertToZAiFormat其核心逻辑包括将 Roo Code 内部的 Anthropic 消息格式转换为 OpenAI Chat Completions 格式保留reasoning_content将助手消息中的推理块提取并写回 OpenAI 消息的reasoning_content字段实现交错思考interleaved thinking的连续对话合并工具结果后的文本当mergeToolResultText: true时工具结果tool_result如 environment_details之后的文本会被合并进最后一条 tool 消息而不是新开一条 user 消息——原因是 Z AI 一旦在历史中看到 user 消息就会丢弃此前所有的reasoning_content破坏思考连续性。从源码注释可以确认这是为了让 Roo Code 的 Agent 循环工具调用 → 环境反馈 → 继续思考与 Z AI 的 thinking API 行为完全对齐而做的专门适配。使用提示与注意事项区域选择即端点选择International→https://api.z.ai/api/paas/v4China→https://open.bigmodel.cn/api/paas/v4切换区域会自动更新模型目录无需手工覆盖 Base URLOpenAI 兼容协议Z AI 提供 OpenAI 兼容 API支持流式响应streaming与用量统计usage reporting这也是 Roo Code 通过BaseOpenAiCompatibleProvider快速接入的原因模型自动过滤模型列表会依据所选区域自动过滤确保候选模型与端点能力匹配例如中国区不提供glm-4-32b-0414-128kAPI Key 必需所有请求都必须携带有效 Key请确保从对应区域平台获取未配置 Key 时ZAiHandler会回退为占位符not-provided请求将失败思考模型注意推理开关使用glm-4.7、glm-5时建议根据任务复杂度在 Roo Code 中显式设置推理强度medium / disableRoo Code 会以thinking参数显式覆盖 API 默认行为价格查询模型定价以各区域平台当前发布的价格为准仓库中的inputPrice/outputPrice等字段仅为 Roo Code 成本估算所用。完成以上配置后即可在 Roo Code 中直接使用 GLM 系列模型驱动完整的 Agent 开发流程如需了解其他提供商或进阶功能可查阅仓库中的 providers 文档目录 与 Roo Code 使用指南。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考