然后让它生成。它就会像打了鸡血一样，一次性给你完整的项目结构。我试过，从输入到拿到可运行的代码，只用了4分32秒——比我自己写快了至少5倍。

为什么这么写：让Claude Code理解技术栈和边界条件，避免它瞎猜

app/routers/auth.py

from fastapi import APIRouter, HTTPException, Depends
from app.models.user import User
from app.schemas.auth import LoginRequest, RegisterRequest, TokenResponse
from app.database import get_db
from jose import jwt
from passlib.context import CryptContext
from datetime import datetime, timedelta

router = APIRouter(prefix="/auth", tags=["auth"])
pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
SECRET_KEY = "your-secret-key-here" # 生产环境用环境变量

@router.post("/register", status_code=201)
async def register(req: RegisterRequest, db=Depends(get_db)):
# 检查用户名是否已存在
if db.query(User).filter(User.username == req.username).first():
raise HTTPException(status_code=422, detail="Username already exists")

# 密码加密存储
hashed_password

<

另一个坑：原型代码能用，但全是“面条式”

Claude Code默认喜欢把所有逻辑塞进一个文件里。当你只是验证一个想法时，这没问题。但一旦要扩展功能，那代码就像意大利面条一样缠在一起。

我的套路：

先让它生成“原型版”的代码，跑通核心流程。然后在同一个对话里，加一句指令：

• 拆分成 routers/, services/, models/, schemas/ 四个模块
• 每个模块一个文件，依赖注入清晰
• 配置文件单独放 config.py
• 数据库连接放 database.py
• 不改变任何业务逻辑

这个设计真的反人类，但Claude Code处理得很好。它会分析代码的依赖关系，自动拆分。我举个例子：

（核心：一张代码重构前后对比图，左侧是单文件原型代码，右侧是模块化后的目录结构）

重构后的 services/user_service.py

为什么这么写：把业务逻辑从路由中抽离，方便单元测试和复用

from app.models.user import User
from app.database import get_db
from passlib.context import CryptContext
from jose import jwt
from datetime import datetime, timedelta

pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")

class UserService:
def __init__(self, db_session):
self.db = db_session

def create_user(self, username: str, password: str) -> User:
if self.db.query(User).filter(User.username == username).first():
raise ValueError("Username already exists")
hashed_password = pwd_context.hash(password)
user = User(username=username, password_hash=hashed_password)
self.db.add(user)
self.db.commit()
return user