fastapi提供随python包附带的官方agent skill，用于让编码工具读取项目安装版本对应的开发指引。使用时先准备真实项目依赖，再安装skill并核对应用入口，不能把skill文件当作fastapi运行环境。

FastAPI官方AI开发指南中的安装命令与项目目录

从项目目录安装Skill

确认当前工作目录就是FastAPI项目，项目已经安装需要的FastAPI版本。运行官方指南给出的Library Skills命令，在交互界面选择FastAPI。

uvx library-skills

根据编码工具选择目录。官方建议多数agent使用.agents/skills，Claude Code使用.claude/skills，也可以同时选择。目录属于项目配置，不需要把它误放进Python虚拟环境目录。

需要非交互安装时明确指定

脚本场景可以使用官方给出的显式安装参数。需要同时安装到Claude Code目录时再增加--claude，不把其他工具目录名直接拼成未核实参数。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

uvx library-skills install --skill fastapi --yes

# 同时安装到 Claude Code 的项目 Skill 目录
uvx library-skills install --skill fastapi --yes --claude

配置真实应用入口

在pyproject.toml中配置FastAPI入口。示例main:app表示main.py中的app对象；模块放在其他包或变量改名时，必须同步改成实际路径。

[tool.fastapi]
entrypoint = "main:app"

启动并核对应用

使用uv管理环境的项目可运行以下开发命令。先确认应用能由项目原有环境正常启动，再让编码工具使用Skill处理开发任务。

uv run fastapi dev

正式运行对应fastapi run，而不是开发命令。FastAPI Cloud只是可选部署路线；安装官方Skill不要求购买或迁入该平台。生成后的代码仍需通过项目自己的测试，Skill提供的说明不能代替运行验证。