别死磕 Claude Code 了！Kiro 的“菜谱式编程”才是真正的未来！

1. 为什么我劝你别在 Claude Code 和 Kiro 之间二选一最近后台被问得最多的一句话就是Kiro 出来了Claude Code 是不是可以卸载了每次看到这种问题我都想笑因为我自己也经历过这个阶段——新工具一出来就急着站队好像必须选一个“最强”的另一个就得扔进回收站。但折腾了这么多天我越来越确定一件事这俩根本不是竞品关系硬要二选一吃亏的是你自己的开发效率。先把概念说清楚。Claude Code 是 Anthropic 出的终端级 AI 编程助手强在“你说一句它写一片”氛围编程Vibe Coding的爽感基本是它带火的。Kiro 是亚马逊推的 AI IDE核心卖点是规范驱动开发Spec-Driven Development它不急着给你吐代码而是先拉着你把需求、设计、任务拆成三份文档确认之后再动手。一个偏“执行”一个偏“规划”这俩凑一起才是完整闭环。那为什么很多人觉得 Kiro 是来替代 Claude Code 的因为 Kiro 内置了 Claude 4.0 模型写代码能力本身就不弱看起来像是“既当裁判又当运动员”。但实际用下来你会发现Kiro 的 spec 生成阶段才是它真正的杀手锏而到了大批量补全实现、跨文件重构这种脏活累活Claude Code 在终端里的响应速度和上下文处理还是更顺手。所以正确的姿势是用 Kiro 生成 spec 骨架再让 Claude Code 按规范补全实现。这篇就手把手带你把这套协作流跑通包括 Kiro 的 spec 目录结构、settings.json 里统一 Key 的配置骨架以及一次从 spec 到代码的完整验证。2. 前置准备用 TaoToken 统一管理两套工具的 Key在讲协作流之前得先解决一个现实问题Kiro 和 Claude Code 都要调模型如果各自配一套 Key管理起来就是灾难。我的做法是用 TaoToken 做统一入口一个 Key 同时喂给两个工具省得来回切换。TaoToken 是什么简单说它是一个兼容 Anthropic 和 OpenAI 接口规范的模型调用平台你可以在一个地方拿到 Key然后配置到不同工具里。对咱们这种“多工具协作”的场景特别合适因为不用为每个工具单独申请账号、单独充值、单独记 Key。官网在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后进控制台就能创建 Key。具体操作分三步。第一步登录后进控制台找到 API Keys 页面点创建新 Key复制出来先存好后面两个工具都要用。第二步如果你还没确定用哪个模型可以先去模型对话页面试一下确认接口通不通、响应正不正常这一步能帮你排除掉很多“以为是配置问题其实是 Key 没生效”的坑。第三步如果你打算长期用这套组合做编码和 Agent 任务建议直接看 Coding Plan它比按量付费更适合高频调用场景成本可控。注意Key 创建后只显示一次务必先存到密码管理器或者本地环境变量文件里别直接贴在代码里。拿到 Key 之后我们分头配置。Claude Code 这边在终端里设置环境变量就行macOS/Linux 用exportWindows 用set具体命令后面章节会给。Kiro 这边稍微麻烦一点它需要在 settings.json 里配自定义模型端点。下面两节分别给可复制的配置。3. 可复制配置Kiro spec 目录结构与 settings.json 骨架3.1 Kiro 的 spec 目录长什么样Kiro 的规范驱动开发核心就是三份文档requirements.md、design.md、tasks.md。它默认会在项目根目录下生成一个.kiro/specs/文件夹每个功能模块一个子目录。我实测下来推荐的结构是这样your-project/ ├── .kiro/ │ └── specs/ │ └── user-review/ │ ├── requirements.md │ ├── design.md │ └── tasks.md ├── src/ │ └── ... └── settings.jsonrequirements.md 写“做什么”用用户故事格式每条需求带验收标准。design.md 写“怎么做”包括技术选型、数据结构、接口定义。tasks.md 写“分几步做”把实现拆成可勾选的任务列表。这三份文档确认之后Kiro 才会进入 build 阶段。我试过直接让 Kiro 生成一个“用户评价功能”的 spec它给出的 requirements.md 大概是这样# Requirements: 用户评价功能 ## 用户故事 作为已购买用户我希望对商品发表评价以便帮助其他买家决策。 ## 验收标准 - 评价内容长度 10-500 字 - 支持 1-5 星评分 - 评价提交后 24 小时内可编辑 - 未购买用户不可评价design.md 会接着给出数据表结构、API 路由、前端组件划分。tasks.md 则拆成“建表 → 写 API → 写前端表单 → 联调 → 写测试”这样的顺序。这套东西看起来啰嗦但它解决了一个致命问题AI 写代码之前你和它已经对齐了“要做什么”后面返工的概率大幅下降。3.2 settings.json 里配 TaoToken 统一 KeyKiro 支持在 settings.json 里配置自定义模型提供商。打开你的项目根目录下的 settings.json没有就新建一个填入以下骨架{ kiro.modelProvider: { custom: { baseUrl: https://taotoken.net/api, apiKey: ${env:TAOTOKEN_API_KEY}, models: [ { id: claude-sonnet-4-20250514, name: Claude Sonnet 4, maxTokens: 8192 } ] } }, kiro.spec.enabled: true, kiro.spec.autoGenerateTasks: true }这里有几个关键点。baseUrl填https://taotoken.net/api注意不要加 UTM 参数那是给网页链接用的API 端点保持干净。apiKey用环境变量引用别硬编码这样你换 Key 的时候只改环境变量就行。models数组里可以配多个模型按需切换。然后在终端里设置环境变量# macOS / Linux export TAOTOKEN_API_KEY你的Key # Windows PowerShell $env:TAOTOKEN_API_KEY你的Key # Windows CMD set TAOTOKEN_API_KEY你的KeyClaude Code 这边同样用这个 Key配置方式是在~/.claude/settings.json里加{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: ${TAOTOKEN_API_KEY} } }这样两个工具就共用同一个 Key 了。如果你还没创建 Key去 API Keys 页面建一个整个过程不到一分钟。4. 验证请求从 spec 到代码跑一次完整闭环配置写完不算数得跑一次真实请求才能确认链路通。我拿一个最小场景来演示给一个 Express 项目加“健康检查接口”。第一步在 Kiro 里新建 spec。打开 Kiro按Cmd/Ctrl Shift P调出命令面板输入 “Kiro: New Spec”给它起名health-check。Kiro 会自动生成.kiro/specs/health-check/目录和三份空文档。第二步让 Kiro 填充 spec。在 Kiro 的 chat 面板里输入为 Express 项目生成健康检查接口的 spec。 要求GET /health 返回 { status: ok, timestamp: 当前时间 } 不需要鉴权响应时间小于 50ms。Kiro 会把 requirements、design、tasks 三份文档填好。你检查一遍确认没问题后点 “Approve”然后点 “Build”。Kiro 会按 tasks.md 的顺序开始生成代码。第三步把 spec 交给 Claude Code 补全。假设 Kiro 生成了基础骨架但有些边界情况没处理比如时间戳格式、错误处理。这时候切到终端在项目根目录下运行claude 读取 .kiro/specs/health-check/ 下的三份文档 按照 design.md 的接口定义补全 src/routes/health.js 要求时间戳用 ISO 8601 格式加 try-catch 错误处理 补完后运行 npm test 验证。Claude Code 会读取 spec 文档理解上下文然后补全代码并跑测试。这就是协作流的核心Kiro 负责“想清楚”Claude Code 负责“写完整”。第四步验证结果。启动服务node src/app.js然后另开一个终端请求curl -s http://localhost:3000/health | jq正常返回应该是{ status: ok, timestamp: 2025-06-15T10:23:45.123Z }如果返回了这个说明从 spec 生成到代码补全再到接口验证整条链路是通的。你可以再跑一下npm test确认 Claude Code 补的测试用例也过了。5. 本篇常见错排查5.1 Kiro 报 “Model provider not configured”这个错误九成是 settings.json 的路径或字段名写错了。检查三点baseUrl是不是https://taotoken.net/api别多写斜杠apiKey引用的环境变量名和终端里设的是否一致settings.json 是不是放在项目根目录而不是用户目录。如果还不行在 Kiro 的输出面板里看详细日志通常会告诉你具体哪个字段解析失败。5.2 Claude Code 提示 401 Unauthorized先确认环境变量有没有生效echo $TAOTOKEN_API_KEYWindows 用echo %TAOTOKEN_API_KEY%。如果输出为空说明终端会话没加载到重新开一个终端或者手动 export 一次。如果 Key 有值但还是 401去控制台检查 Key 是否被禁用或额度耗尽。另外注意ANTHROPIC_BASE_URL不要带尾部斜杠有些工具对 URL 拼接很敏感。5.3 spec 生成了但 Build 没反应Kiro 的 Build 按钮需要 spec 三份文档都处于 “Approved” 状态才会激活。如果你只确认了 requirements 没确认 design按钮是灰的。另外检查kiro.spec.autoGenerateTasks是否为 true有些版本默认关闭需要手动在 tasks.md 里点生成。5.4 Claude Code 读不到 spec 文档Claude Code 默认只读取当前工作目录下的文件。如果你在子目录里运行claude命令它可能找不到.kiro/文件夹。解决办法是在项目根目录运行或者在命令里用绝对路径引用 spec 文件。实测下来在根目录跑最省事。5.5 两个工具同时改同一个文件导致冲突这是协作流最容易踩的坑。Kiro 在 Build 阶段会直接写文件如果你同时让 Claude Code 改同一个文件后写的会覆盖先写的。我的做法是Kiro Build 完成后先 git commit 一次再让 Claude Code 接手。这样即使出问题也能回滚。另外可以在 Claude Code 的命令里明确说“只修改 src/routes/health.js不要动其他文件”缩小影响范围。6. 两套工具怎么分工我的实际用法跑通上面这套流程之后我现在的日常是这样的新功能先在 Kiro 里开 spec把需求、设计、任务三份文档过一遍确认没问题再 Build 出骨架。骨架提交之后切到 Claude Code 做三件事——补边界处理、写测试、跨文件重构。Kiro 负责“想清楚再动手”Claude Code 负责“动手就动干净”两者不打架。如果你也想试这套组合建议先从一个小功能开始别一上来就搞大模块。Key 的配置去 API Keys 页面拿接入细节看接入文档模型通不通先去模型对话页面测一下。长期做编码和 Agent 任务的话Coding Plan 比按量付费更划算。工具是死的协作流是活的找到适合自己的节奏比追新更重要。