Claude Code 本地环境搭建与 API 接入指南
目前访问 Claude 主要有两种途径：官方直接订阅或第三方 API 中转。对于个人开发者而言，通过 API 网关配置环境变量往往更具灵活性，也能有效降低使用门槛。
账号准备
首先需要注册一个支持的服务账户。以 LinuxDo 为例，这是目前许多 API 服务常用的认证入口。
- 访问 LinuxDo 官网进行注册。
- 填写申请理由时建议如实描述需求，避免过于随意，以提高审核通过率。
- 若遇到邀请码失效的情况，通常可在注册页面寻找相关获取入口。
获取 API 凭证
完成基础注册后，即可在 API 服务商后台获取访问令牌。
- 登录服务商控制台（如 AnyRouter）。
- 进入左侧菜单的 API 令牌 管理页面。
- 点击 添加令牌，按照界面提示生成新的 Token。
- 复制生成的密钥字符串，后续配置将用到。
注意：部分平台可能需要特定的网络环境才能正常访问控制台，请确保网络连接稳定。
配置环境变量
为了让命令行工具自动识别 API 地址和密钥，需要设置系统环境变量。以下以 Windows 系统为例，Linux 和 macOS 原理相同。
1. 打开环境变量设置
- 右键点击 此电脑 -> 属性 -> 高级系统设置 -> 高级 -> 环境变量。
- 或者直接在搜索框输入'环境变量'快速进入。
2. 新建系统变量
在 系统变量 区域点击 新建，依次添加以下两项：
| 变量名 | 变量值 |
|---|---|
ANTHROPIC_AUTH_TOKEN | 填入上一步获取的 API 密钥（通常以 sk-开头） |
ANTHROPIC_BASE_URL | 填入服务商提供的 API 接口地址 |
配置完成后，建议重启终端或重新登录系统以确保变量生效。
安装与运行
确保本地已安装 Node.js 环境，版本建议在 18 及以上，以避免兼容性问题。
npm install -g @anthropic-ai/claude-code
安装成功后，可通过以下命令验证版本：
claude --version
如果显示版本号且无报错，说明环境配置正确。此时即可在终端中直接使用 Claude 指令进行交互。
常见问题排查
- 环境变量不生效：检查是否修改的是系统变量而非用户变量，并确认终端是否已重启。
- Node 版本过低：升级 Node.js 至 LTS 版本。
- Token 无效：返回服务商后台重新生成令牌，注意不要包含多余空格。
通过以上步骤，即可在本地构建起稳定的 AI 编程辅助环境，提升开发效率。
