Claude Code

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 校验工具进行检查。

GLM Coding Plan

接入指南

学习资源

特别权益

一、安装 Claude Code

二、配置 GLM Coding Plan

三、开始使用 Claude Code

四、常见问题

手工修改配置不生效

推荐的 Claude Code 版本

​一、安装 Claude Code

​二、配置 GLM Coding Plan

​三、开始使用 Claude Code

​四、常见问题

​手工修改配置不生效

​推荐的 Claude Code 版本

一、安装 Claude Code

二、配置 GLM Coding Plan

三、开始使用 Claude Code

四、常见问题

手工修改配置不生效

推荐的 Claude Code 版本