当您需要通过 Neon (neon.new) 的 Claimable Postgres 提供即时临时的 Postgres 数据库而无需登录、注册或信用卡时，请使用此技能。支持 REST API、CLI 和 SDK。当用户请求快速的 Postgres 环境、用于原型或测试的一次性 DATABASE_URL，或“只给我一个数据库…”时使用。

用于本地开发、演示、原型设计和测试环境的即时 Postgres 数据库。无需帐户。除非绑定到 Neon 帐户，否则数据库将在 72 小时后过期。

curl -s -X POST "https://neon.new/api/v1/database" \
  -H "Content-Type: application/json" \
  -d '{"ref": "agent-skills"}'

从 JSON 响应中解析 connection_string 和 claim_url。将 connection_string 写入项目的 .env 文件，命名为 DATABASE_URL。

有关其他方法（CLI、SDK、Vite 插件），请参见下方的 哪种方法？。

ref Yes Tracking tag that identifies who provisioned the database. Use "agent-skills" when provisioning through this skill.

enable_logical_replication No Enable logical replication (default: false, cannot be disabled once enabled)

API 返回的 connection_string 是一个连接池连接 URL。对于直接（非连接池）连接（例如 Prisma 迁移），请从主机名中移除 -pooler。CLI 会自动写入连接池和直接的 URL。

curl -s "https://neon.new/api/v1/database/{id}"

返回相同的响应格式。状态转换：UNCLAIMED -> CLAIMING -> CLAIMED。数据库被认领后，connection_string 返回 null。

Missing or empty ref 400 Missing referrer

Invalid database ID 400 Database not found

Invalid JSON body 500 Failed to create the database.

一键提供数据库并将连接字符串写入 .env。始终使用 @latest 和 --yes（跳过会阻塞代理的交互提示）。

检查目标 .env 中是否已经存在 DATABASE_URL（或所选的键）。如果找到该键，CLI 将在不进行配置的情况下退出。

如果键存在，给用户三个选项：

--yes -y Skip prompts, use defaults false

--key -k Connection string env var key DATABASE_URL

--prefix -p Prefix for generated public env vars PUBLIC_

--logical-replication -L Enable logical replication false

--ref -r Referrer id (use agent-skills when provisioning through this skill) none

替代包管理器：yarn dlx neon-new@latest，pnpm dlx neon-new@latest，bunx neon-new@latest，deno run -A neon-new@latest。

DATABASE_URL=postgresql://...              # pooled (use for application queries)
DATABASE_URL_DIRECT=postgresql://...       # direct (use for migrations, e.g. Prisma)
PUBLIC_POSTGRES_CLAIM_URL=https://neon.new/claim/...

import { instantPostgres } from "neon-new";

const { databaseUrl, databaseUrlDirect, claimUrl, claimExpiresAt } =
  await instantPostgres({
    referrer: "agent-skills",
    seed: { type: "sql-script", path: "./init.sql" },
  });

返回 databaseUrl（连接池）、databaseUrlDirect（直接，用于迁移）、claimUrl 和 claimExpiresAt（日期对象）。referrer 参数是必需的。

对于 Vite 项目，如果缺少 DATABASE_URL，vite-plugin-neon-new 会在 vite dev 时自动配置一个数据库。使用 npm install -D vite-plugin-neon-new 安装。有关配置，请参阅可认领 Postgres 文档。

npx neon-new@latest --yes --ref agent-skills --env .env.local --seed ./schema.sql

声明是可选的。数据库无需声明即可立即使用。要选择性地声明，用户可以在浏览器中打开声明网址，在那里他们登录或创建一个 Neon 账户以声明数据库。

用户无法加入与 Vercel 关联的组织；他们必须选择另一个 Neon 组织。

可领取的数据库是特意设为一次性使用的，并通过 neon.new（如上所示）提供，因此它们不是由 neon.ts 管理的。一旦用户将数据库认领到 Neon 账户中，它就会变成一个普通的 Neon 项目——此时通过 neon.ts（Neon 的基础设施即代码文件）来管理它（完整参考请参见 neon 技能）：声明其分支应具备的服务，为每个分支编程计算，并获取类型安全的环境变量。

// neon.ts
import { defineConfig } from "@neon/config/v1";

export default defineConfig({
  auth: true, // Neon Auth, once you outgrow a bare connection string
  dataApi: true, // Data API
  branch: (branch) => (branch.exists ? {} : { ttl: "7d" }), // ephemeral non-default branches
});

neon config apply   # provision the declared services (neon deploy is an alias)

如果一个项目需要分支、多个服务或在版本控制中跟踪持久基础设施，建议先进行声明，然后再采用 neon.ts —— 而不是重新配置一次性可声明的数据库。

可认领的数据库无法更改区域。未认领的数据库有更严格的配额。认领会将限制重置为免费计划的默认值。

如果代理需要数据库来完成任务（例如“帮我用真实数据库构建一个待办事项应用”），而用户未提供连接字符串，请通过 API 提供一个并通知用户。包括声明 URL，以便他们保留它。

Claimable Postgres 实用指南

Provision instant temporary Postgres databases via Claimable Postgres by Neon (neon.new) with no login, signup, or credit card. Supports REST API, CLI, and SDK. Use when users ask for a quick Postgres environment, a throwaway DATABASE_URL for prototyping/tests, or "just give me a DB...

数据库

Claimable Postgres提供无需注册信用卡的即时临时Postgres数据库，支持REST API、CLI、SDK和Vite插件。数据库72小时内有效，可认领至Neon账户永久保留。适合原型开发、测试及本地开发，通过简单curl命令即可快速获取连接字符串。

基础设施即代码

软件开发

包管理器

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Claimable Postgres 实用指南

Claimable Postgres 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