Claude Code - 智谱AI开放文档

Claude Code 是一个智能编码工具，可以在终端中运行，通过自然语言命令交互帮助开发者快速完成代码生成、调试、重构等任务。

使用最新 GLM-5.2 模型请参考如何切换使用模型

一、安装 Claude Code

推荐安装方式
Cursor 引导安装方式

前提条件：

您需要安装 Node.js 18 或更新版本环境
macOS 用户推荐使用 nvm 方式安装 Nodejs 或 Homebrew 方式。不推荐直接安装包安装(后续可能会遇到权限问题)
Windows 用户还需安装 Git for Windows

进入命令行界面，安装 Claude Code

npm install -g @anthropic-ai/claude-code

运行如下命令，查看安装结果，若显示版本号则表示安装成功

claude --version

若您不熟悉 nodejs 且有 Cursor，您可以在 Cursor 中输入命令，Cursor 会引导您完成 Claude Code 的安装。

https://docs.anthropic.com/zh-CN/docs/claude-code/overview Help me install Claude Code

注意：macOS 用户若在安装过程中遇到权限问题，请使用 nvm 方式安装 Nodejs。
安装成功后，还需下方步骤二配置，先不要直接使用 claude 命令启动(可能由于网络或地区限制无法使用)。

二、配置 GLM Coding Plan

注册账号

访问智谱开放平台，点击右上角的「注册/登录」按钮，按照提示完成账号注册流程。

获取API Key

个人版套餐的用户，通过个人编程套餐 > 套餐概览，新建 API Key
团队版套餐的成员，通过团队编程套餐 > 我的套餐，获取 API Key（团队套餐 Key 与平台其他 API Key 不通用，使用团队额度请务必使用团队套餐 Key）

请妥善保管您的 API Key，不要泄露给他人，也不要直接硬编码在代码中。

配置环境变量

Claude Code 内部模型环境变量与 GLM 模型对应关系，默认配置如下：

ANTHROPIC_DEFAULT_OPUS_MODEL：GLM-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL：GLM-4.7
ANTHROPIC_DEFAULT_HAIKU_MODEL：GLM-4.7

通过在 macOS、Linux 或 Windows 中使用以下一种方式设置环境变量：

设置环境变量时，有些命令不会返回任何输出。这是正常的，只要没有报错即代表成功。
选择以下适合您操作系统的一种方式进行配置即可。

方式一：自动化助手
方式二：自动化脚本
方式三：手动配置

Coding Tool Helper 是一个编码工具助手，快速将您的GLM编码套餐加载到您喜爱的编码工具中。安装并运行它，按照界面提示操作即可自动完成工具安装，套餐配置，MCP服务器管理等。

# 进入命令行界面，执行如下运行 Coding Tool Helper
npx @z_ai/coding-helper

详细说明请参考 Coding Tool Helper 文档。

仅支持 macOS Linux 环境，在终端或 IDE 中运行以下命令即可，⚠️注意此方式不支持 Windows

curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

脚本会自动通过修改 ~/.claude/settings.json 来配置如下环境变量(您无需手动修改)：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

脚本会自动在 ~/.claude.json 添加

{
    "hasCompletedOnboarding": true
}

支持 macOS & Linux & Windows, 注意不同系统配置文件路径不一样。注意需保证修改的 JSON 文件格式正确性（比如多或少,）。

macOS & Linux & Windows

# 编辑或新增 `settings.json` 文件
# macOS & Linux 为 `~/.claude/settings.json`
# Windows 为`用户目录/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `YOUR_API_KEY` 为您上一步获取到的 API Key
# 新增 `hasCompletedOnboarding` 参数
{
      "env": {
      "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
      "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
      "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
      "API_TIMEOUT_MS": "3000000"
  }
}

配置成功后，请确保重新打开一个新的终端窗口，以便环境配置生效。

三、开始使用 Claude Code

配置完成后，进入一个您的代码工作目录，在终端中执行 claude 命令即可开始使用 Claude Code

若遇到「Do you want to use this API key」选择 Yes 即可

启动后选择信任 Claude Code 访问文件夹里的文件。完毕！现在就可以正常使用 Claude Code 进行开发了。

四、常见问题

手工修改配置不生效

若您手动修改了 ~/.claude/settings.json 配置文件，但发现配置没有生效，参考如下排查。

关闭所有 Claude Code 窗口，重新打开一个新的命令行窗口，再次运行 claude 启动。
如果问题仍然存在，您可以尝试删除 ~/.claude/settings.json 文件，然后重新配置环境变量，Claude Code 会自动生成一个新的配置文件。
确认配置文件的 JSON 格式是否正确，检查变量名称和不能少逗号或多逗号，可以使用在线 JSON 校验工具进行检查。

​一、安装 Claude Code

​二、配置 GLM Coding Plan

​三、开始使用 Claude Code

​四、常见问题

​手工修改配置不生效

​推荐的 Claude Code 版本

一、安装 Claude Code

二、配置 GLM Coding Plan

三、开始使用 Claude Code

四、常见问题

手工修改配置不生效

推荐的 Claude Code 版本