APIMaster.ai
APIMaster.ai 使用文档
快速开始APIMaster 官网模型广场

在 Claude Code 中使用 GLM-5.2、GLM-5.3 和 GLM-5.3-Flash：设置与模型切换

使用 APIMaster 在 Claude Code 中设置 GLM。在 Windows、macOS 和 Linux 上配置 settings.json，启动 claude，通过 /model 选择模型并开始对话。

在 settings.json 中配置 APIMaster，运行 claude，然后在对话中输入 /model MODEL_ID 即可使用 GLM。 本文涉及的可用 ID 为 glm-5.2、glm-5.3、glm-5.3-flash。Claude Code 是客户端；GLM 是应答的模型。

开始之前

先完成环境检查和 Claude Code 设置。获取一个余额充足且可访问所选模型的 APIMaster API 密钥。

claude --version

网关基础 URL 为 https://apimaster.ai，不带 /v1。Claude Code 会自行追加 /v1/messages。

1. 打开配置目录

Windows

按下 Win + R，输入以下路径并按回车：

%USERPROFILE%\.claude

如果需要，先创建该文件夹。打开或创建 settings.json。请确保文件名不是 settings.json.txt。

macOS / Linux

在 macOS 上，在访达（Finder）中按 Command + Shift + G 并输入：

~/.claude

在 Linux 上，使用你的文件管理器或编辑器打开同一目录。如果需要，先创建它：

mkdir -p ~/.claude

在该目录中打开或创建 settings.json。如果你设置了自定义的 Claude Code 配置目录，则改用那个目录。

2. 编辑 settings.json

Windows、macOS 和 Linux 使用相同的配置。将 YOUR_APIMASTER_API_KEY 替换为你的 APIMaster 密钥：

{
  "model": "glm-5.3",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

如果该文件已存在，请先备份，然后将这些字段合并到现有的 JSON 对象和 env 对象中。保留你需要的其他设置。不要追加第二个 JSON 对象或重复 env 键。JSON 不允许注释或尾随逗号。

通用的 Claude Code 指南展示的是令牌认证方式。本指南使用的是我们集成测试中验证过的 API 密钥认证方式。使用 ANTHROPIC_API_KEY 时，请保持 ANTHROPIC_AUTH_TOKEN 为空，并从其他设置或终端中移除冲突的凭据。此网关请使用 APIMaster 密钥。

model 字段设置启动时的模型。启动后你可以选择其他模型。请将此用户设置文件保密；不要将真实密钥提交到共享仓库。保存文件并重启 Claude Code 以加载新配置。

3. 启动 Claude Code

在项目目录中打开终端，运行：

claude

完成正常的首次运行提示，并确认项目信任提示。起始模型应为 glm-5.3。这是一个正常的交互式会话，具有常用的工具和项目设置。

4. 选择模型并开始对话

在 Claude Code 对话中，输入以下命令之一并按回车：

/model glm-5.2
/model glm-5.3
/model glm-5.3-flash

每次运行一行，选择你想要的模型。Claude Code 确认切换后，发送一条简短消息：

Reply with exactly OK.

收到正常的文本回复即表示基本连接成功。之后你可以继续对话，或让它处理你的项目。若要在同一对话中再次切换，输入另一条 /model MODEL_ID 命令。

单独输入 /model 会打开模型选择器。自定义网关 ID 可能不会出现在其默认列表中。 此时请直接输入完整 ID，如上所示。斜杠命令属于 Claude Code 内部，而不是在 PowerShell 或 Bash 中使用。这些模型名称描述的是 GLM 模型，而非 Claude Sonnet 或 Opus。

你也可以在从 终端 启动时选择模型。每次运行一条命令：

claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash

要显式设置未来会话的默认模型，请编辑 settings.json 中的 model 字段。启动标志、ANTHROPIC_MODEL 环境变量或项目/托管设置都可能影响所选模型；如果起始模型与你保存的值不同，请检查这些项。

故障排除

症状 检查项
401 / 意外的登录提示 检查 APIMaster 密钥、基础 URL 以及冲突的认证变量；编辑设置后重启 CLI。
404 使用 https://apimaster.ai，不带 /v1 或 /v1/messages。
设置未生效 检查文件位置、JSON 是否有效，以及来自终端、项目或托管设置的覆盖项。
选择器中找不到模型 输入 /model MODEL_ID 并使用准确的 ID，或以 claude --model MODEL_ID 启动。
模型不可用 / 403 检查拼写、密钥允许的模型、账户余额以及当前路由的可用性。
unrecognized_model 我们在测试中使用自定义 ID 时观察到此错误。请检查实际回答和工具结果；Claude 内置能力的默认行为未针对 GLM 验证。
文件或命令权限被拒绝 通过常规权限提示审查并批准预期的操作。
429 / 5xx / 回复中断 如需寻求支持，请保留错误信息、模型 ID、CLI 版本、UTC 时间和请求 ID（如有）。

验证与可选诊断

记录的集成测试信息：2026-09-15 UTC，Claude Code 2.1.239，Linux。此处列出的所有模型均返回了预期的文本，并通过工具读取了本地文件。这三个模型还完成了一个小型 Python 修复和测试运行，并在此后进行了独立核查。Windows 和 macOS 不在这些记录的测试范围内。

早期的自动化检查使用裸模式（bare mode）以隔离配置。日常正常使用应遵循上文的 settings.json 和交互式步骤。 裸模式和 --setting-sources "" 会跳过正常的集成或已保存的设置，因此不应添加到本指南的日常启动命令中。

如需使用已保存的配置进行快速的非交互式检查：

claude --model glm-5.3 -p "Reply with exactly OK."

如需工具检查，创建一个包含 FILE_PROBE_739182 的 probe.txt，在该目录中启动 Claude Code，并要求它使用工具读取该文件并返回其确切内容。确认工具确实运行了。

这些是有边界的集成检查，并非对每一项 Claude Code 功能、长时间会话行为或最大上下文的保证。Anthropic 的网关文档未正式支持将 Claude Code 路由到非 Claude 模型；本指南描述的是 APIMaster 的集成方案。

常见问题

我的 Claude 订阅可以为这些请求付费吗？

不可以。在此 APIMaster 配置下，请求使用的是你的 APIMaster 密钥和余额。

切换模型后还能继续对话吗？

可以，在打开的对话中使用模型切换命令，并等待确认后再发送下一条消息。如需在模型之间进行干净的对比，请使用 claude --model MODEL_ID 启动一个单独的会话。

相关指南与来源