Claude Code 中国使用指南：安装配置篇

中国用户使用 Claude Code 面临网络访问障碍，本文提供从零到生产环境的完整配置方案，涵盖 npm 安装、镜像源配置、API 访问、代理设置四大核心场景。

一、环境准备

系统要求

Node.js 18+
npm 9+ 或 pnpm
支持的操作系统：macOS、Linux、Windows（WSL2 推荐）

安装 Node.js（跳过网络下载）

# 使用 nvm 管理版本，避免权限问题
curl -o install.sh https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh
bash install.sh
source ~/.bashrc
nvm install 20
nvm use 20

二、Claude Code 安装

方法 1：npm 直接安装（需代理）

npm install -g @anthropic-ai/claude-code
# 或使用 pnpm
pnpm add -g @anthropic-ai/claude-code

方法 2：国内镜像安装

# 设置 npm 镜像
npm config set registry https://registry.npmmirror.com

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

方法 3：手动下载二进制

访问 Claude Code GitHub Releases（需代理）
下载对应平台的二进制文件
赋予执行权限并移动到 PATH

chmod +x claude-macos-arm64
sudo mv claude-macos-arm64 /usr/local/bin/claude

三、API Key 配置

获取 API Key

访问 console.anthropic.com（需代理）
注册账号并完成付费设置
生成 API Key

配置环境变量

# 临时生效（当前终端）
export ANTHROPIC_API_KEY="sk-ant-api03-xxxx"

# 永久生效
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxx"' >> ~/.bashrc
source ~/.bashrc

验证配置

claude -p "你好，测试连接" --allowedTools "Bash"

四、网络代理配置

使用代理软件

# Clash 配置
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890

# 验证代理生效
curl -I https://api.anthropic.com

让 Claude Code 走代理

# 在 ~/.claude/settings.json 中配置
{
  "proxy": "http://127.0.0.1:7890"
}

五、CLAUDE.md 基础配置

在工作目录创建 CLAUDE.md，定义项目上下文：

# 项目概述
本项目是一个 Python REST API 服务，使用 FastAPI 框架。

# 技术栈
- Python 3.11+
- FastAPI
- PostgreSQL
- Docker

# 代码规范
- 使用 Black 格式化
- 使用 Ruff 进行 lint
- 提交前必须运行测试

# 禁止事项
- 不要删除生产数据库
- 不要提交包含密钥的代码

六、快速验证清单

检查项	命令	预期结果
Node.js	`node --version`	v20.x.x
Claude Code	`claude --version`	显示版本号
API Key	`echo $ANTHROPIC_API_KEY`	sk-ant-api03-…
网络连通性	`curl -I https://api.anthropic.com`	HTTP 200

七、常见问题

Q：npm 安装报错 EACCES A：使用 sudo 或配置 npm 权限目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

Q：API Key 无效 A：确认 Key 格式正确且未过期，检查账单余额。

Q：代理仍然无法连接 A：尝试使用 --dangerously-skip-permissions 跳过权限检查，或使用 VPN 替代代理。

配置完成后即可开始使用 Claude Code 进行开发工作。下一篇将介绍程序员如何通过 CLAUDE.md 和 skill 深度定制 Claude Code。

资源	链接	说明
Claude Code 官网	https://docs.anthropic.com/zh-CN/claude-code	官方文档（需代理）
Anthropic API	https://console.anthropic.com	API Key 管理
Node.js 下载	https://nodejs.org/	LTS 版本下载
nvm 安装脚本	https://github.com/nvm-sh/nvm	Node 版本管理器
Claude Code GitHub	https://github.com/anthropics/claude-code	最新版本和 Release Notes