图文详解 Claude Code 从入门到精通（一）：Claude Code 的安装与启动

前言

Claude Code 是 Anthropic 推出的 AI 编程命令行工具（CLI），能够直接在终端中与你的代码交互，帮助你完成编码、调试、重构等任务。

本篇文章面向 Windows 用户，详细介绍安装与配置过程，并推荐接入智谱 GLM Coding Plan 以获得更稳定的网络体验和更高的性价比。

一、准备工作

在安装 Claude Code 之前，需要先完成以下准备：

1. 安装 Node.js

访问 Node.js 官网，下载并安装 LTS 版本（18.x 或更高）。

验证安装：

node --version

2. 安装 Git for Windows

Claude Code 在 Windows 上需要 Git 环境。访问 Git 官网 下载安装包，安装时选择「Use Git from Git Bash only」或「Git from the command line and also from third-party software」。
验证安装：

git -v

3. 获取任意平台的Coding Plan API key

如果你在国内使用，推荐注册 智谱开放平台 账号，并订阅 GLM Coding Plan 套餐：

• 价格实惠：Pro 版每月约 100 元
• 网络稳定：国内直连，无需代理
• 3 倍用量：搭配套餐可获得 3 倍用量

二、安装 Claude Code

方法一：npm 安装（推荐）

打开 PowerShell 或 CMD，执行：

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

方法二：官方安装脚本

PowerShell：

irm https://claude.ai/install.ps1 | iex

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

验证安装

claude --version

如果输出版本号，说明安装成功。

三、配置智谱 GLM Coding Plan

为什么选择 GLM Coding Plan？

• 价格实惠：相比官方 Claude API，GLM Coding Plan 价格更低，Pro 版每月约 100 元
• 网络稳定：国内直连，无需代理，告别频繁超时
• 3 倍用量：搭配套餐可获得 3 倍用量
• 模型对标：
  • GLM-4.5-Air 对标 Claude Haiku（轻量快速）
  • GLM-4.7 对标 Claude Sonnet/Opus（平衡选择）
  • GLM-5 对标 Claude Opus（复杂任务推荐）

步骤 1：获取 API Key

1. 登录 智谱开放平台
2. 点击左侧菜单「API Keys」，创建新的 API Key
3. 妥善保存你的 API Key

注意：首次使用需要先订阅 GLM Coding Plan 套餐

步骤 2：配置环境变量

方式一：Coding Tool Helper（推荐）

智谱官方提供的自动化助手，一条命令完成所有配置：

npx @z_ai/coding-helper

运行后按照界面提示操作即可。

方式二：手动配置

1. 创建配置文件：

   进入 C:\Users%你的用户名% 目录下，找到.claude目录，这是Claude Code的主文件夹，打开settings.json（没有就新建）

   添加以下内容（将 your_api_key 替换为你的智谱 API Key）：

{
  "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
  }
}

2. 返回上一级目录（用户名目录），打开.claude.json文件（没有就新建）

   添加一条配置，以跳过登录流程：

{
  "hasCompletedOnboarding": true
}

步骤 3：验证配置

重新打开一个 PowerShell 窗口，启动 Claude Code：

claude

首次启动时，若提示「Do you want to use this API key」，输入 Yes 确认。

四、基本命令

五、常见问题

Q：安装后运行 claude 无反应？
A：确保已安装 Git for Windows，并重新打开终端再试。

Q：配置智谱后无法使用？
A：检查 API Key 是否正确，配置文件路径是否为 C:\Users\你的用户名\.claude\settings.json。

Q：如何切换到 GLM-5 模型？
A：编辑 settings.json，添加：

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
  }
}

注：GLM-5 在高峰期（每日 14:00-18:00）按 3 倍用量计算。

相关文档：

• 智谱 Claude Code 配置文档
• Claude Code 官方文档

下一篇预告：《图文详解 Claude Code 从入门到精通（二）：高效开发实战技巧》