GLM-4.6 技术速览 & 在 Claude Code 中接入指南（含 API Key 申请）GLM-4.6 技术速览

GLM-4.6 新特性：

语境长度扩到 200K tokens
在真实开发工具（如 Claude Code、Cline、Roo、Kilo Code）里编码与推理表现提升
面向 agent 的工具调用/搜索能力更强
公开了权重以便本地部署

API Key 申请： 到智谱/Z.AI 开放平台注册 → 个人中心 API Keys 创建密钥 bigmodel.cn/usercenter/…

Claude Code 接入： 设置 Anthropic 兼容端点与 API Key 即可；官方文档给出了两种基址（api.z.ai/api/anthropic 或 open.bigmodel.cn/api/anthropic），不同套餐/区域使用其一

一、GLM-4.6 是什么？有哪些变化

更长上下文

从 4.5 的 128K 扩到 200K tokens，更适合复杂"agent 工作流"和长代码库场景。

编码/推理强化

在多项公开基准与"真实世界任务集"上较 4.5 有明确提升；在 Coding 工具链里（Claude Code、Cline、Roo、Kilo Code 等）实测表现更好，尤其前端页面生成的观感质量。

Agent 能力

推理时的工具调用/检索型智能体集成更顺滑。

效率

相较 4.5，token 消耗进一步下降（博文给出了 15% 的总体下降示例），对长会话/自动化开发更友好。

生态适配

官方明确支持在 Coding Agents（含 Claude Code）里使用，并给出了如何在订阅方案下切到 glm-4.6 模型名的说明。

可本地部署

权重同步在 Hugging Face / ModelScope，适配 vLLM / SGLang 等推理框架。

注： Z.AI 官网主页还提到 GLM-4.6 为 MoE 架构并宣传 200K 语境与综合榜单升级，你可在品牌页获取市场向表述。近期媒体也有同步报道。

二、如何申请 GLM-4.6 的 API Key

1. 注册/登录开放平台

访问智谱开放平台/Z.AI 平台，点击"注册/登录"。

2. 创建 API Key

进入 个人中心 → API Keys；点击"创建新的 API Key"，复制保存。

3. （可选）开通/订阅编码套餐

如果你打算在 Claude Code 等编码工具里长期使用，官方提供 GLM Coding Plan（价格/权益随时更新，以文档为准）。

官方快速开始文档一步一步写明了"注册 → 获取 API Key → 选择模型"的流程；HTTP 调用时也给出了基础网关 https://open.bigmodel.cn/api/paas/v4/ 与鉴权头。

三、在 Claude Code 中使用 GLM-4.6（Anthropic 兼容）

Claude Code 默认面向 Anthropic Messages API。Z.AI 官方提供兼容端点，把 Claude Code 的请求"切换"到 GLM-4.6 即可，无需改 Claude Code 源码。

方案 A：环境变量法（官方推荐）

⚠️ 基址（Base URL）有两种官方文档：

Z.AI 文档给出：https://api.z.ai/api/anthropic
智谱文档给出：https://open.bigmodel.cn/api/anthropic

两者均为 Anthropic 兼容网关；不同地区/套餐的默认指引可能不同，按你所用文档为准。

macOS / Linux（bash/zsh）

# 任选其一（按你的官方文档指引来）
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
# 或
# export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"

# 填入你在开放平台创建的 Z.AI/智谱 API Key
export ANTHROPIC_API_KEY="YOUR_API_KEY"
# 有些教程/脚本用的是 ANTHROPIC_AUTH_TOKEN（Claude Code 也支持）
# export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

# 启动 Claude Code
claude

Z.AI 文档同时示例了 ANTHROPIC_AUTH_TOKEN 的用法；底层 SDK 通常也识别 ANTHROPIC_API_KEY。

Windows · PowerShell（当前会话生效）

$env:ANTHROPIC_BASE_URL = "https://api.z.ai/api/anthropic"
# 或者 "https://open.bigmodel.cn/api/anthropic"
$env:ANTHROPIC_API_KEY  = "YOUR_API_KEY"
# 兼容写法（有些指南/脚本使用）
# $env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

claude

Windows · CMD（当前会话生效）

set ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic
rem 或 set ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
set ANTHROPIC_API_KEY=YOUR_API_KEY
claude

方案 B：写进 Claude Code 配置（可锁定模型名）

Z.AI 文档给出了在 ~/.claude/settings.json 中设置默认"Haiku/Sonnet/Opus"映射为 GLM 的方法（Claude Code 会读取这些变量）：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "glm-4.6"
  }
}

保存后新开终端再运行 claude，并在 Claude Code 输入 /status 查看当前模型。

快速自检

运行 claude 后如果弹出"是否使用该 API Key"，选择 Yes；在输入框中键入 /status 能看到当前模型与基址。

你也可以直接调用 Anthropic Messages API 兼容端点做一次 curl 验证（注意用你的 Base URL）：

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "glm-4.6",
    "max_tokens": 64,
    "messages": [{"role":"user","content":"Hello"}]
  }'

四、常见踩坑 & 排障

Windows 提示 'export' 不是内部或外部命令

那是 Linux/macOS 用法；在 PowerShell 用 $env:NAME="VALUE"，在 CMD 用 set NAME=VALUE。见上方示例。

连不上/401

检查你用的 Base URL 是否与所参考文档一致（api.z.ai/api/anthropic 或 open.bigmodel.cn/api/anthropic）
确认环境变量名是否被你的工具识别：ANTHROPIC_API_KEY 是最通用的，部分脚本用 ANTHROPIC_AUTH_TOKEN；两者都设更保险
改完变量后重开终端或重启工具，否则进程内拿到的仍是旧值

公司网络/代理

若企业网络限制外网，可参考 Claude Code 的企业代理文档或在你网关上做转发。

五、为什么是 Claude Code + GLM-4.6？

Z.AI 官方博客明确提到 GLM-4.6 已适配包括 Claude Code 在内的多款 Coding 代理工具；对"真实世界开发任务"的评估也集中在这类环境中进行。你可以把 Claude Code 作为统一 IDE 外壳，只切换底层模型为 GLM-4.6 来做横向对比与复现。

本指南基于官方文档整理，具体配置以最新官方文档为准。

docs.bigmodel.cn/cn/guide/de…

GLM-4.6 技术速览 & 在 Claude Code 中接入指南（含 API Key 申请）

目录