夜雨聆风引言：Claude Code 是 Anthropic 推出的AI编程神器，但在国内安装总是各种报错？别慌！这篇保姆级教程，带你10分钟搞定安装配置！
🔥 Claude Code 是什么？
简单说，它就是一个住在你终端里的AI程序员。
你可以用中文和它对话：
• "帮我写一个用户登录功能"
• "这段代码有bug，帮我修一下"
• "帮我重构这个函数，让代码更优雅"
它会直接帮你写代码、改代码、调试代码！⚠️ 国内安装的三大坑
在国内安装 Claude Code，你会遇到：
| 问题 | 表现 | 原因 |
|------|------|------|
| 🐌 npm 安装慢 | 一直卡住不动 | 官方源在国外 |
| 🔌 API 连不上 | 报错网络超时 | Anthropic API 被墙 |
| 📦 依赖下载失败 | 各种奇怪报错 | 网络不稳定 |
📝 第一步：安装 Node.js
Claude Code 需要 Node.js 环境。
方式一：官网下载（简单粗暴）
访问 https://nodejs.org，下载 LTS 版本，一路下一步安装。
方式二：使用 nvm（推荐，方便管理版本）
# 安装 nvm（国内镜像，不会被墙）
curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.0/install.sh | bash
# 生效配置
source ~/.bashrc
# 安装 Node.js 18
nvm install 18
nvm use 18
# 验证安装
node --version
npm --version
看到版本号就说明成功了！🎉
📝 第二步：配置国内镜像
npm 默认从国外下载，慢到怀疑人生。换成国内镜像：
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证配置
npm config get registry
# 应该显示: https://registry.npmmirror.com
📝 第三步：安装 Claude Code
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
看到版本号，恭喜你，安装成功！🎊
📝 第四步：解决 API 访问问题（重点！）
这是最关键的一步！因为 Anthropic API 在国内无法直接访问，我们需要用一些"技巧"。
方案一：使用代理（推荐有代理的同学）
如果你有 Clash、V2Ray 等代理工具：
# 设置代理（HTTP）
export HTTPS_PROXY=http://127.0.0.1:7890
# 或者 SOCKS5 代理
export ALL_PROXY=socks5://127.0.0.1:7890
# 启动 Claude Code
claude
# 编辑配置文件
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
# 生效配置
source ~/.zshrc
方案二：使用 API 中转服务（没有代理的同学）
国内有一些 API 中转服务，相当于帮你转发请求到 Anthropic：
# 设置中转服务地址
export ANTHROPIC_BASE_URL="https://你的中转服务地址/v1"
export ANTHROPIC_API_KEY="中转服务给你的密钥"
# 启动 Claude Code
claude
方案三：自建中转（技术大佬）
如果你有海外服务器，可以自己搭一个中转：
# Nginx 反向代理配置
location /v1/ {
proxy_pass https://api.anthropic.com/v1/ !important;
proxy_ssl_server_name on;
proxy_set_header Host api.anthropic.com;
}
📝 第五步：配置 API 密钥
获取密钥
1. 访问 https://console.anthropic.com（需要科学上网）
2. 注册/登录账号
3. 进入 API Keys 页面
4. 点击 Create Key 创建密钥
5. 复制保存（只显示一次！）
配置密钥
# 方式一：环境变量
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxx"
# 写入配置文件（永久生效）
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc
📝 第六步：验证一切正常
# 启动 Claude Code
claude
看到这个界面就成功了：
╔════════════════════════════════════════════════════════════╗
║ Claude Code ║
║ AI-powered coding assistant ║
╚════════════════════════════════════════════════════════════╝
Type your message or use /help for commands.
>
试试输入：
> 帮我写一个 Hello World 程序
如果 Claude 给你写了代码，说明一切正常！🎉
🛠️ 一键配置脚本
懒人福音！复制粘贴运行：
#!/bin/bash
echo "🚀 Claude Code 国内环境一键配置"
# 1. 配置 npm 镜像
npm config set registry https://registry.npmmirror.com
echo "✅ npm 镜像配置完成"
# 2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
echo "✅ Claude Code 安装完成"
# 3. 创建配置文件
mkdir -p ~/.claude
cat > ~/.claude/.env << 'EOF'
# 在下面填入你的配置
ANTHROPIC_API_KEY=你的API密钥
# ANTHROPIC_BASE_URL=https://你的中转地址/v1
# HTTPS_PROXY=http://127.0.0.1:7890
EOF
echo "✅ 配置文件创建完成"
echo ""
echo "📝 请编辑 ~/.claude/.env 文件，填入你的 API 密钥"
echo "🚀 然后运行 'claude' 启动"
保存为 setup.sh，运行：
chmod +x setup.sh
./setup.sh
❓ 常见问题
Q1: npm install 一直卡住
# 增加超时时间
npm install -g @anthropic-ai/claude-code --fetch-timeout=60000
# 或者用 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install -g @anthropic-ai/claude-code
Q2: 报错 "command not found: claude"
# 检查 npm 全局路径
npm config get prefix
# 添加到 PATH
export PATH="$(npm config get prefix)/bin:$PATH"
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
Q3: API 连接超时
# 测试是否能访问 API
curl -v https://api.anthropic.com/v1/messages
# 如果超时，说明需要配置代理或中转服务
# 测试代理是否工作
curl -x http://127.0.0.1:7890 https://api.anthropic.com/v1/messages
Q4: Windows 用户怎么办？
# 安装 WSL（Windows 的 Linux 子系统）
wsl --install
# 重启电脑后，在 WSL 中按照 Linux 步骤安装
📚 配置清单
安装前，确保你有：
• [x] Node.js 18+
• [x] npm 国内镜像配置
• [x] 代理工具 或 API 中转服务
• [x] Anthropic API 密钥
🎯 总结
| 步骤 | 命令 | 说明 |
|------|------|------|
| 1 | 安装 Node.js | 运行环境 |
| 2 | npm config set registry ... | 国内镜像 |
| 3 | npm install -g @anthropic-ai/claude-code | 安装 |
| 4 | 配置代理或中转 | 解决网络问题 |
| 5 | claude | 启动使用 |
💡 小贴士
1. 代理推荐：Clash、V2Ray、Shadowsocks
2. API 中转：搜索 "Anthropic API 代理" 或 "Claude API 中转"
3. 密钥安全：不要把密钥提交到 GitHub！
学会了吗？现在就去试试吧！
有问题欢迎在评论区留言，我会一一解答！👇
觉得有用？转发给你的程序员朋友，别让他们继续被安装折磨了！ 😂 下一篇预告：《Claude Code 使用教程：10分钟学会AI编程》
