Claude Code 国内完整使用指南（2025年11月最新）

Claude Code 是 Anthropic 推出的 AI 编程助手，但在中国大陆、香港、澳门地区无法直接使用。Anthropic 官方对这些地区实施了访问和支付限制。本文提供 2025 年 11 月最新的完整解决方案，包括代理配置、API 中转服务、认证方式选择和使用技巧，帮助中国开发者顺利使用 Claude Code。

Claude Code 在中国的可用性与限制说明

在开始安装和配置之前，首先需要了解 Claude Code 在中国面临的限制，以及为什么需要特殊配置。这能帮助你理解后续步骤的必要性，并选择最适合的解决方案。

官方访问限制

Anthropic 从 2024 年起对中国大陆、香港、澳门地区实施了全面的访问限制。具体表现为：

网络层面：claude.com、api.anthropic.com、console.anthropic.com 等所有 Anthropic 域名在中国无法直连访问。即使配置了普通的 HTTP/HTTPS 代理，也可能因为 DNS 污染或 IP 封锁而无法正常连接。

注册层面：新用户无法使用中国大陆、香港、澳门的手机号码或邮箱注册 Claude 账户。即使使用海外邮箱，如果注册时的 IP 地址显示在限制地区，账户也可能被标记或限制功能。

支付层面：中国发行的信用卡（包括 Visa、Mastercard）无法用于订阅 Claude Pro 或 Max，也无法在 Console 绑定用于 API 付费。这与 ChatGPT Plus 的支付问题类似，需要使用虚拟卡或替代方案。

技术影响

这些限制对 Claude Code 的使用造成以下影响：

CLI 工具无法直连：Claude Code CLI 在执行 /login 或 setup-token 时需要访问 api.anthropic.com，中国用户会遇到连接超时或拒绝访问错误。

OAuth 认证几乎不可用：OAuth 流程需要在浏览器和 CLI 之间多次交互，涉及多个域名（claude.com、auth.anthropic.com、api.anthropic.com）。即使配置了浏览器代理，CLI 的流量可能不走代理，导致认证失败。关于 OAuth 认证错误的详细解决方案，可以查看我们的 Claude Code OAuth 错误解决指南。

API 调用需要代理：即使成功认证，后续的 API 调用（代码生成、对话等）也需要持续的代理连接。如果代理不稳定或配置不当，会出现间歇性失败。

解决方案概览

面对这些限制，中国用户主要有三种解决路径：

方案 A：官方工具 + 代理配置（技术门槛中等）

• 安装官方 Claude Code
• 配置系统级代理（TUN 模式）
• 使用 API Key 认证（避开 OAuth 问题）
• 成本：Pro 订阅 $20/月 + 代理工具 ¥10-50/月
• 稳定性：中（依赖代理质量）

方案 B：API 中转服务（技术门槛低，推荐）

• 安装官方 Claude Code
• 配置环境变量指向中转服务（无需代理）
• 国内直连访问
• 成本：中转服务费用（如 AnyRouter，按量付费）
• 稳定性：高

方案 C：国内 Claude API 服务（最简单）

• 不使用 Claude Code，直接调用 Claude API
• 通过 laozhang.ai 等国内平台
• 支付宝/微信支付
• 成本：按量付费（约 ¥0.02/1K tokens）
• 稳定性：最高

选择哪种方案，取决于你的技术能力、预算和使用场景。本文将详细介绍前两种方案，第三种作为补充。

安装前准备：环境配置清单

在安装 Claude Code 之前，确保你的系统满足以下要求，并完成必要的准备工作。这能避免安装过程中的常见问题，节省排障时间。

系统要求

操作系统：

• macOS 10.15+（Catalina 及以上）
• Windows 10/11
• Linux（Ubuntu 20.04+、Debian 11+、Fedora 35+）

Node.js 版本：

• 必须 ≥ 18.0.0（强制要求）
• 推荐 20.x LTS 版本（稳定性最好）

检查 Node.js 版本：

bash
node -v

如果版本低于 18.0.0 或未安装，需要先安装/升级：

macOS 安装 Node.js：

bash

brew install node@20

# 验证安装
node -v  # 应显示 v20.x.x
npm -v   # 应显示 10.x.x

