十分钟让你学会安装 Claude Code 并接入大模型

AI新手教学
1

Claude Code 是 Anthropic 推出的 AI 编程助手，装在你电脑的终端里，能直接读写文件、执行命令、帮你写代码、改 bug。你可以把它理解成一个住在终端里的程序员搭档。
不过有个现实问题：Claude Code 官方需要连接 Anthropic 的服务器，国内直连不太方便。所以今天这篇教程的重点就是： 怎么装 + 怎么接入国内也能用的模型。全程跟着做，十分钟搞定。

第一步：装好你的"地基"

Claude Code 跑在 Node.js 环境上，所以你电脑上得先有 Node.js。

装 Node.js

去官网下载： https://nodejs.org
打开页面后你会看到两个版本，选 LTS（长期支持版） ，别选 Current。下载完一路"下一步"装完。

注意：Node.js 版本要求 18 以上。

装完之后验证一下。打开终端：

  • Windows 用户 ：按 Win+R ，输入 cmd ，回车
  • Mac 用户 ：按 Cmd+空格 ，输入 Terminal ，回车

输入：
node -v
如果显示类似 v20.15.0 这样的版本号，Node.js 就装好了。

Windows 用户额外注意

Windows 上还需要安装 Git。去 https://git-scm.com 下载，一路默认安装即可。装完验证：
git --version
能看到版本号就没问题。

第二步：安装 Claude Code

准备工作做完了，现在来装主角。有两种安装方式，选哪种都行。

方式一：用官方脚本安装（推荐）

最简单，一行命令搞定。
Mac / Linux 用户 ，打开终端，复制粘贴：
curl -fsSL https://claude.ai/install.sh | bash
Windows 用户 ，打开 PowerShell（按 Win+X ，选择"Windows PowerShell"或"终端"），输入：
irm https://claude.ai/install.ps1 | iex

等它跑完就好了。如果因为网络问题卡住或失败，别慌，看方式二。

方式二：用 npm 安装

npm 是 Node.js 自带的包管理器。打开终端，输入：
npm install -g @anthropic-ai/claude-code
如果下载太慢，先切换到国内镜像源：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

验证安装

装完后输入：
claude --version
看到版本号，说明安装成功。
踩坑提醒 ：如果提示"找不到 claude 命令"，可能是环境变量没配好。Windows 用户需要确认 C:\\Users\\你的用户名\\.local\\bin 已经加到系统 PATH 环境变量里。

操作路径：右键"此电脑" → 属性 → 高级系统设置 → 环境变量 → 在 Path 里添加上面那个路径。Mac 用户一般不会遇到这个问题。

第三步：接入大模型

装好了 Claude Code，但它只是个"壳子"，需要连接一个大模型才能干活。这里有三个方案，根据你的情况选择。

方案一：接 Anthropic 官方 API（效果最好，但门槛高）

如果你有海外信用卡，网络条件也 OK，直接用官方 API 效果最好。

  1. 去 https://console.anthropic.com 注册账号，创建一个 API Key
  2. 在终端设置环境变量：
    Mac / Linux：
    export ANTHROPIC_API_KEY="sk-ant-xxxxx你的keyxxxxx"
    Windows PowerShell：
    $env:ANTHROPIC_API_KEY=“你的API_Key”
    Windows CMD：
    set ANTHROPIC_API_KEY=你的API_Key

提示：设置环境变量时有些命令不会返回任何输出，这是正常的，没报错就是成功了。

方案二：接智谱 GLM（国内推荐，免费额度可用）

国内用户最推荐的方案。智谱 AI 的 GLM 模型支持 Anthropic API 兼容接口，网络稳定，价格也便宜。
第 1 步：注册账号
访问智谱开放平台： https://open.bigmodel.cn ，点击右上角"注册/登录"。
第 2 步：获取 API Key
登录后进入 API Keys 页面： https://bigmodel.cn/usercenter/proj-mgmt/apikeys ，创建一个新的 API Key，复制并妥善保存。
第 3 步：配置环境变量
和方案一一样，把智谱的 API Key 设到环境变量里：
Mac / Linux：
export ANTHROPIC_API_KEY="你的智谱API_Key"

Windows PowerShell：
$env:ANTHROPIC_API_KEY="你的智谱API_Key"

Windows CMD：
set ANTHROPIC_API_KEY=你的智谱API_Key
第 4 步：配置 Base URL
除了 API Key，还需要告诉 Claude Code 去访问智谱的接口地址。进入你的项目目录，启动 Claude Code 后输入 /config 进入设置，将 Base URL 改为智谱的接口地址。
或者你也可以用自动化助手来一键配置（推荐）：

在命令行中运行：
npx @z_ai/coding-helper

按照界面提示操作，它会自动完成工具安装、套餐配置和 MCP 服务器管理。
更详细的配置说明，可以访问智谱 AI 开放文档： Claude Code - 智谱AI开放文档

方案三：接其他国产模型（阿里百炼、DeepSeek 等）

其他国产大模型厂商也支持 Anthropic API 兼容接口，配置方式和智谱类似：

  1. 在对应平台注册账号并获取 API Key
  2. 设置环境变量 ANTHROPIC_API_KEY 为你的 Key
  3. 配置 ANTHROPIC_BASE_URL 为对应平台的接口地址
    具体地址参考各平台的官方文档。

第四步：开始使用

配置完成后，进入你的代码工作目录，在终端中执行：

claude

启动后：

  1. 选择信任 Claude Code 访问文件夹里的文件（按 1 确认）
  2. 若遇到「Do you want to use this API key」选择 Yes
  3. 等待初始化完成，就可以开始用了

试着输入一句：

帮我看看这个项目的目录结构，告诉我入口文件在哪

如果 Claude Code 正确返回了项目信息，恭喜你，一切就绪。

补充：升级与维护

# 检查当前版本
claude --version

# 升级到最新版本
claude update

安装过程中遇到问题，可以访问智谱 AI 开放文档查看详细说明：Claude Code - 智谱AI开放文档

速查清单

步骤 命令/操作
验证 Node.js node -v
验证 Git（Win） git --version
官方安装（Mac） `curl -fsSL https://claude.ai/install.sh
官方安装（Win） `irm https://claude.ai/install.ps1
npm 安装 npm install -g @anthropic-ai/claude-code
npm 国内镜像 npm config set registry https://registry.npmmirror.com
验证 Claude Code claude --version
设环境变量（Mac） export ANTHROPIC_API_KEY="你的Key"
设环境变量（Win PS） $env:ANTHROPIC_API_KEY="你的Key"
设环境变量（Win CMD） set ANTHROPIC_API_KEY=你的Key
智谱一键配置 npx @z_ai/coding-helper
启动 Claude Code claude
升级 claude update

小结：整个过程就四步——装 Node.js → 装 Claude Code → 接大模型 → 启动使用。国内用户推荐方案二（智谱 GLM），注册即有免费额度，网络稳定，跟着上面走完就能用起来。