【2026最新版】Claudecode安装详细教程!一键安装,永久使用

一、Claude Code 官网与核心介绍

Claude Code 是 Anthropic 推出的 AI 编程助手，支持终端、VS Code、JetBrains 等环境，可写代码、改 Bug、自动化工程任务。

官方主页：https://claude.ai

官方下载：https://claude.ai/download

官方文档：https://docs.anthropic.com/zh-CN/docs/claude-code

【领取方式见文末】

二、安装前准备（必看）

注册与获取 API

步骤 1：注册智谱AI账户

访问智谱AI开放平台：
点击页面左上方的"注册"按钮
输入手机号并进行验证，完成注册
完成实名认证（实名认证后可获得更多免费额度）

https://bigmodel.cn/

ZHIPU AI OPEN PLATFORM

步骤 2：获取免费额度

注册后自动获得 100 万 tokens 免费额度
完成实名认证后额外获得 400 万 tokens（有效期一个月）
新用户总共可获得 500 万 tokens 的免费额度

GLM 推出了编码套餐，可以https://www.bigmodel.cn/glm-coding?ic=5AH7ATEZSC，配合Claude Code，完成你的工作需求。

步骤 3：获取 API Key

登录智谱AI开放平台
点击右上角的"查看API Key"或进入"API管理"
点击"添加新的Key"或"创建新Key"
填写Key名称（可选），点击确认
系统会生成 API Key
重要：妥善保存 API Key，建议复制到安全的地方

配置 Claude Code

配置 GLM 到 Claude Code 有三种方式，选择适合你的一种即可。

方式一：使用自动化助手（推荐）

Coding Tool Helper 是一个编码工具助手，可以快速将 GLM 编码套餐加载到 Claude Code 中。

步骤 1：运行自动化助手

在终端中执行以下命令：


npx @z_ai/coding-helper

步骤 2：按照提示操作

自动化助手会引导你完成：

工具安装
套餐配置
MCP 服务器管理

这是最简单快捷的方式，适合大多数用户。

方式二：使用自动化脚本（仅限 macOS 和 Linux）

如果你使用 macOS 或 Linux 系统，可以使用自动化脚本快速配置。

步骤 1：下载并运行脚本

在终端中执行以下命令：


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

步骤 2：脚本自动配置

脚本会自动修改 ~/.claude/settings.json 文件，配置以下环境变量：


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

注意：请将 your_zhipu_api_key 替换为你实际获取的 API Key。

方式三：手动配置

如果你需要手动配置，请根据你的操作系统选择以下方式之一。

macOS 和 Linux

创建或编辑配置文件 ~/.claude/settings.json
添加以下内容（替换 your_zhipu_api_key 为你的 API Key）：


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

Windows（Cmd）

在 Cmd 中运行以下命令（替换 your_zhipu_api_key 为你的 API Key）：


setx ANTHROPIC_AUTH_TOKEN your_zhipu_api_keysetx ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropicsetx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

Windows（PowerShell）

在 PowerShell 中运行以下命令（替换 your_zhipu_api_key 为你的 API Key）：


[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_zhipu_api_key', 'User')[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://open.bigmodel.cn/api/anthropic', 'User')[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

重要提示：配置完成后，请关闭所有终端窗口，打开一个新的终端窗口以使配置生效。

测试连接

步骤 1：启动 Claude Code

配置完成后，在终端中进入你的代码工作目录，执行以下命令启动 Claude Code：


claude

步骤 2：信任文件夹 #

首次启动时，Claude Code 会询问是否信任当前文件夹，选择 Yes。

步骤 3：发送测试消息 #

在 Claude Code 的聊天界面中，输入一条简单的测试消息，例如：


你好，请用一句话介绍一下你自己。

步骤 4：验证结果 #

如果看到 GLM 的回复，说明配置成功！

回复应该流畅自然
响应时间应该在几秒内
没有错误提示

步骤 5：检查模型状态（可选） #

在 Claude Code 中输入 /status 命令，可以查看当前使用的模型状态和配置信息。

GLM 模型介绍 #

GLM Coding Plan 默认使用智谱 AI 的最新模型，通过环境变量映射到 Claude Code 的模型层级。

默认模型映射 #

配置成功后，GLM 模型会自动映射到 Claude Code 的模型层级：

Claude Opus → GLM-4.7（最强大的模型）
Claude Sonnet → GLM-4.7（平衡性能与速度）
Claude Haiku → GLM-4.5-Air（快速响应模型）

提示：默认情况下，你在 Claude Code 界面上看到的是 Claude 模型名称，但实际使用的是 GLM 模型。这是服务端的模型映射，无需手动配置。

GLM-4.7 #

特点：智谱最新的旗舰模型，综合能力最强
适用场景：复杂任务、深度代码生成、需要高质量输出的场景
性能：在代码生成、逻辑推理、问题解决等方面表现优异

GLM-4.5-Air #

特点：轻量级模型，响应速度快
适用场景：快速对话、简单任务、需要实时响应的场景
性能：响应速度快，适合大量使用

手动切换模型（高级用户） #

如果你需要手动切换模型，可以编辑 ~/.claude/settings.json 文件，添加以下配置：


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

注意：一般不建议手动调整模型映射，因为硬编码后当 GLM Coding Plan 的模型更新升级时，不方便自动更新到最新模型。

常见问题 #

Q：API Key 泄露了怎么办？

A：立即在智谱AI开放平台删除旧密钥，创建新的密钥，并更新你的配置。

Q：配置后提示"认证失败"怎么办？

A：检查以下几点：

API Key 是否正确，注意不要有多余的空格
Base URL 是否填写为 https://open.bigmodel.cn/api/anthropic
配置后是否重新打开了新的终端窗口
配置文件的 JSON 格式是否正确

Q：免费额度用完了怎么办？

A：可以在智谱AI开放平台购买付费套餐，价格比较实惠。GLM Coding Plan 还提供以更低价格获得 3 倍用量的套餐。

Q：如何确认配置是否生效？ A：启动 Claude Code 后，输入 /status 命令查看模型状态和配置信息。

Q：配置后没有生效怎么办？

A：尝试以下排查步骤：

关闭所有 Claude Code 窗口
重新打开一个新的命令行窗口
再次运行 claude 启动
如果问题仍然存在，可以删除 ~/.claude/settings.json 文件，然后重新配置
确认配置文件的 JSON 格式是否正确，可以使用在线 JSON 校验工具进行检查

Q：GLM 的中文能力如何？

A：GLM 是国内领先的大模型之一，中文理解能力非常出色，适合中文用户使用。

Q：可以在多个项目中使用同一个 API Key 吗？

A：可以，一个 API Key 可以在多个项目中使用，但建议为不同项目创建不同的 Key 以便于管理。

Q：推荐使用哪个版本的 Claude Code？

A：建议使用最新版本的 Claude Code。你可以通过以下命令检查当前版本和升级：


# 检查当前版本claude --version# 升级到最新版本claude update

我们在 Claude Code 2.0.14 等版本验证通过，建议使用此版本或更新版本。

Q：如何切换使用不同的 GLM 模型？ A：默认情况下，GLM 模型会自动映射到 Claude Code 的模型层级。如果需要手动切换，可以编辑 ~/.claude/settings.json 文件，修改 ANTHROPIC_DEFAULT_HAIKU_MODEL 、 ANTHROPIC_DEFAULT_SONNET_MODEL 、 ANTHROPIC_DEFAULT_OPUS_MODEL 环境变量。但一般不建议手动调整，以便自动更新到最新模型。

Q：配置文件修改后不生效怎么办？

A：确保：