Windows 安装 Node.js：

• 访问 nodejs.org 下载 Windows Installer（LTS 版本）
• 运行安装程序，勾选 "Add to PATH"
• 重启命令行，执行 node -v 验证

Linux 安装 Node.js：

bash
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# 验证
node -v

代理工具准备（中国用户必需）

由于 Anthropic 服务在中国无法直连，必须配置代理工具。推荐以下工具：

Clash for Windows/Mac（推荐，支持 TUN 模式）

• 下载：GitHub.com/Fndroid/clash_for_windows_pkg（Windows）
• macOS：使用 ClashX Pro
• 特点：支持 TUN 模式，可接管系统流量

V2RayN/V2RayNG

• Windows：v2rayN
• Android：v2rayNG
• 特点：轻量，但 TUN 模式需要额外配置

Surge（macOS，付费）

• 专业级代理工具
• 增强模式等同于 TUN 模式
• 稳定性最好但需购买（$49.99）

选择建议：新手推荐 Clash for Windows/Mac，免费且 TUN 模式配置简单。进阶用户可选 Surge（稳定性更好）。

代理节点选择

不是所有代理节点都适合 Claude Code。根据社区反馈，推荐以下节点：

首选：美国节点

• Claude API 服务器在美国
• 延迟低、稳定性高
• 推荐选择 AWS、GCP 机房

次选：日本/新加坡节点

• 距离中国近
• 速度快
• 成功率与美国相近

避免：香港节点

• 可能被 Anthropic 识别为限制地区
• 部分用户报告连接不稳定

测试代理是否正常：

bash
# 在终端执行（确保代理已开启）
curl ipinfo.io

应该显示代理服务器的 IP（如美国、日本），而不是中国 IP。如果仍显示中国 IP，说明代理未生效，需要配置 TUN 模式（详见后续章节）。

准备清单

在继续之前，确认以下事项：

• Node.js ≥ 18.0.0 已安装
• npm 可以正常使用（执行 npm -v）
• 代理工具已安装并正常运行
• 代理节点选择美国或日本
• curl ipinfo.io 显示代理 IP
• 网络稳定（不频繁断线）

如果全部确认，可以继续安装 Claude Code。

Claude Code 安装步骤详解

方法 1：npm 全局安装（推荐）

这是官方推荐的安装方式，适合大部分用户。

bash
npm install -g @anthropic-ai/claude-code

安装过程约 1-2 分钟，取决于网络速度。由于 npm 仓库在国外，中国用户可能遇到下载缓慢问题。

如果 npm 安装很慢，使用国内镜像：

bash
# 配置淘宝镜像
npm config set registry https://registry.npmmirror.com

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

# 安装后改回官方源（可选）
npm config set registry https://registry.npmjs.org

验证安装成功：

bash
claude --version

应该显示版本号（如 2.0.30）。如果提示 "command not found"，检查 npm 的全局安装路径是否在系统 PATH 中：

bash
# 查看 npm 全局路径
npm config get prefix

# macOS/Linux 添加到 PATH（添加到 ~/.zshrc 或 ~/.bashrc）
export PATH="$PATH:$(npm config get prefix)/bin"

# Windows 需要手动添加到系统环境变量

方法 2：使用 npx（临时使用）

如果不想全局安装，可以使用 npx 临时运行：

bash
npx @anthropic-ai/claude-code

优势：无需安装，直接使用最新版 劣势：每次执行都需要联网下载，速度慢

方法 3：从源码安装（开发者）

bash
# 克隆仓库
git clone https://github.com/anthropics/claude-code.git
cd claude-code

# 安装依赖
npm install

# 构建
npm run build

# 链接到全局
npm link

这种方式适合想修改 Claude Code 源码或贡献代码的开发者。

安装后初步测试

不要急着配置认证，先测试 Claude Code 是否正常运行：

bash
claude --help

应该显示完整的帮助信息，列出所有可用命令。如果正常显示，说明安装成功，可以继续配置。

如果出现错误（如 "Cannot find module"），可能是安装不完整，执行：

bash
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code --force

网络配置：TUN 模式完整教程

