Claude Code国内流畅使用教程：安装、代理配置与常见问题

Claude Code 是什么

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，直接在终端里运行，能帮你读代码、改代码、执行命令、搜索文件、管理 Git 等。和 Cursor、Copilot 不同，Claude Code 不依赖 IDE 插件，在任何终端都能用。

官方文档：https://docs.anthropic.com/en/docs/claude-code

适合谁：

• 习惯在终端写代码的开发者
• 需要 AI 辅助代码审查、重构、调试的程序员
• 想用 AI 自动执行项目任务（跑测试、改配置、写文档）的人

国内使用的难点

Claude Code 默认连接 Anthropic 官方 API，国内直连会有以下问题：

• 网络不通或极慢，请求超时
• Anthropic 不对中国大陆开放服务，注册和付费受限
• 长时间使用容易断连

解决方案主要有两种：使用 API 中转服务 或 配置 HTTP 代理。

方式一：使用 API 中转（推荐）

如果你有自己的 API 中转站（比如用 New API 搭建的），或者购买了第三方中转服务，可以直接把 Claude Code 的 API 地址指向中转站。

1. 安装 Claude Code

需要 Node.js 18 或更高版本：

# 安装 Node.js（如果没有）
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

安装完成后验证：

claude --version

2. 配置中转 API 地址

设置环境变量，将 API 请求指向你的中转站：

# 临时生效（当前终端）
export ANTHROPIC_BASE_URL=https://your-api-proxy.com/v1

# 写入 bashrc 永久生效
echo 'export ANTHROPIC_BASE_URL=https://your-api-proxy.com/v1' >> ~/.bashrc
source ~/.bashrc

设置 API Key（中转站提供的 Key）：

export ANTHROPIC_API_KEY=sk-your-proxy-key-here
echo 'export ANTHROPIC_API_KEY=sk-your-proxy-key-here' >> ~/.bashrc
source ~/.bashrc

3. 测试连接

claude "你好，请自我介绍"

如果返回正常回复，说明中转配置成功。

方式二：配置 HTTP 代理

如果你有可用的 HTTP/SOCKS5 代理（比如自建的 V2Ray、Clash 等），可以让 Claude Code 通过代理连接官方 API。

1. 设置代理环境变量

# HTTP 代理
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

# SOCKS5 代理
export HTTPS_PROXY=socks5://127.0.0.1:7890

如果你的代理需要认证：

export HTTPS_PROXY=http://user:pass@127.0.0.1:7890

2. 设置 Anthropic API Key

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

注意：Anthropic API Key 需要能正常调用 API 的账号。如果你用的是中转站 Key，不要同时设代理和中转地址。

3. 验证代理

# 先测试代理是否通
curl -x http://127.0.0.1:7890 https://api.anthropic.com

# 再测试 Claude Code
claude "hello"

在项目中使用 Claude Code

1. 进入项目目录

cd /path/to/your/project

2. 启动 Claude Code

claude

进入交互模式后，你可以：

• 让它读代码：帮我看看 src/main.py 在做什么
• 让它改代码：把登录接口的超时时间改成 30 秒
• 让它执行命令：跑一下测试
• 让它搜索：找到所有用了 oldFunction 的地方

3. 常用命令

# 非交互模式，直接执行任务
claude "帮我给这个项目写 README"

# 通过管道传入内容
cat error.log | claude "分析这个错误日志"

# 指定文件
claude "review src/api.ts"

多账号切换

如果你有多个 API Key 或中转账号，可以用不同的环境变量配置文件切换：

# 创建配置文件
cat > ~/.claude-proxy-1.sh <<'EOF'
export ANTHROPIC_BASE_URL=https://proxy1.example.com/v1
export ANTHROPIC_API_KEY=sk-proxy1-key
EOF

cat > ~/.claude-proxy-2.sh <<'EOF'
export ANTHROPIC_BASE_URL=https://proxy2.example.com/v1
export ANTHROPIC_API_KEY=sk-proxy2-key
EOF

# 切换到 proxy-1
source ~/.claude-proxy-1.sh && claude

# 切换到 proxy-2
source ~/.claude-proxy-2.sh && claude

常见问题

Q1：安装时报 npm 权限错误

# 方法1：用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 方法2：修改 npm 全局目录（推荐）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Q2：启动后提示 “Connection refused” 或超时

• 检查 ANTHROPIC_BASE_URL 是否正确（中转方式）
• 检查代理是否正常运行（代理方式）
• 确认服务器能访问目标地址：curl $ANTHROPIC_BASE_URL
• 如果是中转站，检查中转站后台是否有可用的 Claude 模型渠道

Q3：提示 “Invalid API Key”

• 确认 Key 没有过期
• 确认 Key 和中转地址匹配（不同中转站的 Key 不通用）
• 环境变量是否生效：echo $ANTHROPIC_API_KEY

Q4：Claude Code 报错 “Rate limit exceeded”

• 中转站用户：联系中转站提升额度或换其他渠道
• 官方 Key 用户：等待速率限制重置，或升级 API 套餐
• 可以设置模型降级，在额度不足时自动切换到更便宜的模型

Q5：终端中文显示乱码

# 检查终端编码
locale

# 设置 UTF-8
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

小结

Claude Code 国内使用的关键是解决网络问题。自建中转站最稳定可控，代理方式适合已有科学上网工具的用户。建议用中转方式，配合 New API 等工具统一管理 Key 和额度。

来源：

• Claude Code 官方文档
• Claude Code GitHub