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

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

一、环境准备

系统要求

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

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

1
2
3
4
5
6
# 使用 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 直接安装（需代理）

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

方法 2：国内镜像安装

1
2
3
4
5
# 设置 npm 镜像
npm config set registry https://registry.npmmirror.com

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

方法 3：手动下载二进制

  1. 访问 Claude Code GitHub Releases（需代理）
  2. 下载对应平台的二进制文件
  3. 赋予执行权限并移动到 PATH
1
2
chmod +x claude-macos-arm64
sudo mv claude-macos-arm64 /usr/local/bin/claude

三、API Key 配置

获取 API Key

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

配置环境变量

1
2
3
4
5
6
# 临时生效（当前终端）
export ANTHROPIC_API_KEY="sk-ant-api03-xxxx"

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

验证配置

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

四、网络代理配置

使用代理软件

1
2
3
4
5
6
7
# 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 走代理

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

五、CLAUDE.md 基础配置

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 项目概述
本项目是一个 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 权限目录：

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

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

data-ad-format="fluid" data-ad-layout-key="-7k+ex-4a-9w+4a">

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

代理资源（如有需要）：

  • Claude API 需要稳定的代理服务，建议使用支持 HTTPS 协议的代理
  • 推荐使用 Claude API 中转服务（如有）以获得更好访问性
data-ad-format="auto" data-full-width-responsive="true">