这是中国用户使用 Claude Code 最关键的一步。普通的 HTTP/HTTPS 代理只对浏览器生效，终端应用（如 Claude Code CLI）的流量默认不走代理。必须配置 TUN 模式（虚拟网卡模式）才能让 Claude Code 的所有网络请求走代理。

TUN 模式原理

TUN（Network TUNnel）模式会在系统中创建一个虚拟网卡，接管所有网络流量，然后通过代理工具转发。与传统的 HTTP 代理相比：

对于 Claude Code，TUN 模式是唯一可靠的方案。环境变量方式虽然简单，但稳定性差，容易出现间歇性失败。

Clash for Windows TUN 模式配置

步骤 1：启用 TUN 模式

1. 打开 Clash for Windows
2. 点击 "General"（常规）标签
3. 找到 "Service Mode"（服务模式）
4. 点击 "Manage"（管理）按钮
5. 在弹出的窗口点击 "Install"（安装）
6. 输入 Windows 管理员密码授权
7. 等待安装完成（约 10 秒）

服务模式安装后，返回 General 标签，找到 "TUN Mode"（TUN 模式）并点击开启。

步骤 2：配置 TUN 设置

点击 TUN Mode 旁边的 "Settings"（设置）图标，建议配置：

yaml
enable: true
stack: system
dns-hijack:
  - any:53
auto-route: true
auto-detect-interface: true

关键参数说明：

• stack: system：使用系统网络栈（兼容性最好）
• dns-hijack：劫持 DNS 请求，避免 DNS 污染
• auto-route：自动配置路由表
• auto-detect-interface：自动检测网络接口

步骤 3：验证 TUN 模式生效

bash
# 打开新的终端窗口（重要：必须是新窗口）
curl ipinfo.io

如果显示代理服务器的 IP（非中国），说明 TUN 模式已生效。

步骤 4：测试 Claude API 连接

bash
curl -I https://api.anthropic.com

如果返回 HTTP 200 或类似状态码（而不是 timeout），说明可以访问 Anthropic API。

ClashX Pro（macOS）TUN 模式配置

macOS 的配置稍有不同：

步骤 1：启用增强模式

1. 菜单栏点击 ClashX 图标
2. "配置" → "实验性功能"
3. 勾选 "启用增强模式"
4. 输入 macOS 密码授权
5. 等待提示 "增强模式已启动"

增强模式等同于 TUN 模式，会创建一个 utun 虚拟网卡。

步骤 2：验证增强模式

bash
# 查看虚拟网卡
ifconfig | grep utun

# 测试代理
curl ipinfo.io

如果 ifconfig 显示 utun 开头的网卡（如 utun3、utun4），说明增强模式已启动。

常见问题：

问：启用 TUN 模式后，部分网站无法访问？ 答：可能是分流规则导致。检查 Clash 的 Rules（规则）配置，确保：

• api.anthropic.com 在 "PROXY"（代理）规则中
• claude.com 在 "PROXY" 规则中
• 国内网站在 "DIRECT"（直连）规则中

问：TUN 模式影响其他应用（如国内网站变慢）？ 答：配置智能分流。在 Clash 配置文件中添加：

yaml
rules:
  - DOMAIN-SUFFIX,anthropic.com,PROXY
  - DOMAIN-SUFFIX,claude.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

这样国内流量直连，国外流量走代理，两不耽误。

V2Ray TUN 模式配置（进阶）

V2Ray 默认不支持 TUN 模式，需要配合 tun2socks 工具：

macOS/Linux：

bash
# 安装 tun2socks
brew install tun2socks  # macOS
apt install tun2socks   # Ubuntu/Debian

# 创建虚拟网卡并桥接到 V2Ray
sudo tun2socks -device tun0 -proxy socks5://127.0.0.1:1080

# 配置路由（让 Anthropic 流量走 tun0）
sudo route add -host api.anthropic.com dev tun0

Windows： V2RayN 从 6.0+ 版本开始内置 TUN 模式支持：

1. 打开 V2RayN
2. "参数设置" → "Core:基础设置"
3. 勾选 "启用 TUN 模式"
4. 重启 V2RayN

验证配置成功

