用途:通过 Neon 的 Claimable Postgres(neon.new)即时创建临时 Postgres 数据库,适合本地开发、演示、原型和测试环境,无需账号、注册或信用卡。未认领的数据库 72 小时后过期,认领到 Neon 账号后可长期保留。
主要能力:提供 REST API、CLI、SDK 和 Vite 插件四种接入方式。REST API 返回结构化 JSON,适合需要可预测输出与错误处理的场景;CLI 一条命令即可创建并写入 .env;SDK 用于脚本或程序化创建;Vite 插件在缺少 DATABASE_URL 时于 vite dev 自动创建。API 返回 pooled 连接串;如需直连(如 Prisma 迁移),从主机名中去掉 -pooler。CLI 会同时写入 pooled 与 direct 两种 URL。
必要用法:REST API 调用 POST https://neon.new/api/v1/database,请求体为 {"ref": "agent-skills"},从响应中解析 connection_string、claim_url、expires_at,并将 DATABASE_URL 写入项目 .env。CLI 使用 npx neon-new@latest --yes,可选 --env、--key、--seed、--logical-replication、--ref 等参数;务必使用 @latest 与 --yes。也可通过 GET https://neon.new/api/v1/database/{id} 查询状态(UNCLAIMED -> CLAIMING -> CLAIMED)。播种可执行 psql "$DATABASE_URL" -f seed.sql。
适用场景与限制:默认区域 us-east-2、Postgres 17,区域不可更改;未认领时存储 100 MB、传输 1 GB、无分支、72 小时过期,认领后按免费计划重置(512 MB 存储、约 5 GB 传输、可分支、无过期)。认领可选,数据库创建后立即可用;用户无法认领到 Vercel 关联组织。不要覆盖已有环境变量,先检查再决定;运行破坏性种子 SQL 前需确认;写入凭据后确认 .env 已被 .gitignore 覆盖。生产负载应改用标准 Neon 方案。