本文是 Claude Code 系列的第一篇。三篇文章带你从安装到进阶，完整掌握这个终端里的 AI 编程助手。
Claude Code 是什么
Claude Code 是 Anthropic 出的命令行 AI 编程助手。它能直接在终端里帮你：
- 读/改项目代码
- 写新功能、修 bug、重构
- 跑测试、定位报错
- 生成脚本、文档、配置
简单说，它是一个能直接操作你代码仓库的 AI 同事。
一、前置条件
1. 安装 Node.js（必需）
Claude Code 基于 Node 运行，需要 Node 18+（推荐 LTS 20+）。
- 打开官网：https://nodejs.org
- 下载 LTS 版
- 双击安装，全部默认即可
验证安装：
node -v
npm -v
能看到版本号就 OK。
2. 安装 Git（推荐）
Claude Code 会用 Git 读项目历史、生成 diff、开 PR。
- 打开官网：Redirecting…
- 下载后一路 Next
验证：
git --version
3. 选择终端
推荐使用以下任一终端：
- Windows Terminal（推荐，Microsoft Store 搜索安装）
- PowerShell
- VS Code 内置 Terminal
- Git Bash
二、安装 Claude Code
方法一：npm 全局安装
npm install -g @anthropic-ai/claude-code
验证：
claude --version
看到版本号说明安装成功。
方法二：npm 太慢用国内镜像
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
装完可改回官方源：
npm config set registry https://registry.npmjs.org
方法三：不想全局安装
npx @anthropic-ai/claude-code
三、配置 API Key
1. 获取 API Key
以乘丰 AI 为例（也可用其他兼容服务）：
- 打开 https://api.cphone.vip
- 注册/登录账号
- 左侧「API 令牌」→ Create Key
- 复制 Key（格式类似
sk-xxxxxxxxx）
2. 设置环境变量
PowerShell 中执行：
setx ANTHROPIC_API_URL "https://api.cphone.vip"
setx ANTHROPIC_API_KEY "你的Key"
或者临时设置（当前窗口有效）：
$env:ANTHROPIC_BASE_URL = "https://api.cphone.vip"
$env:ANTHROPIC_AUTH_TOKEN = "你的Key"
注意：setx 设置后需重新打开终端才生效。
验证：
echo $env:ANTHROPIC_API_KEY
四、第一次运行
进入你的项目目录：
cd D:\projects\my-app
启动 Claude Code：
claude
第一次运行会：
- 检测当前目录是否为 Git 仓库
- 询问是否允许 Claude 读取/改写文件
- 可能让你选默认模型
照提示选 yes 即可。
五、常见安装问题
问题 1：claude 不是内部命令
原因：npm 全局 bin 没进 PATH。
解决：
# 找到 npm 全局目录
npm config get prefix
把 prefix 下的 node_modules\.bin 加进系统 PATH，重新打开终端。
问题 2：网络连不上 / 超时
- 开代理（Clash 等）
- 或使用可访问 Anthropic 的网络环境
- 中国大陆无代理需用第三方兼容 API
问题 3：读/写文件权限不足
- 用管理员 PowerShell
- 或把项目放到有权限的位置（如 D 盘用户目录）
问题 4：中文路径异常
部分工具链对中文目录支持不好，建议项目放在纯英文路径：
D:\projects\my-app
第一篇到此结束。 装好之后，第二篇我们开始让 Claude 帮你写代码。