跳转至

使用 AI 开发

🌐 由 AI 与人类协作翻译

本翻译由人类引导的 AI 生成。🤝

可能存在误解原意或不够自然等问题。🤖

你可以通过帮助我们更好地引导 AI LLM来改进此翻译。

英文版本

FastAPI 的 Python 包内附带官方的 智能体技能(agent skill),为你的项目中安装的版本提供指导。

安装技能

安装 FastAPI 后,在项目目录中运行 Library Skills:

uvx library-skills

选择 FastAPI 技能,并为 Codex 和大多数智能体选择 .agents/skills,或为 Claude Code 选择 .claude/skills。你也可以同时选择两者。

之后,你的智能体在处理 FastAPI 代码时就能自动使用该技能。

非交互式安装

对于智能体和脚本,可以使用以下命令,无需交互式提示即可选择 FastAPI 技能:

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

对于 Claude Code,添加 --claude,将技能同时安装到 .claude/skills:

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

配置应用

在 pyproject.toml 中配置应用入口点,以便 FastAPI 工具找到你的应用:

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

请使用你的应用的模块名和变量名。这里,main:app 指的是 main.py 中的 app 对象。

运行应用

使用 FastAPI CLI 进行本地开发:

uv run fastapi dev

在生产环境中,使用 uv run fastapi run。

生成 SDK

有关前端和 API 客户端开发,请参阅生成 SDK。

部署应用

要部署到 FastAPI 团队提供的官方托管部署平台 FastAPI Cloud,请运行:

uv run fastapi deploy

你也可以手动部署到其他云服务提供商或你自己的服务器。

智能体插件

适用于 Codex 和 Claude Code 的 FastAPI Cloud 插件包含创建项目以及使用依赖项附带的库技能的指导。即使你不使用 FastAPI Cloud,这些插件也很有用。

它们还涵盖 FastAPI Cloud 部署、日志和环境变量。