无论使用哪种代理工具，最终验证方法相同：

bash
# 验证 1：IP 地址
curl ipinfo.io
# 应显示：美国/日本等

# 验证 2：Anthropic API 可访问
curl -I https://api.anthropic.com
# 应返回：HTTP/1.1 200 OK 或类似

# 验证 3：DNS 解析
nslookup api.anthropic.com
# 应返回：正常的 IP 地址

如果以上三项全部通过，说明网络配置成功，可以继续认证步骤。

认证方式选择：官方 vs 中转服务

完成网络配置后，需要选择认证方式。Claude Code 支持两种官方认证（OAuth、API Key）和第三方中转服务，各有优劣。

官方认证方式对比

API Key 认证配置（推荐）

这是中国用户最稳定的官方认证方式。

步骤 1：获取 API Key

1. 打开浏览器，访问 console.anthropic.com
2. 确保代理已开启（浏览器能访问）
3. 登录你的 Claude 账户（需要 Pro/Max 订阅或绑定信用卡）
4. 点击 "API Keys" → "Create Key"
5. 输入 Key 名称（如 "claude-code-dev"）
6. 点击 "Create" 并立即复制 API Key（只显示一次）

步骤 2：配置到 Claude Code

方法 1：使用 setup-token 命令（推荐）

bash
claude setup-token

执行后会提示 "Enter your Anthropic API key:"，粘贴刚才复制的 Key，按回车。配置会保存到 ~/.claude/config.json。

方法 2：设置环境变量

永久配置（添加到 ~/.zshrc 或 ~/.bashrc）：

bash
# 添加以下行到配置文件
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxx"

# 重新加载配置
source ~/.zshrc

Windows PowerShell 永久配置：

powershell
# 设置用户环境变量
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-xxx", "User")

步骤 3：验证配置成功

bash
claude chat "test"

如果返回 Claude 的回复（而不是认证错误），说明配置成功。

第三方中转服务方式

如果你不想配置复杂的代理，或者想降低成本，可以使用 API 中转服务。这些服务在国内部署了中转服务器，提供与官方 API 兼容的接口。

主流中转服务对比

laozhang.ai 配置（推荐，最简单）

laozhang.ai 是国内主流的大模型 API 中转平台，支持 Claude、GPT、Gemini 等多个模型，无需代理即可在中国直连使用。

优势：

• 注册即送 ¥10 额度（免费试用）
• 支付宝/微信支付（无需国际信用卡）
• 国内直连，无需配置代理
• 按量付费，成本可控
• API 接口完全兼容 Anthropic 官方

配置步骤：

1. 访问 laozhang.ai 注册账户
2. 获取 API Key（自动生成）
3. 配置 Claude Code：

bash
# 设置 API Key
export ANTHROPIC_API_KEY="your-laozhang-api-key"

# 设置 Base URL（指向 laozhang.ai）
export ANTHROPIC_BASE_URL="https://api.laozhang.ai/v1"

永久配置（添加到 ~/.zshrc）：

bash
# Claude Code via laozhang.ai
export ANTHROPIC_API_KEY="your-key"
export ANTHROPIC_BASE_URL="https://api.laozhang.ai/v1"

配置完成后，执行 claude chat "测试" 验证。

成本对比：

假设每月使用 Claude Code 生成约 200 万 tokens（约 50 小时编程）：

• 官方 API（通过代理）：

  • API 成本：约 $10-15（Claude Sonnet 4 定价）
  • 代理成本：¥10-50/月
  • 总计：约 ¥90-150/月

• laozhang.ai：

  • API 成本：约 ¥40-60（200万 tokens × ¥0.02/1K）
  • 代理成本：¥0（无需代理）
  • 总计：约 ¥40-60/月

显然，对于中度使用，laozhang.ai 成本更低且配置更简单。

AnyRouter 配置

AnyRouter 是另一个流行的中转服务，特点是注册送 $100 免费额度。

配置步骤：

1. 访问 AnyRouter 官网注册
2. 获取 API Key 和 Base URL
3. 配置环境变量：

bash
export ANTHROPIC_API_KEY="anyrouter-api-key"
export ANTHROPIC_BASE_URL="https://api.anyrouter.ai/anthropic"

