Claude Code 本地安装与环境变量配置指南
目前,Anthropic 官方提供了 Claude Code 的命令行工具,方便开发者在终端直接调用模型能力。除了官方渠道外,部分开发者也会通过第三方 API 中转服务来降低使用成本。本文将介绍如何在 Windows 环境下完成本地环境的搭建与基础配置。
前置准备
确保你的系统已安装 Node.js,版本建议不低于 v18,否则在安装过程中可能会遇到兼容性问题。可以通过以下命令检查版本:
node -v
安装 CLI 工具
使用 npm 全局安装 Anthropic 提供的 CLI 包。安装完成后,可以通过版本号确认是否成功:
npm install -g @anthropic-ai/claude-code
claude --version
如果显示版本号,说明安装无误。
配置环境变量
为了让 CLI 工具能够识别 API 凭证和请求地址,需要在系统环境变量中设置两个关键参数。以 Windows 为例,路径为:此电脑 -> 属性 -> 高级系统设置 -> 高级 -> 环境变量。
添加以下两个系统变量:
- ANTHROPIC_AUTH_TOKEN:填入你的 API 密钥(Token)。
- ANTHROPIC_BASE_URL:填入 API 服务的接入地址。
配置完成后,建议重启终端或重新登录系统以确保环境变量生效。
验证与使用
配置完毕后,即可在终端尝试连接。通常运行简单的指令即可验证连通性。如果遇到权限或网络问题,请检查 Token 的有效性以及 Base URL 的可达性。
注意:API 服务的具体获取方式取决于你选择的供应商,请确保遵守相关服务条款。


