Claude Code + Amazon Bedrock 使用指南

一棵白菜2026-05-09 20:50

Claude Code + Amazon Bedrock 使用指南

一、Claude Code 是什么？

Claude Code 是 Anthropic 官方推出的 AI 编程 CLI 工具，可以：

  • 直接在终端中与 AI 对话，完成代码编写、调试、重构
  • 自动读取项目代码上下文，理解整个代码库
  • 执行 shell 命令、编辑文件、运行测试
  • 支持 VS Code / Cursor 等 IDE 集成

通过 Amazon Bedrock 接入，我们无需使用个人 Anthropic API Key，统一走公司 AWS 账号，费用由公司统一结算。

二、前置条件

在开始之前，请确认以下环境已准备就绪：

条件 要求 检查方式
Node.js >= 18.0 node --version
AWS CLI v2 aws --version
AWS 凭证 已配置 aws sts get-caller-identity
操作系统 macOS / Linux / Windows (WSL) -

2.1 安装 Node.js

如果尚未安装 Node.js，推荐使用 nvm：

bash 复制代码 
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc  # 或 source ~/.bashrc
nvm install 22
nvm use 22

2.2 安装并配置 AWS CLI

bash 复制代码 
# macOS
brew install awscli

# 验证安装
aws --version

2.3 配置 AWS 凭证

请联系 DevOps 团队获取你的 AWS Access Key，然后执行：

复制代码 
aws configure

按提示输入：

vbnet 复制代码 
AWS Access Key ID: <你的 Access Key ID>
AWS Secret Access Key: <你的 Secret Access Key>
Default region name: us-east-1
Default output format: json

验证凭证是否生效：

sql 复制代码 
aws sts get-caller-identity

如果返回了你的 Account ID 和 ARN，说明配置成功。

三、安装 Claude Code

bash 复制代码 
# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

如遇权限问题（macOS），可尝试：

sql 复制代码 
sudo npm install -g @anthropic-ai/claude-code --unsafe-perm

四、配置 Bedrock 连接

4.1 创建配置文件

编辑（或创建）Claude Code 的配置文件 ~/.claude/settings.json：