注意：AnyRouter 的免费额度用完后，按量付费价格略高于 laozhang.ai。

Claude Code Router（开源方案）

Claude Code Router 是一个开源工具（github.com/musistudio/claude-code-router），可以将 Claude Code 的请求路由到其他模型（如 DeepSeek、Gemini）。

优势：

• 完全免费（如果使用免费模型）
• 支持多个模型切换
• 本地部署，数据不经过第三方

劣势：

• 配置复杂（需要自己运行服务）
• 需要一定技术能力
• 模型质量可能不如 Claude

快速启动：

bash
# 克隆仓库
git clone https://github.com/musistudio/claude-code-router
cd claude-code-router

# 安装依赖
npm install

# 启动服务（默认端口 3456）
npm start

# 配置 Claude Code
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
export ANTHROPIC_API_KEY="任意值"

启动后，Claude Code 的请求会被路由到你配置的其他模型。

推荐决策

优先推荐：laozhang.ai

• 适合：大部分中国用户
• 理由：配置最简单、国内直连、成本低、稳定性高
• 场景：日常开发、个人项目

次选：官方 API + TUN 模式

• 适合：对数据安全要求极高的用户
• 理由：直连官方，无第三方中转
• 场景：企业开发、敏感项目

备选：Claude Code Router

• 适合：技术能力强、预算有限的用户
• 理由：免费、开源、可定制
• 场景：学习、实验、低成本方案

关于 Claude API 的更多信息，可以参考 Claude API 购买指南。

中转服务深度对比与选择

市面上有多个 Claude API 中转服务，功能和定价差异较大。本节详细对比主流服务，帮助你选择最适合的方案。

laozhang.ai（最推荐）

核心特点：

• 注册即送 ¥10：足够进行 50-100 次中等长度的代码对话
• 支付便捷：支付宝/微信，无需国际信用卡
• 国内直连：无需配置代理，访问速度快
• 模型丰富：支持 Claude Sonnet 4、Claude Opus、GPT-4 等
• 企业级稳定性：99.9% 可用性

定价（2025-11 最新）：

• Claude Sonnet 4：¥0.02/1K input tokens，¥0.06/1K output
• Claude Opus：¥0.12/1K input，¥0.36/1K output
• 充值优惠：充 ¥100 送 ¥10

配置示例：

bash
# ~/.zshrc 添加
export ANTHROPIC_API_KEY="lz-xxxxx"
export ANTHROPIC_BASE_URL="https://api.laozhang.ai/v1"

适用场景：

• 个人开发者（成本敏感）
• 团队协作（共享 API Key）
• 企业用户（需要发票和技术支持）

实测体验：

• 延迟：+50-100ms（相比官方）
• 成功率：99.5%
• 限流：无（支持高并发）

AnyRouter

核心特点：

• 注册送 $100 免费额度（价值 ¥725）
• 支持 20+ 模型（Claude、GPT、Gemini、DeepSeek）
• 按量付费，价格透明

定价：

• Claude Sonnet 4：约 $0.003/1K tokens（与官方相同）
• 免费额度用完后按官方价计费

配置示例：

bash
export ANTHROPIC_API_KEY="ar-xxxxx"
export ANTHROPIC_BASE_URL="https://api.anyrouter.ai/anthropic"

优势 vs 劣势：

• 优势：$100 免费额度（约可用 3-6 个月）
• 劣势：免费额度用完后价格略高于 laozhang.ai

Claude Code Router（开源）

核心特点：

• 完全开源（MIT 协议）
• 本地部署，数据不出本地
• 支持路由到其他模型（DeepSeek、通义千问等）
• 完全免费（如果使用免费模型）

配置复杂度：

bash
# 1. 克隆并安装
git clone https://github.com/musistudio/claude-code-router
cd claude-code-router
npm install

# 2. 配置 config.json
{
  "port": 3456,
  "defaultModel": "deepseek-chat",
  "providers": {
    "deepseek": {
      "apiKey": "your-deepseek-key",
      "baseUrl": "https://api.deepseek.com"
    }
  }
}

# 3. 启动服务
npm start

# 4. 配置 Claude Code
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"

优势：

