Kiro + kiro2cc 完整使用指南：将 Kiro Token 接入 Claude Code（附 Fireworks.ai 兼容方案）

最近社区里 Kiro + kiro2cc 的讨论热度很高。Kiro 是 AWS 推出的 AI Agent IDE，kiro2cc 是社区做的桥接工具，可以把 Kiro 本地 Token 转成 Claude Code 可用的 Anthropic API 代理。本文是一份完整的使用指南。

Kiro 简介

Kiro 是 AWS 推出的 AI 编程 IDE，可以理解成一个带 Agent 能力的 VS Code 类开发工具。它不只是让 AI 帮你补代码，而是更强调完整的软件开发流程：从需求描述、规格文档、技术设计、任务拆解，到代码实现、测试和文档生成。

Kiro 的核心特点是 Spec-Driven Development，规格驱动开发。用户先用自然语言描述需求，Kiro 会把需求整理成结构化的 spec，再基于 spec 生成设计方案和任务列表，最后让 AI Agent 按任务一步步完成开发。

简单说：

• 普通 AI 编程工具：你说一句，它写一段代码
• Kiro：先理解需求 → 再生成规格 → 再拆任务 → 最后执行开发

Kiro 的核心能力

1. Specs：规格驱动开发 - Kiro 会把你的自然语言需求整理成结构化文档（requirements.md、design.md、tasks.md），然后 Agent 按任务实现代码
2. Agentic Chat - 不只是聊天框，可以理解项目上下文，帮你修 bug、写功能、补测试、生成文档、重构代码
3. Steering - 通过 markdown 文件给 Agent 设置项目规则（比如"统一使用 Go Gin"、"接口返回格式必须统一"），通常放在 .kiro/steering/ 目录
4. Hooks - 代码变更后自动补测试、接口变更后更新文档、保存文件后自动检查规范

kiro2cc 是什么

kiro2cc 是一个社区开源项目，全名是 Kiro to Claude Code。它的作用是把 Kiro 本地认证 Token 转成 Claude Code / Cherry Studio 可以使用的 Anthropic API 代理形式。

整体链路如下：

Kiro IDE
  │ 登录后生成本地 Token
  ▼
~/.aws/sso/cache/kiro-auth-token.json
  │ kiro2cc refresh
  ▼
kiro2cc-token.json
  │ kiro2cc server
  ▼
http://localhost:8080
  │ Anthropic API 兼容代理
  ▼
Claude Code / Cherry Studio

核心解决的问题：Claude Code 默认需要 Anthropic API Key，但 Kiro 使用的是自己的登录 Token。kiro2cc 负责把这两套东西接起来。

安装 kiro2cc

kiro2cc 是 Go 项目，需要从 GitHub 拉源码编译：

git clone https://github.com/bestK/kiro2cc.git
cd kiro2cc
go build -o kiro2cc main.go

编译后得到可执行文件 ./kiro2cc。建议放到 PATH 目录：

mkdir -p ~/.local/bin
cp ./kiro2cc ~/.local/bin/kiro2cc
export PATH="$HOME/.local/bin:$PATH"

kiro2cc 核心命令

Claude Code 推荐配置方式

终端一：启动代理

kiro2cc refresh
kiro2cc server

默认监听 http://localhost:8080。如果端口被占用：

kiro2cc server 9000

终端二：启动 Claude Code

export ANTHROPIC_BASE_URL="http://localhost:8080"
export ANTHROPIC_API_KEY="kiro2cc"

claude --model claude-sonnet-4-20250514 --dangerously-skip-permissions

重点提示：

• Base URL 使用 http://localhost:8080，不要加 /v1 后缀
• 必须指定支持的模型，默认 claude-opus-4-7 可能不被支持

常见问题

1. Auth conflict

Claude Code 同时存在两套认证，执行：

claude /logout

然后重新打开终端设置环境变量再启动。

2. Unknown or unsupported model

不要直接运行 claude，改用：

claude --model claude-sonnet-4-20250514 --dangerously-skip-permissions

3. Token 过期

现象：401 / 403 认证失败。处理方式：

1. 打开 Kiro IDE 重新登录
2. kiro2cc refresh
3. 重启 kiro2cc server

4. 端口被占用

kiro2cc server 9000
export ANTHROPIC_BASE_URL="http://localhost:9000"

Cherry Studio 使用方式

启动代理后，Cherry Studio 中配置：

关于 Fireworks.ai 的兼容方案

除了 kiro2cc，另一个常见的方案是通过 Fireworks.ai 的 Anthropic 兼容接口接入。

Claude Code 对接 Fireworks

创建 ~/.claude/settings.json：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "apiKeyHelper": "bash -c 'echo YOUR_FIREWORKS_API_KEY'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
    "ANTHROPIC_MODEL": "accounts/fireworks/models/deepseek-v4-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/deepseek-v4-pro"
  },
  "model": "accounts/fireworks/models/deepseek-v4-pro"
}

也可以用环境变量快速测试：

export ANTHROPIC_BASE_URL="https://api.fireworks.ai/inference"
export ANTHROPIC_AUTH_TOKEN="YOUR_FIREWORKS_API_KEY"
export ANTHROPIC_MODEL="accounts/fireworks/models/deepseek-v4-pro"

claude

Fireworks 模型选择

Fireworks 上有 200+ 模型，常用的模型 ID 格式为 accounts/fireworks/models/模型名，例如：

• accounts/fireworks/models/deepseek-v4-pro - DeepSeek-V4-Pro（1M 上下文，支持 Function Calling）
• accounts/fireworks/models/kimi-k2p6 - Kimi K2.6
• accounts/fireworks/models/glm-5 - GLM-5

Python SDK 测试

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ.get("FIREWORKS_API_KEY"),
    base_url="https://api.fireworks.ai/inference"
)

response = client.messages.create(
    model="accounts/fireworks/models/deepseek-v4-pro",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(response.content[0].text)

Fireworks 注意事项

• Fireworks 的兼容层是 Anthropic-compatible 接口，不是真的调用 Claude 官方模型
• 普通聊天、代码、工具调用场景大多能跑
• 不同模型的工具调用、长上下文、思考格式、图片能力会有差异
• DeepSeek-V4-Pro 不支持图片输入，但支持 1M 上下文和 Function Calling
• 注意用量计费：DeepSeek-V4-Pro 价格约 $1.74/1M 输入、$3.48/1M 输出，长上下文场景容易产生较高费用

总结

Kiro 是 AWS 推出的 AI Agent IDE，主打规格驱动开发。kiro2cc 是社区做的桥接工具，让 Claude Code 等工具能复用 Kiro 的模型能力。

Fireworks.ai 则提供了另一条路：通过 Anthropic 兼容接口，把开源/国产模型接到 Claude Code 使用。

最重要的不是背命令，而是理解这条链路：

Kiro / Fireworks 认证
  ↓
kiro2cc server / ANTHROPIC_BASE_URL 代理
  ↓
Claude Code / Cherry Studio 连接本地或远程代理
  ↓
通过后端模型完成对话和代码任务