2.3 Claude Code 安装与配置

2.3.1 安装

前提条件:

Claude Code 官方提供原生安装器和 npm 等安装方式。本教程已经在第零部分安装 Node.js,因此优先使用 npm 安装方式,和后续前端项目开发环境保持一致;如果你不想通过 npm 管理 Claude Code,也可以使用官方原生安装器。

方式一:npm 安装(推荐本教程使用)

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

Windows 提醒:Claude Code 对 Windows 的支持方式会随版本变化。若官方文档提示通过 WSL 使用,请在 WSL 的 Linux 终端里执行安装和环境变量配置;如果你的当前版本支持原生 Windows,再按官方 Windows 说明操作。

方式二:原生安装器(可选)

官方也提供原生安装器,用于不想通过 npm 管理 Claude Code 的用户。安装命令和支持系统可能变化,使用前请以 Claude Code 官方 setup 文档为准。

# macOS / Linux / WSL 示例
curl -fsSL https://claude.ai/install.sh | bash

验证安装:

$ claude --version

预期输出:

claude-code v1.x.x

验证:如果能看到版本号,说明安装成功!

安装常见问题排查:

问题原因解决方案
curl 下载失败网络访问官方安装地址失败检查网络,或改用 npm 安装方式
npm: command not foundNode.js 未安装或 PATH 未生效回到 0.2.1 安装 Node.js
EACCES: permission denied (macOS)npm 全局安装权限不足修复 npm 全局目录权限,或改用官方原生安装器
下载超时 / 网络错误npm 默认源在国外,速度慢npm 方式可设置国内镜像:npm config set registry https://registry.npmmirror.com
Windows PowerShell 执行策略限制系统安全策略阻止脚本运行以管理员身份打开 PowerShell,执行 Set-ExecutionPolicy RemoteSigned,然后重新安装
ERR! code EBADENGINENode.js 版本太低升级 Node.js 到 v18+

提示: 国内用户 如果官方安装器网络不稳定,可以临时使用 npm 方式,并先配置 npm 镜像:

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

2.3.2 API 配置

安装好 Claude Code 后,需要配置 API 密钥或登录方式才能使用。这一节提供三类配置方案,请根据你的情况选择。

核心配置参数速查表:

参数(环境变量)作用何时使用
ANTHROPIC_API_KEYAnthropic 官方 API Key直接使用官方服务时
ANTHROPIC_AUTH_TOKEN第三方平台的 API Key使用中转/第三方模型时
ANTHROPIC_BASE_URLAPI 端点地址(覆盖默认地址)使用中转/第三方服务时
ANTHROPIC_MODEL默认使用的模型名称或别名持久指定默认模型
ANTHROPIC_DEFAULT_OPUS_MODELopus 槽位映射的具体模型自定义三级槽位映射
ANTHROPIC_DEFAULT_SONNET_MODELsonnet 槽位映射的具体模型自定义三级槽位映射
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 槽位映射的具体模型自定义三级槽位映射
API_TIMEOUT_MSAPI 请求超时时间(毫秒)网络慢或模型推理耗时长时

提示: 参数关系说明:ANTHROPIC_API_KEY 用于官方直连,ANTHROPIC_AUTH_TOKEN 用于第三方服务。两者不要同时设置,否则会冲突。ANTHROPIC_BASE_URL 只在使用非官方端点时需要设置。

三种配置方式对比:

配置方式持久性作用范围推荐场景
临时环境变量关闭终端即失效当前终端窗口快速测试、临时切换
永久环境变量永久生效所有终端和项目日常一台电脑固定使用
配置文件 settings.json永久生效全局或特定项目多项目/多模型切换、团队共享

配置文件路径说明:

  • 全局:~/.claude/settings.json(Windows:C:\Users\<用户名>\.claude\settings.json)
  • 项目级(团队共享):项目根目录/.claude/settings.json(可提交 Git)
  • 项目级(个人私有):项目根目录/.claude/settings.local.json(加入 .gitignore)
图片[1]-2.3 Claude Code 安装与配置-大赛人网

图:Claude Code 配置体系架构 —— 三种配置方式及其优先级层级