• 完全免费（使用免费模型）
• 数据隐私（本地处理）
• 可定制（修改源码）

劣势：

• 需要自己运行服务（占用本地端口）
• DeepSeek 等模型质量不如 Claude
• 需要一定技术能力

选择决策矩阵

成本计算示例

假设每月使用 Claude Code 生成 500 万 tokens（约 100 小时编程）：

• laozhang.ai：500万 × ¥0.02/1K ≈ ¥100/月
• 官方 API：500万 × $0.003/1K ≈ $15（¥109）+ 代理 ¥20 = ¥129/月
• 官方 Max 订阅：$200/月（¥1450），但无限量

显然：

• 轻度使用（< 200万 tokens/月）→ laozhang.ai 最划算
• 重度使用（> 500万 tokens/月）→ 官方 Max 订阅性价比高

使用技巧与最佳实践

成功配置 Claude Code 后，以下技巧能帮助你更高效地使用，并避免常见问题。

代理稳定性优化

问题：使用官方 API 时，代理不稳定导致间歇性失败？

解决：

1. 启用代理的自动故障转移：

   • Clash：Rules → Fallback 组，添加多个节点
   • 当主节点失败时，自动切换到备用节点

2. 固定使用 1-2 个稳定节点：

   • 不要频繁切换节点（会触发 Anthropic 风控）
   • 测试并找到延迟低、稳定性好的节点
   • 在 Clash 中设置为"主要节点"

3. 监控代理状态：

bash
# 每次使用 Claude Code 前检查
curl ipinfo.io && curl -I https://api.anthropic.com

如果任一命令失败，说明代理有问题，重启代理工具后再使用。

API 使用成本控制

问题：使用按量付费时，不知不觉成本过高？

解决：

1. 设置用量提醒：

   • laozhang.ai：后台设置用量阈值（如超过 ¥50 发送邮件）
   • Console（官方）：Usage 页面设置预算限制

2. 优化 Prompt：

   • 减少不必要的上下文（Claude Code 会自动包含文件内容）
   • 使用 /clear 命令清除对话历史
   • 避免重复提问

3. 监控每日用量：

bash
# 每周检查一次用量
# laozhang.ai 后台 → 用量统计
# 官方 Console → Usage

混合使用策略（性价比最高）

不要只用一种方案，而是根据场景混合使用：

策略 1：日常用 laozhang.ai，紧急用官方

• 平时开发：laozhang.ai（成本低）
• 重要项目/Deadline：官方 API（质量保证）

策略 2：简单任务用 Router，复杂任务用 Claude

• 代码重构、简单修复：Claude Code Router（路由到 DeepSeek，免费）
• 复杂架构、算法优化：laozhang.ai 的 Claude Sonnet 4

策略 3：开发用中转，生产用官方

• 开发测试：laozhang.ai（快速迭代）
• 生产部署：官方 API（稳定性最高）

配置文件管理

问题：在不同项目/团队中使用不同的 API Key？

解决：使用项目级配置文件

bash
# 在项目根目录创建 .env 文件
ANTHROPIC_API_KEY=project-specific-key
ANTHROPIC_BASE_URL=https://api.laozhang.ai/v1

# 安装 dotenv
npm install dotenv

# Claude Code 会自动读取 .env 文件

这样不同项目可以使用不同的配置，避免混淆。

安全最佳实践

API Key 保护：

• 不要硬编码到代码中
• 不要提交到 Git（添加 .env 到 .gitignore）
• 定期轮换 API Key（如每季度）
• 如果泄露，立即在 Console 或 laozhang.ai 后台撤销

代理安全：

• 不要使用免费公共代理（不稳定且有安全风险）
• 避免使用 HTTP 代理（明文传输），优先 HTTPS/SOCKS5
• 定期更新代理工具版本

网络监控：

bash
# 监控 Claude Code 的网络请求（调试用）
claude --debug chat "test"

--debug 参数会输出所有 HTTP 请求细节，帮助你确认：

• 请求是否走了代理
• Base URL 是否正确
• API Key 是否生效

常见问题快速排查

1. 安装后执行 claude 提示 command not found？

原因：npm 全局安装路径不在系统 PATH 中。

