Claude Code 本地环境配置与使用指南
除了官方直接调用，开发者也可以通过第三方 API 代理服务来集成 Claude。这种方式通常能提供更灵活的接入体验，适合需要本地 CLI 工具进行交互的场景。
1. 准备账户与凭证
首先需要注册一个支持该服务的平台账户。目前部分平台可能不再支持 GitHub 登录，建议直接使用邮箱或特定社区账号注册。注册完成后，进入控制台获取 API 令牌（API Token）。
在管理界面中找到 API 令牌 选项，点击添加新令牌。配置时注意选择对应的模型权限，确认后即可生成一串以 sk- 开头的密钥字符串。请妥善保管，不要泄露给他人。
2. 配置环境变量
为了在命令行中直接调用，我们需要设置系统环境变量。这一步非常关键，如果配置不当会导致连接失败。
Windows 用户
打开系统属性中的环境变量设置：
- 右键点击'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。
- 在'系统变量'区域新建两个变量。
具体配置如下：
| 变量名 | 值 |
|---|---|
| ANTHROPIC_AUTH_TOKEN | sk-你的 API 令牌 |
| ANTHROPIC_BASE_URL | 你的 API 代理地址 |
注意：配置完成后务必重启终端或重新登录系统，否则环境变量无法生效。
Linux / macOS 用户
可以在 ~/.bashrc 或 ~/.zshrc 中添加以下行：
export ANTHROPIC_AUTH_TOKEN="sk-你的 API 令牌"
export ANTHROPIC_BASE_URL="你的 API 代理地址"
source ~/.bashrc
3. 安装与运行
确保你的 Node.js 版本不低于 18，这是运行该工具的前提条件。可以通过 node -v 检查当前版本。
使用 npm 全局安装 claude-code 包：
npm install -g @anthropic-ai/claude-code
安装成功后，再次运行命令查看版本号，确认没有报错。
4. 验证连接
安装完成后，尝试运行基础命令。如果环境变量配置正确，工具会自动读取令牌并建立连接。
claude --version
若显示版本号且无认证错误，说明配置成功。此时即可开始使用本地终端与 AI 模型进行交互了。
常见问题排查
- 环境变量不生效：大多数情况下是因为终端未刷新，请尝试重启终端窗口。
- Node 版本过低：请升级 Node.js 至 18.x 以上版本。
- Token 无效：检查是否复制了完整的密钥字符串，注意不要包含多余的空格。
通过上述步骤，你就可以在本地环境中顺畅地使用 Claude Code 进行开发了。
