智谱 GLM 接入教程

通过 CC Switch 或手动配置,将智谱 GLM 分别接入 Codex 和 Claude Code CLI

≡ ON THIS PAGE

适合什么场景

这篇教程适合已经准备使用智谱 GLM 做代码工作的用户。你可以通过 CC Switch 或手动配置把智谱 GLM 接入 Codex 或 Claude Code CLI,用来阅读项目、生成代码、排查报错、重构和做代码审查。

一、开始前准备

Base URL

https://your-api-host.example

API Key

服务平台 控制台创建的真实密钥。

Codex / Claude Code CLI

若接入 Codex,先确认 Codex 客户端或 codex CLI 可用;若接入 Claude Code CLI,先确认 claude CLI 命令可用。

CC Switch

若通过CC Switch接入,先安装并确认 CC Switch 可以正常打开。

二、接入 Codex

这里分成两种方式:通过 CC Switch 接入,或者直接手动配置。

方式一:通过 CC Switch 接入

1
打开 CC Switch,进入 Codex 对应的配置入口,按下图配置完成后启用配置。
图片加载中...
图片加载中...
2
完全退出 Codex 桌面客户端,或关闭当前终端后重新打开,再启动 Codex。

方式二:手动配置

如果你更习惯直接改文件,可以按现有 Codex 接入教程 的手动配置方式来做。这里要做的事情很简单,就是把 Codex 配置里的模型、Base URL 和密钥换成智谱 GLM 对应值。

1
打开 Codex 使用的用户目录 .codex。
2
按现有 Codex 配置结构写入 auth.json 和 config.toml。
3
把 Base URL 和模型名改成智谱 GLM 对应值。
4
保存后完全退出 Codex,再重新启动。
图片加载中...
图片加载中...

三、接入 Claude Code CLI

这里也分成两种方式:通过 CC Switch 接入,或者直接手动配置。

方式一:通过 CC Switch 接入

1
打开 CC Switch,进入 Claude Code CLI 对应的配置入口,按下图配置完成后启用配置。
图片加载中...
图片加载中...
图片加载中...
2
进入项目目录,运行 claude 启动 Claude Code CLI。

方式二:手动配置

如果你更习惯直接改 settings.json,就按现有 Claude Code 接入教程 的手动配置方式来做。核心是把 Anthropic 兼容入口换成智谱 GLM 的地址。

图片加载中...
{
  "alwaysThinkingEnabled": false,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://your-api-host.example",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
    "ANTHROPIC_MODEL": "glm-5.2",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

四、验证是否成功

配置完成后,不建议第一步就让工具改代码。先在一个低风险项目中执行只读任务,确认认证、模型和项目读取都正常。

在项目目录中启动 Codex:

codex

然后输入:

请只阅读当前项目,不要修改任何文件。先说明这个项目的目录结构和主要技术栈。

在项目目录中启动 Claude Code CLI:

claude

然后输入:

请只阅读当前项目,不要修改任何文件。先说明这个项目的目录结构和主要技术栈。

五、常见问题

Q.CC Switch 配置后 Codex 仍然没有变化

先完全退出 Codex 桌面客户端,或关闭当前终端重新打开。仍不生效时,检查 CC Switch 写入的是不是当前 Codex 真正读取的用户目录。Windows PowerShell、WSL、远程服务器通常是不同环境。

Q.Claude Code CLI 仍然走旧模型

关闭旧终端,重新打开新终端后运行 claude。进入 Claude Code CLI 后可以用 /status 查看当前状态;如果模型映射没有变化,回到 CC Switch 检查 Claude Code CLI 配置是否已经切换到智谱 GLM Provider。

Q.提示模型不存在

把模型名改成智谱控制台当前可用的模型编码,并注意大小写、连字符和后缀。例如开启 1M 上下文时,部分配置会使用 glm-5.2[1m] 这类带后缀的模型名。