Claude Code 是基于 Anthropic Claude 模型的高级代码理解与生成组件，旨在帮助开发者快速完成代码撰写、调试和优化。Claude Code 依托大语言模型的深度推理能力，不仅能理解复杂的代码上下文，还能进行多轮交互式编程。
Claude Code 自 2025 年 2 月发布以来逐步从工具进化为 「智能代理」。核心优势在于深度上下文理解、多语言支持和宪法式 AI 安全机制，能显著提升开发效率并降低学习门槛。 Claude Code 虽然叫 Code，但它的功能绝对不止是写代码，而是一款真正意义上的通用Agent。

安装前提：科学上网

安装Claude Code

一、安装 node （需要版本 >= 18, 当前稳定版本是24)，安装时需管理员权限.

1. 访问：https://nodejs.org/en/download
2. 选择正确的芯片架构：
   • ARM64（M1/M2/M3 芯片的 Mac）
   • x64（Intel 芯片的 Mac）
3. 下载后点击安装包进行安装
4. 安装完成后，打开终端验证：

node --version
npm --version

PS. 这里更加推荐使用node 版本管理工具安装， n 或者 nvm， 详细内容参见文章末尾。

二、 安装 Claude Code，安装时需要管理员权限

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

国内npm镜像

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

3、安装完校验

claude -v

配置Cloude Code使用的大模型

配置方案：使用 CCSwitch

CCSwitch 是一个可视化的 Claude Code 配置管理工具，可以：
• ✅ 管理多个 API 节点
• ✅ 一键切换不同供应商
• ✅ 测试连接状态
• ✅ 避免命令行配置的麻烦

一、下载CCSwitch
下载地址
https://github.com/farion1231/cc-switch/releases/tag/v3.10.3

2、CCSwitch中配置API key
安装成功后，打开CCSwitch界面。这个界面就是用来管理你所有的 API 接口和 Key 的（可以理解成密码管理器）。

这里用智普大模型配置举例 (其他可支持的大模型配置可以参考CCSwtich配置列表)：

1. 购买大模型用量套餐
   https://bigmodel.cn/usercenter/glm-coding/overview

2. 创建API Key
   https://bigmodel.cn/usercenter/proj-mgmt/apikeys

3. 配置国产模型（GLM 4.6）到 CCSwitch
   a) 点击「添加新的供应商」→「Zhipu GLM」
   b) 填写以下信息：
   • 供应商名称：当选内置的厂商时，这里不需要填，自动填充了
   • Base URL：当选内置的厂商时，这里不需要填，自动填充了
   • API Token：你的 API Key（只需要填 Key 即可）
   • 其他配置清空
   c) 点击「保存」
   d) 点击「启用」
   e) 点击「测试」按钮，显示连接正常即可 ✅
   
   

3、配置检查
参考 智普大模型 配置Claude Code文档
https://docs.bigmodel.cn/cn/guide/develop/claude#%E6%96%B9%E5%BC%8F%E4%B8%89%EF%BC%9A%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AE

检查配置项 如下：
1、settings 文件

# 编辑或新增 `settings.json` 文件
# MacOS & Linux 为 `~/.claude/settings.json`
# Windows 为`用户目录/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `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
  }
}

其中 “your_zhipu_api_key”，是自己生成的大模型API key

2、claude.json 文件

# 再编辑或新增 `.claude.json` 文件
# MacOS & Linux 为 `~/.claude.json`
# Windows 为`用户目录/.claude.json`
# 新增 `hasCompletedOnboarding` 参数
{
  "hasCompletedOnboarding": true
}

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

开始使用 Claude Code

配置完成后，进入一个工作目录，在终端中执行 claude 命令

即可开始使用 Claude Code

若遇到「Do you want to use this API key」选择 Yes 即可
启动后选择信任 Claude Code 访问文件夹里的文件，如下：

进入前Claude Code会确认使用目录地址，确认地址后回车

现在就可以正常使用 Claude Code 进行开发了。

大模型API key配置地址

智普：
https://bigmodel.cn/usercenter/proj-mgmt/apikeys
Deepseek：
https://platform.deepseek.com/api_keys
Kimi：
https://platform.moonshot.cn/console/api-keys

node 版本管理工具对比

使用场景	推荐
新手 / 简单	n
最通用	nvm
极致速度	fnm
团队 / 锁版本	Volta
多语言统一管理	asdf / mise

1️⃣ n
语言：Node.js
安装：npm i -g n
优点:

1. 极其简单、轻量
2. 适合快速切换版本

缺点:

1. 需要 sudo（macOS / Linux）
2. 不太适合多项目并行

适合：个人开发、快速切版本

n latest
n lts
n 18.20.4

2️⃣ nvm（Node Version Manager）
最经典、最常用
语言：Shell
优点

1. 支持 .nvmrc
2. 每个项目可用不同 Node 版本
3. 社区成熟
   缺点
4. Windows 需用 nvm-windows
5. shell 启动略慢

适合：大多数开发者

nvm install 20
nvm use 20