方案选择指南:
​
你能直接访问 Anthropic 网站吗?
├── 能 → 方案一:使用 Anthropic 官方 API(推荐)
└── 不能 → 你在国内吗?
  ├── 想用原版 Claude 模型 → 方案二:使用第三方API中转服务 国内首选
  ├── 想用其他模型(DeepSeek/千问/GLM等) → 方案三:接入其他模型
  └── 想要包月套餐、省心不操心 → 在方案三中选择厂商 Coding Plan
2.3.2.1 方案一:使用 Anthropic 官方 API(推荐海外用户)

这是最直接的配置方式,适合能稳定访问 Anthropic 服务、具备合规支付方式的用户。国内用户可能会遇到注册、支付、访问稳定性等问题,建议按自己的网络和合规条件谨慎选择。

注册步骤(可直接访问国际网络的用户):

  1. 访问 https://console.anthropic.com/
  2. 点击 “Sign up” 注册账号
  3. 使用邮箱注册并完成验证
  4. 登录后,进入 API Keys 页面
  5. 点击 “Create Key” 创建一个新的 API Key
  6. 为这个 Key 起个名字(如 “claude-code”)
  7. 立即复制并保存 —— API Key 只会显示一次!

避坑:API Key 就像你的银行卡密码,绝对不要分享给别人,也不要把它写在代码文件里提交到 GitHub。一旦泄露,别人可以用你的额度调用API,产生费用。

计费说明:

Anthropic API 采用按量计费模式(用多少付多少):

模型输入费用输出费用说明
Claude Haiku 4.5$1 / 百万Token$5 / 百万Token轻量、快速、低成本
Claude Sonnet 4.6$3 / 百万Token$15 / 百万Token日常开发主力
Claude Opus 4.7$5 / 百万Token$25 / 百万Token复杂规划与深度推理

提示:一个 Token 大约等于 4 个英文字符或 1-2 个中文字符。一次普通的编程对话大约消耗 1000-5000 个 Token,具体费用取决于输入/输出比例和所选模型。新用户是否有免费额度,以 Anthropic 当前页面为准。

(价格信息按 Anthropic 官方价格页在 2026-05-18 核对,请以官网最新价格为准)

Step 1:设置环境变量

你需要将 API Key 设置为系统环境变量,这样 Claude Code 启动时就能自动读取。

Windows 用户(PowerShell):

# 方法一:临时设置(仅当前终端窗口有效,关闭后失效)
$env:ANTHROPIC_API_KEY = "sk-ant-api03-你的实际API-Key"
​
# 方法二:永久设置(推荐,一次设置永久生效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-你的实际API-Key", "User")

注意:永久设置后需要重新打开终端才能生效。

macOS / Linux 用户:

# 编辑 shell 配置文件(根据你使用的 shell 选择)
# 如果用 zsh(macOS 默认):
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的实际API-Key"' >> ~/.zshrc
​
# 如果用 bash:
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的实际API-Key"' >> ~/.bashrc
​
# 使配置立即生效
$ source ~/.zshrc  # 或 source ~/.bashrc

Step 2:首次启动 Claude Code

# 进入你的项目目录
$ cd D:\ai-coding-projects  # Windows
$ cd ~/ai-coding-projects   # macOS
​
# 启动 Claude Code
$ claude

预期输出:

╭──────────────────────────────────────────╮
│                               │
│   Welcome to Claude Code!           │
│                               │
│   /help for available commands         │
│                               │
╰──────────────────────────────────────────╯
​
>

你会看到一个交互式界面,光标等待你输入。试试输入你的第一条消息:

> 你好,请介绍一下你自己

验证:如果 Claude Code 正常回复了你的消息,恭喜,API配置成功!

常见错误排查:

错误信息原因解决方案
Invalid API Key 或 401 UnauthorizedAPI Key 不正确检查 Key 是否复制完整,注意开头的 sk-ant- 前缀
Connection refused 或网络超时无法连接到 Anthropic 服务器检查网络连接,国内用户请使用方案二
ANTHROPIC_API_KEY is not set环境变量未设置重新执行设置命令,并确保重启了终端
Rate limit exceeded请求频率超过限制等待一分钟后重试
© 版权声明
THE END
喜欢就支持一下吧
点赞9 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容