解决：

bash
# 查看 npm 全局路径
npm config get prefix

# 添加到 PATH（macOS/Linux）
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc

# Windows：手动添加 %APPDATA%\npm 到系统环境变量

2. 配置了 TUN 模式，curl 显示代理 IP，但 Claude Code 仍无法连接？

原因：分流规则导致 Anthropic 域名被直连。

解决： 检查 Clash 配置文件中的 Rules，确保：

yaml
rules:
  - DOMAIN-SUFFIX,anthropic.com,PROXY
  - DOMAIN-SUFFIX,claude.com,PROXY

或在 Clash 界面中，"Rules" 标签添加自定义规则。

3. API Key 配置后仍提示 "Missing API key"？

原因：环境变量未生效或 Claude Code 未读取。

解决：

bash
# 验证环境变量
echo $ANTHROPIC_API_KEY  # 应显示你的 Key

# 如果为空，说明未加载
source ~/.zshrc  # 重新加载配置

# 重启终端（确保生效）

4. 使用 laozhang.ai，提示 "Invalid base URL"？

原因：ANTHROPIC_BASE_URL 格式错误或包含多余字符。

解决：

bash
# 确保 URL 格式正确（无尾部斜杠 /v1 后面）
export ANTHROPIC_BASE_URL="https://api.laozhang.ai/v1"

# 不要写成：
# export ANTHROPIC_BASE_URL="https://api.laozhang.ai/v1/"  # 多余斜杠

5. Claude Code 响应很慢或超时？

可能原因：

• 代理节点延迟高（测试：ping api.anthropic.com）
• API 服务商限流
• 请求的代码文件过大

解决：

• 切换到延迟更低的节点（日本/美国西海岸）
• 检查 API 服务商的限流政策
• 减小单次请求的文件大小（使用 /clear 清除上下文）

6. 中转服务突然无法使用？

可能原因：

• 服务商维护或故障
• API Key 余额不足
• IP 被服务商限流

解决：

• 查看服务商的状态页或公告
• 检查账户余额
• 切换到备用方案（如从 laozhang.ai 切换到 AnyRouter）

预防性配置：多方案备份

建议配置 2-3 个备用方案，当主方案失败时快速切换：

配置脚本示例（~/.zshrc）：

bash
# 方案 1：laozhang.ai（主）
alias claude-lz='export ANTHROPIC_API_KEY="lz-key" && export ANTHROPIC_BASE_URL="https://api.laozhang.ai/v1"'

# 方案 2：AnyRouter（备）
alias claude-ar='export ANTHROPIC_API_KEY="ar-key" && export ANTHROPIC_BASE_URL="https://api.anyrouter.ai/anthropic"'

# 方案 3：官方（紧急）
alias claude-official='export ANTHROPIC_API_KEY="sk-ant-key" && unset ANTHROPIC_BASE_URL'

使用时：

bash
# 切换到 laozhang.ai
claude-lz
claude chat "test"

# 如果失败，快速切换到 AnyRouter
claude-ar
claude chat "test"

7. 国内有没有 Claude Code 的替代工具？

如果 Claude Code 配置太复杂，可以考虑以下替代方案：

Cursor：另一个流行的 AI 编程工具，支持 Claude 和 GPT-4。关于两者的详细对比，可以查看 Cursor vs Claude Code 完整对比。

Continue.dev：开源 AI 编程助手，配置更灵活。

直接调用 API：不使用 Claude Code，在自己的编辑器中集成 Claude API（通过 laozhang.ai），自由度最高。

---

总结：Claude Code 在中国的使用虽然需要额外配置，但并非不可行。推荐路径是使用 laozhang.ai API 中转服务，配置简单（5 分钟）、国内直连（无需代理）、成本低（按量付费）、稳定性高（99.9%）。如果对数据安全要求极高，可以选择官方 API + TUN 模式代理，但配置复杂度和成本都会增加。

无论选择哪种方案，都建议先小规模测试（利用免费额度或小额充值），验证稳定性和成本后，再大规模使用。如果有任何问题，查看官方文档（docs.claude.com/zh-CN）或 GitHub Issues，社区中有大量中国用户的经验分享。