json 复制代码 
{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "ANTHROPIC_MODEL": "us.anthropic.claude-sonnet-4-6-v1",
    "AWS_REGION": "us-east-1",
    "AWS_PROFILE": "default",
    "DISABLE_AUTOUPDATE": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

配置文件路径：

操作系统 路径
macOS / Linux ~/.claude/settings.json
Windows %USERPROFILE%.claude\settings.json

注意：如果文件已存在其他配置，请将 env 字段合并进去，不要覆盖已有内容。

4.2 跳过登录引导流程

Claude Code 首次启动会进入 Anthropic 的登录引导（Onboarding）流程。使用 Bedrock 时需要跳过此步骤。

创建（或编辑）文件 ~/.claude.json（注意：是用户主目录下的 .claude.json，不是 .claude/ 目录里的）：

json 复制代码 
{
  "hasCompletedOnboarding": true
}

说明：设置 hasCompletedOnboarding 为 true 后，Claude Code 启动时会跳过默认的 Anthropic OAuth 登录流程，直接使用 settings.json 中配置的 Bedrock 连接。

4.3 验证配置

修改完成后重新打开终端，然后执行：

css 复制代码 
claude --version

如果没有弹出登录提示，说明配置成功。

五、可用模型

公司 Bedrock 账号已开通以下 Claude 模型：

模型 Bedrock Model ID 适用场景 相对成本
Claude Sonnet 4.6 us.anthropic.claude-sonnet-4-6-v1 日常编码、代码审查、调试（推荐默认） ★
Claude Haiku 4.5 us.anthropic.claude-haiku-4-5-v1 快速问答、简单任务、节省成本 ★（最低）
Claude Opus 4.6 us.anthropic.claude-opus-4-6-v1 复杂架构设计、深度推理 ★★★（最高）

切换模型

shell 复制代码 
# 方式一：启动时指定
claude --model us.anthropic.claude-opus-4-6-v1

# 方式二：对话中切换
# 输入 /model 命令选择模型

成本提醒：Opus 模型费用约为 Sonnet 的 5 倍，请根据任务复杂度合理选择。日常开发建议使用 Sonnet，简单查询使用 Haiku。

六、快速上手

6.1 启动 Claude Code

bash 复制代码 
# 在项目根目录启动
cd your-project
claude

首次启动会显示欢迎信息，确认模型连接成功。

6.2 基本用法

shell 复制代码 
# 让 AI 解释代码
> 解释一下 src/main/java/com/example/UserService.java 的主要逻辑

# 让 AI 写代码
> 帮我写一个用户注册的 REST API，使用 Spring Boot

# 让 AI 修 Bug
> 这个 NullPointerException 是什么原因？帮我修复

# 让 AI 重构
> 把这个方法拆分成更小的函数，遵循单一职责原则

# 运行命令
> 运行项目的单元测试并分析失败原因

6.3 IDE 集成

Claude Code 同时支持在 IDE 中使用：

VS Code：

  1. 安装扩展：搜索 "Claude Code" 并安装
  2. 打开命令面板（Cmd+Shift+P），输入 "Claude"
  3. 快捷键 Cmd+Esc 打开 Claude 面板

JetBrains（IntelliJ IDEA 等）：

  1. Settings -> Plugins -> 搜索 "Claude Code" 并安装
  2. 重启 IDE
  3. 右侧工具栏会出现 Claude 图标

IDE 集成会自动继承终端中配置的环境变量（Bedrock 配置），无需额外设置。

七、常用技巧

7.1 让 AI 理解你的项目

在项目根目录创建 CLAUDE.md 文件，写入项目背景信息：

markdown 复制代码 
# 项目说明

- 这是一个 Spring Boot 微服务项目
- 使用 MyBatis 作为 ORM
- 数据库：MySQL 8.0
- 构建工具：Maven
- Java 版本：17

## 代码规范

- 遵循阿里巴巴 Java 开发手册
- Controller 层不写业务逻辑
- Service 层通过接口定义

Claude Code 每次启动时会自动读取该文件，确保 AI 理解项目上下文。

7.2 实用快捷键

快捷键 功能
Esc（连按两次） 退出 Claude Code
Cmd+C 中断当前 AI 响应
/help 查看所有可用命令
/clear 清空对话历史
/compact 压缩上下文（对话太长时使用）
Tab 自动补全文件路径

7.3 权限模式

Claude Code 在执行文件操作和 shell 命令时会请你确认：

  • 输入 y：允许本次操作
  • 输入 n：拒绝本次操作
  • 输入 !：本次会话中始终允许该类型操作

八、常见问题

Q1：报错 "Could not connect to Bedrock"

排查步骤：

bash 复制代码 
# 1. 检查 AWS 凭证是否有效
aws sts get-caller-identity

# 2. 检查区域配置
echo $AWS_REGION

# 3. 检查 Bedrock 访问权限
aws bedrock list-foundation-models --region us-east-1 --query "modelSummaries[?contains(modelId, 'claude')]"

如果第 3 步报权限不足，请联系 DevOps 团队申请 Bedrock 模型访问权限。

Q2：报错 "Model not found" 或 "Access denied"

可能原因：

  • Bedrock 未开通对应模型 -> 联系 DevOps 开通
  • Region 不匹配 -> 确认 AWS_REGION 设置为 us-east-1
  • AWS 凭证过期 -> 重新执行 aws sso login

Q3：响应速度很慢

  • 切换到 Haiku 模型（更快、更便宜）
  • 检查网络连接，确保能访问 AWS
  • 使用 /compact 压缩过长的对话上下文

Q4：JSON 配置不生效

  • 确保 JSON 格式合法（可以用 jsonlint.com 校验）
  • 修改配置后必须重新打开终端
  • 检查配置文件路径是否正确

Q5：macOS 安装权限错误

bash 复制代码 
# 方案一：使用 sudo
sudo npm install -g @anthropic-ai/claude-code --unsafe-perm

# 方案二：修改 npm 全局目录（推荐）
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

九、安全须知

  1. 不要在 Claude Code 对话中粘贴密码、Token 等敏感信息，AI 会将其作为上下文处理
  2. 不要让 AI 直接操作生产环境，所有生产操作请走正规发布流程
  3. 代码审查仍然必要，AI 生成的代码需要经过 Code Review 后才能合并
  4. 注意成本控制，避免无意义的长对话消耗 Token

十、获取帮助

场景 联系方式
AWS 凭证 / 权限问题 DevOps 团队
相关推荐
大家的林语冰2 小时前
前端周刊：axios 疑遭朝鲜黑客“钓鱼“；CSS 新函数上线；npm 上线深色主题；Oxlint 兼容表；ESLint 支持 Temporal......
前端·javascript·css
哀木3 小时前
一个简单的套壳方案，就能让你的 Agent 少做重复初始化
前端
问心无愧05133 小时前
ctf show web入门27
前端
小村儿3 小时前
给 AI Agent 装上"长期记忆"：Karpathy 的 LLM Wiki 思想，我做成了工具
前端·后端·ai编程
竹林8183 小时前
用ethers.js连接MetaMask实现Web3钱包登录：从踩坑到稳定运行的完整记录
前端·javascript
heyCHEEMS4 小时前
如何用 Recast 实现静态配置文件源码级读写
前端·node.js
心连欣4 小时前
从零开始，学习所有指令！
前端·javascript·vue.js
review445434 小时前
大模型和function calling分别是如何工作的
前端
东东同学4 小时前
耗时一个月，我把 Nuxt 首屏性能排障经验做成了一个 AI Skill
前端·agent
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03零基础教你claude code 接入 deepseek V404要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法05Dirtyfrag漏洞：我花了一下午搞清楚这个Linux内核提权漏洞到底在搞什么06CC-Switch & Claude 基于 Linux 服务器安装使用指南07Windows端Codex接入第三方模型（DeekSeek，BaiLian)08【AI】2026 年具身智能模型和世界模型总结09裂开！ChatGPT 居然开始要手机号验证，附详细解决方法10Linux 核弹级高危漏洞 CVE-2026-31431 完整修复指南