使用Bedrock为Windows环境上的Claude Code提供模型服务

一、背景

Claude Code是Anthropic官方推出的命令行CLI下的AI Agent界面工具，能够直接在终端中协助完成各类开发和技术工作。Claude Code具有读写文件、执行命令、搜索代码库等丰富功能，能够理解代码上下文，提供精准的技术建议，显著提升开发效率。它支持多种编程语言和框架，适合各类软件开发场景。Claude Code主要使用环境为MacOS/Linux环境，也提供了Windows版本，通过使用mingw64库的Windows bash环境运行。

Claude Code一般要求拥有Anthropic官网账号和订阅才可以工作。Claude Code也提供了使用Amazon Bedrock上的Claude作为模型服务的选项，此时，使用者无需注册Anthropic官网，而是直接配置Bedrock的API Key即可使用。不过，由于Anthropic在2025年9月禁用了位于中国大陆地区的访问，因此使用Amazon Bedrock的Claude的前提是必须有海外实体申请注册AWS账户，并且发起访问请求的IP地址必须位于中国大陆以外的地区。在满足这个情况下，即可使用Bedrock为Claude Code提供服务。

下面开始配置。

二、安装Git和bash

1、软件包

Claude Code在Windows上依赖Bash的Windows版本，因此需要安装Git。从如下地址下载git并安装。

https://git-scm.com/install/windows

一路继续，所有选项都使用default的，不要修改。

程序可能会被安装到：

没进入Active Domain活动目录的普通Windows：C:\Program Files\Git\bin\git.exe
公司客户端带Active Domain活动目录Windows：C:\Users\your-user-name\appdata\local\Program Files\Git\cmd\git.exe

同样这个目录下还会安装bash.exe。

2、使用Powershell设置环境变量

打开Windows的Powershell，输入如下命令，添加“用户级”环境变量。注意这个路径必须与上一步安装路径一致。

[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Program Files\Git\bin", "User")

设置完成后，重新打开PowerShell窗口使环境变量生效。

三、安装NodeJS包管理工具

Claude Code 官网提供了Powershell脚本用于在Windows下安装，但是其网络下载可能不稳定，建议用NodeJS包管理工具来安装更加稳定。从如下页面下载：

https://nodejs.org/en/download

所有安装选项保持默认不需要修改，一路继续安装成功。

四、安装Claude Code

1、使用Powershell设置Bedrock参数

首先设置需要的环境变量:

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_USE_BEDROCK", "1", "User")
[Environment]::SetEnvironmentVariable("AWS_REGION", "us-west-2", "User")
[Environment]::SetEnvironmentVariable("AWS_BEARER_TOKEN_BEDROCK", "xxxx-xxxx-xxxx-xxxx-xxx", "User")

2、使用Powershell配置环境变量

[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Users\Administrator\.local\bin", "User")

3、使用cmd安装软件包

注意：以上命令均为Powershell，下面执行npm的命令必须在cmd下而不是Powershell下。

npm install -g @anthropic-ai/claude-code

返回如下信息表示安装成功。

D:\Users\lxy>npm install -g @anthropic-ai/claude-code

added 2 packages in 3s

1 package is looking for funding
  run `npm fund` for details
npm notice
npm notice New patch version of npm available! 11.6.2 -> 11.6.4
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.6.4
npm notice To update run: npm install -g npm@11.6.4
npm notice

D:\Users\lxy>