Featured image of post AI Vibe Coding 工作流:用 Claude Code 全栈交付

AI Vibe Coding 工作流:用 Claude Code 全栈交付

一个人用 Claude Code 交付 Go+Python+Next.js 全栈项目的工作流

一个人,三套技术栈

2026 年初我开源了 alchemy-furnace(炼丹炉),一个多人格融合 Agent 系统:Go(Gin+GORM) 做网关,Python(FastAPI) 做合成引擎,Next.js 做前端,三套技术栈一个人全栈交付。按传统写法,光是在语言和框架之间切上下文,就要吃掉大量业余时间。我拿 Claude Code 当主力开发助手,慢慢攒出了一套自己的 Vibe Coding 工作流。

先给 Agent 立规矩

第一步,先写 CLAUDE.md,把项目结构、技术栈、启动命令、代码规范和关键领域概念(金丹、丹炉、血统追溯)写清楚,作为 Agent 的长期记忆。

第二步,复杂功能(Promptbreeder 变异算子、合成提示词缓存、多供应商适配)先用 Plan 模式让它出实施计划,我审完再让它动手写代码。

第三步,小步提交,每个子任务一个 commit,方便 review,也方便回滚。

第四步,测试先行。让 Claude 按函数签名写 table-driven tests,我负责补边界 case。

第五步,用 Task 跟踪多步任务,让它自己跑 go buildgo test,失败了读报错自己修。

Claude Code 全栈交付的五步工作流与分工边界

两份配置

项目根的 CLAUDE.md 片段:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# alchemy-furnace

## 架构
- gateway/ : Go 1.22, Gin + GORM, 负责 API Key 鉴权、路由、计费
- engine/  : Python 3.11, FastAPI, 多人格融合 + Promptbreeder 变异
- web/     : Next.js 14 App Router, Tailwind, shadcn/ui
- deploy/  : docker-compose, 单机部署

## 约定
- Go 代码通过 `make lint` 检查,禁止裸 ignore error
- Python 用 ruff + mypy,接口模型必须用 Pydantic
- 所有外部供应商调用走统一 provider 抽象
- API Key 入库前必须 AES-GCM 加密
- DEMO_MODE 下不调真实 LLM,返回内存 mock

settings.json 里放行高频命令,减少权限弹窗:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "permissions": {
    "allow": [
      "Bash(go build ./...)",
      "Bash(go test ./...)",
      "Bash(go vet ./...)",
      "Bash(ruff check *)",
      "Bash(pytest -q)",
      "Bash(docker compose config)"
    ]
  }
}

坑是真坑

第一,上下文是稀缺资源。我不会把整个仓库丢给 Claude,而是用子任务切给它:“只看 gateway/internal/provider 目录,给 OpenAI 兼容层加一个 DeepSeek 适配”。大范围重构先让它列影响文件清单,再逐个改。

第二,Vibe Coding 不等于不看代码。写完让它自己跑测试,但 API Key 加密、变异算子的血统追溯这类关键路径,我逐行 review。能跑通不代表逻辑对,尤其涉及金额、权限、加密的时候。

第三,幻觉 API 是真问题,它会编出不存在的 eino 函数签名。我的要求是先 go doc 或直接读 vendor 源码确认,不许凭印象写。

第四,多语言项目在同一会话里容易串味。我一般按服务分会话,或者明确说"接下来只写 Python,别把 Go 的错误处理风格带进来"。

第五,尽量用增量 Edit 而不是整体 Write。diff 清晰,跑偏了当场就能发现。

后来

Claude Code 让我这种以后端为主的人,敢一个人扛前端和算法服务。它最擅长样板代码、测试用例、跨文件重构和根据报错自修复;我负责架构、边界和验收。alchemy-furnace 能在业余时间快速做到 46 star,靠的就是这套工作流。

封面图:recursion_see_recursion / Flickr · CC BY 2.0

Built with Hugo
Theme Stack designed by Jimmy