Claude Code 本地环境配置与使用指南
目前 Claude 的官方渠道成本较高，对于开发者而言，通过 API 网关进行中转配置是一种可行的替代方案。这种方式相当于在本地 CLI 和云端服务之间建立了一个中间层，能够灵活管理访问权限。
1. 获取访问凭证
首先需要注册并登录相关的服务平台以获取 API 令牌。目前部分平台已不再支持 GitHub 直接登录，建议优先使用邮箱或社区账户体系。
- 平台入口：访问相关社区官网进行注册。
- 邀请机制：若遇到邀请码限制，通常可以在注册页面找到申请入口，填写合理的理由即可提交审核。
注意：注册时请认真填写申请理由，避免随意输入字符，以提高通过率。
2. 配置 API 令牌
登录成功后，进入控制台查找 API 管理模块。
- 点击左侧菜单中的 API 令牌 选项。
- 选择 添加令牌 按钮。
- 按照界面指引完成配置，确保勾选必要的权限范围。
- 保存生成的令牌字符串，后续将用于环境变量配置。
3. 设置系统环境变量
为了让 Claude CLI 识别自定义的 API 地址和认证信息，需要在操作系统中配置环境变量。以下以 Windows 环境为例。
配置步骤
-
打开 此电脑 -> 属性 -> 高级系统设置 -> 高级 -> 环境变量。
-
在 系统变量 区域点击 新建。
-
依次添加以下两个变量（具体值需根据实际获取的凭证填写）：
ANTHROPIC_AUTH_TOKEN：填入上一步获取的 API 令牌（通常以 sk- 开头）。ANTHROPIC_BASE_URL：填入 API 网关提供的完整请求地址。
生效提示
配置完成后，环境变量通常需要重启终端会话或重启计算机才能完全生效。如果立即测试未成功，请先尝试重启命令行窗口。
4. 安装与验证
确保本地 Node.js 版本不低于 18，否则可能会在安装过程中报错。
npm install -g @anthropic-ai/claude-code
安装完成后，可以通过以下命令检查版本号，确认安装是否成功：
claude --version
5. 开始使用
当环境变量配置正确且工具安装完毕后，即可在终端直接使用 Claude 指令。如果遇到连接问题，请再次检查环境变量名称拼写及令牌有效性。
温馨提示：在使用第三方 API 服务时，请注意账号安全及合规性。定期更新令牌，避免泄露敏感信息。
