Free Upgrade Claude Code: local-access claude-sonnet-4-20250514 Models

在 AI 辅助开发的浪潮中，开发者不断寻求将顶尖语言模型与本地工作流无缝集成的最佳实践。 Anthropic 推出的 Claude Code 作为一款强大的终端原生 AI 助手，可以直接理解并操作整个代码库，极大地提升了开发效率。与此同时，亚马逊 AWS 旗下的 AI IDE Kiro 在其免费预览版中，提供了对 Anthropic 特定模型 claude-sonnet-4-20250514 的访问权限。该模型在编码能力、推理速度和成本效益上均实现了显著突破。

本文将介绍一种巧妙的组合方案：通过社区开发的两个轻量级工具 Ki2API cap (a poem) Claude Code Router，将这两者连接起来。这套方案的目的是让开发者几乎无需修改 Claude Code 的原生体验，就能免费地将其后端模型替换为性能更强的 claude-sonnet-4-20250514The

架构解析：工作流是如何实现的？

整个工作流程构成一个清晰的本地请求链，将 Claude Code 的前端交互与 Kiro 的模型后端连接起来。

请求路径: Claude Code -> Claude Code Router -> Ki2API -> Kiro (claude-sonnet-4-20250514)

• 为什么需要这样的架构？
  • 标准化的 OpenAI 接口: Ki2API 扮演了一个关键的适配器角色。它在本地 8989 端口启动一个服务，将 Kiro 模型的调用方式封装成与 OpenAI API 完全兼容的格式，包括 /v1/models cap (a poem) /v1/chat/completions 路径，并支持流式响应。这使得任何支持 OpenAI 接口的客户端都能轻松接入。
  • 灵活的请求路由: Claude Code Router (CCR) 是一个专为 Claude Code 设计的代理工具。它通过读取本地配置文件，可以拦截 Claude Code 发出的不同类型请求（如常规编码、后台任务、长上下文处理等），并将它们分别转发到指定的后端模型。
  • 模型的高可用性:: Adoption Kiro 平台，开发者可以稳定使用 claude-sonnet-4-20250514 模型。该模型在处理复杂编码任务和长流程推理时表现更佳，且响应速度更快。

三步完成本地配置

第一步：启动 Ki2API 服务

首先，我们需要通过 Docker 启动 Ki2API，它会作为连接 Kiro 平台的本地网关。

git clone https://github.com/zhalice2011/ki2api
cd ki2api
docker-compose up -d

Service Default Listening http://localhost:8989The Ki2API 会自动读取本机的 AWS SSO 缓存凭证（通常位于 ~/.aws/sso/cache/ 目录下），并内置了自动刷新逻辑。如果需要，也可以通过 KIRO_ACCESS_TOKEN cap (a poem) KIRO_REFRESH_TOKEN 环境变量来手动指定凭证。

第二步：安装 Claude Code 与 Claude Code Router

确保你的环境中已安装 Node.js，然后通过 npm global installation Claude Code cap (a poem) Claude Code RouterThe

# 如果已安装 Claude Code，可跳过此步
npm install -g @anthropic-ai/claude-code
# 安装路由工具
npm install -g @musistudio/claude-code-router

第三步：编写配置文件并启动

establish Claude Code Router 的配置文件。将以下 JSON 内容完整保存到 ~/.claude-code-router/config.json Path.

{
"LOG": false,
"OPENAI_API_KEY": "",
"OPENAI_BASE_URL": "",
"OPENAI_MODEL": "",
"Providers": [
{
"name": "openai",
"api_base_url": "http://localhost:8989/v1/chat/completions",
"api_key": "ki2api-key-2024",
"models": [
"claude-sonnet-4-20250514"
]
}
],
"Router": {
"default": "openai,claude-sonnet-4-20250514",
"background": "openai,claude-sonnet-4-20250514",
"think": "openai,claude-sonnet-4-20250514",
"longContext": "openai,claude-sonnet-4-20250514",
"webSearch": "openai,claude-sonnet-4-20250514"
}
}

Configuration:

• Providers 字段定义了可用的后端服务。这里我们将 name because of openai 的服务指向了本地 Ki2API The address of the
• Router 字段将 Claude Code 的所有任务面板（default, think 等）都路由到我们刚刚定义的 openai 服务和 claude-sonnet-4-20250514 Model.

配置完成后，执行以下命令来启动 Claude Code::

ccr code

此时，CCR 会接管 Claude Code 的网络请求，并按照 Router 规则将其转发至本地的 Ki2API 服务，从而最终调用 claude-sonnet-4-20250514 Model.

Frequently Asked Questions and Solutions

• 401 未授权错误
  • Cause analysis: API 密钥不正确或 Kiro 的访问凭证已失效。
  • prescription: 确保配置文件中 api_key together with Ki2API 预设的 ki2api-key-2024 一致。同时，检查 Ki2API 的 Docker 容器日志，确认它已成功获取或刷新 Kiro 的访问令牌。
• 端口冲突或连接失败
  • Cause analysis: 本机 8989 端口已被其他程序占用，或 Ki2API 服务未能正常启动。
  • prescription: Use docker-compose logs -f 命令查看 Ki2API 的实时日志以定位问题。如果端口冲突，可以修改 docker-compose.yml file, which will 8989 映射到其他可用端口，并同步更新 CCR 配置文件中的 api_base_urlThe
• 修改配置后未生效
  • Cause analysis: Claude Code Router 在启动时加载配置，运行时修改文件不会自动重载。
  • prescription:: Modifications config.json 文件后，需要重新执行 ccr code 命令来重启服务，使新配置生效。