// 国内安装 · 使用完整教程

Claude Code 安装和使用教程（国内完整版）

从环境准备、两种安装方式，到 API 中转配置与报错排查，这一篇把国内用上 Claude Code 的每一步都讲透。照着做，十分钟就能在终端里跑起来。

准备工作：系统与环境要求

Claude Code 是一款跑在命令行里的 AI 编程工具，安装前先确认两件事：操作系统与 Node.js 环境。

支持的系统

系统	最低版本
macOS	13.0 及以上（Intel / Apple 芯片）
Windows	Windows 10 1809+ / Windows 11
Linux	Ubuntu 20.04+ / Debian 10+ 等主流发行版

此外建议至少 4 GB 内存，x64 或 ARM64 处理器。

安装 Node.js

Claude Code 依赖 Node 运行，请先安装 Node.js 18 LTS 及以上。安装后在终端确认版本：

node -v    # 应输出 v18.x 或更高
npm -v     # 确认 npm 可用

第一步：安装 Claude Code

官方提供两种安装方式。原生安装器是目前推荐的方式（更快、自带后台更新、无需 Node 依赖）；npm 方式则更通用，已装 Node 的话最方便。任选其一即可。

方式一：原生安装器（官方推荐）

macOS / Linux，在终端执行：

curl -fsSL https://claude.ai/install.sh | bash

Windows，在 PowerShell 中执行：

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

方式二：用 npm 安装

已装 Node.js 的话，一条命令全局安装。国内可先切换镜像源加速下载：

# 可选：切换国内镜像，下载更快
npm config set registry https://registry.npmmirror.com
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

验证安装是否成功

无论用哪种方式，装完都用下面两条命令检查：

claude --version    # 输出版本号即安装成功
claude doctor       # 官方自带的环境体检，会列出问题与建议

第二步：国内为什么要配置 API 中转

Claude Code 装好后，默认会请求 Anthropic 的海外接口。国内直连有两个现实障碍：一是网络，直连容易超时、断流；二是支付，官方订阅需要海外信用卡，注册门槛高。

最省事、也是国内开发者用得最多的办法，是接入一个 API 中转——中转平台帮你代理对 Anthropic 的请求，免翻墙、免海外卡，按用量计费，配置一次长期可用。Claude Code 原生支持自定义接口地址（ANTHROPIC_BASE_URL），所以接中转不需要改任何源码。

推荐：Claude Code API 中转（国内可直连）

通过下面这个 Claude Code API 中转注册，几分钟就能在控制台拿到一个以 sk- 开头的密钥，以及一个国内可直连的中转接口地址——这正是下一步要填的两样东西。

第三步：配置中转 API（三种方法）

拿到中转地址与密钥后，把它们配置给 Claude Code，它就会走中转而不再请求海外默认端点。下面三种方法任选其一，推荐方法二（一次配置长期生效）。

方法一：环境变量（快速、临时）

macOS / Linux（写入 ~/.bashrc 或 ~/.zshrc 可永久生效）：

export ANTHROPIC_BASE_URL="https://你的中转地址"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://你的中转地址"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
# 永久写入用户变量：
setx ANTHROPIC_BASE_URL "https://你的中转地址"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

方法二：写入 settings.json（推荐，长期生效）

编辑 Claude Code 的配置文件，把两项写进 env 即可，对所有项目都生效。

配置文件路径

系统	settings.json 路径
macOS / Linux	~/.claude/settings.json
Windows	%USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转地址",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

方法三：一键脚本（可选）

嫌手动麻烦，也可以把上面的 export 命令存成一个 .sh（macOS/Linux）或 .bat（Windows）脚本，下次换机器双击运行即可，省去重复配置。

第四步：启动并使用 Claude Code

进入任意项目目录，运行 claude 就进入交互式对话，可以让它读代码、跨文件改写、跑测试、生成提交：

cd 你的项目目录
claude

必学的斜杠命令

进入对话后，输入以 / 开头的命令可以管理会话：

/help      # 查看全部命令
/status    # 查看当前模型与连接状态（排错常用）
/model     # 切换模型
/config    # 查看与修改配置
/clear     # 清空当前上下文

选择合适的模型

模型档位	适合场景
Sonnet	日常开发首选，速度与效果均衡
Opus	架构设计、复杂重构等重任务
Haiku	轻量问答、快速反馈，最省

配好中转后，用 /status 能确认当前走的是中转地址、模型是否就绪，这一步能帮你快速判断配置有没有生效。

常见报错与解决

command not found: claude / which: no claude

安装目录没加入 PATH。先关闭终端重开刷新环境变量；macOS/Linux 可检查 ~/.local/bin 是否可写，必要时执行 sudo chown -R $(whoami) ~/.local 修复权限后重装。

npm 安装超时或权限报错

超时多为网络问题，换 registry.npmmirror.com 镜像源重试；权限报错（EACCES）可修复 npm 全局目录权限，或改用第一种「原生安装器」绕过 npm。

ANTHROPIC_BASE_URL 配置不生效

三点排查：① 改完没重启终端；② settings.json 的 JSON 格式有误（逗号/引号）；③ 地址结尾多了斜杠或拼写错误。用 /status 看实际请求地址最直观。

Windows 终端中文乱码

在 CMD/PowerShell 里先执行 chcp 65001 切换到 UTF-8 编码即可。

中转与官方账号，怎么选？

对比项	API 中转	官方账号
注册门槛	低，国内邮箱即可	需海外支付方式
计费	按用量，日常很省	按订阅周期
适合谁	想低成本、按需使用	想要完整官方体验与额度

如果你更想用官方的 Claude / Claude Code 账号（Pro / Max），又不想折腾海外支付，可以通过下面的渠道开通，再按官方方式登录即可使用，无需配置中转。

小结

到这里，国内使用 Claude Code 的完整链路就打通了：装好 Node 与 Claude Code → 用 claude doctor 体检 → 配一个 API 中转 → /status 确认生效 → 在项目里跑 claude。配置一次，往后随时可用。遇到问题，回到「常见报错」一节对照排查即可。