本文介绍了Anthropic开发的本地AI编程工具Claude Code的安装和使用方法，并提供了在国内网络环境下免费使用该工具的解决方案。文章详细阐述了安装Node.js、Claude Code，以及配置环境变量的步骤，同时推荐了API中转网站，解决了网络连接问题。此外，还提供了在VSCode中集成Claude Code插件的建议，并解答了常见问题，帮助用户更好地利用这款AI编程助手进行代码编写。

💻 **安装准备：** 首先，需要确保已安装Node.js（版本≥18.0）。对于Ubuntu/Debian用户，可以使用curl和apt-get进行安装；macOS用户则可以通过Homebrew安装。

🛠️ **安装Claude Code：** 接着，通过npm install -g @anthropic-ai/claude-code命令安装Claude Code，并使用claude --version命令验证安装是否成功。

🌐 **网络配置与免费使用：** 由于常规使用需要配置网络并支付费用，文章推荐使用API中转网站，例如anyrouter.top。用户注册后可获得免费额度，通过配置ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL环境变量，即可在国内网络环境下使用Claude Code。

⚙️ **环境变量配置：** 为了避免每次重复输入，建议将ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL写入.bash_profile、.bashrc或.zshrc文件中。重启终端后，即可直接使用claude命令启动Claude Code。

💡 **VSCode集成与常见问题解答：** 可以在VSCode中安装Claude Code插件，与本机运行的Claude Code联动。文章还解答了常见问题，如API报错、offline状态、网页Fetch失败等，帮助用户解决使用过程中遇到的问题。

Claude Code 是由 Anthropic 开发的可在本地运行的自动化 AI 编程工具，可以理解代码库、执行命令、自动化管理 Git 仓库，调用 MCP等等。

Claude Code官网：www.anthropic.com/claude-code

以下是Claude Code的安装方法及在国内网络环境下免费使用Claude Code的方法。

1️⃣ 安装 Node.js（已安装可跳过）

确保 Node.js 版本 ≥ 18.0

# Ubuntu / Debian 用户curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -sudo apt-get install -y nodejsnode --version# macOS 用户sudo xcode-select --install/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"brew install nodenode --version

2️⃣ 安装 Claude Code

npm install -g @anthropic-ai/claude-codeclaude --version

3️⃣ 开始使用

输入./claude后可以启动Claude code。(需要配置网络)

常规Claude code需要配置网络，且需要支付高昂的费用。推荐提供API中转的网站：anyrouter.top/register?af…目前该网站新人注册送100美刀，可以用不少时间了。下面是使用方法：

首先打开平台链接：anyrouter.top/register?af…可以直接使用GitHub进行登录，也可以注册账户登录获取Auth TOKEN

获取 Auth Token：  ANTHROPIC_AUTH_TOKEN ：注册后在 API令牌 页面点击 添加令牌 获得（以 sk- 开头）

名称随意，额度建议设为无限额度，其他保持默认设置即可

API地址：  ANTHROPIC_BASE_URL：https://anyrouter.top 是本站的 API 服务地址，与主站地址相同

在您的项目目录下运行：

cd your-project-folderexport ANTHROPIC_AUTH_TOKEN=sk-... export ANTHROPIC_BASE_URL=https://anyrouter.topclaude

开始在终端里和你的 AI 编程搭档一起写代码吧！🚀

4️⃣ 配置环境变量（推荐）

为避免每次重复输入，可将环境变量写入 bash_profile 和 bashrc：

echo -e '\n export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.bash_profileecho -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bash_profileecho -e '\n export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.bashrcecho -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bashrcecho -e '\n export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.zshrcecho -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.zshrc

重启终端后，直接使用：

cd your-project-folderclaude

即可使用 Claude Code

在VSCode中使用

安装 Claude Code插件，如果你本机成功运行了claude code这里会自动联动

右侧是Claude Code控制台区域，中间代码编辑区域

❓FAQ

本站直接接入官方 Claude Code 转发，无法转发非 Claude Code 的 API 流量

如遇 API 报错，可能是转发代理不稳定导致，可以考虑退出 Claude Code 重试几次

如果网页遇到登录错误可以尝试清除本站的 Cookie，重新登录

Invalid API Key · Please run /login 怎么解决？这表明 Claude Code 没有检测到 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量，检查环境变量是否配好。

显示 offline 是什么原因？Claude Code 会通过检查是否能连接到 Google 来对网络进行判断。显示 offline 并不影响正常使用 Claude Code，只是表明 Claude Code 未能连接 Google。

为什么浏览网页的 Fetch 会失败？这是因为 Claude Code 在访问网页前会调用 Claude 的服务来判断网页是否可以访问。需要保持国际互联网连接并进行全局代理，才可以访问 Claude 判断网页是否可以访问的服务。