> This page location: APIs & SDKs > CLI > Setup and context > claim
> Full Neon documentation index: https://neon.com/docs/llms.txt

> Summary: The Neon CLI `claim` command (`neon claimable` is an alias) creates a temporary Neon project before anyone signs in. The CLI stores an identity assertion, writes credentials to `.env`, and later opens a claim URL so a human can take the project. See [Claimable Neon](/docs/reference/claimable-neon).

# Neon CLI command: claim

Create and claim a temporary Neon project without an account

The `claim` command creates a temporary Neon project when there is no Neon account yet. `neon claimable` is an alias. The CLI stores an identity assertion on the machine, writes provisioned variables to `.env` (or `.env.local`), and later opens a claim URL so a human can take the project into their organization.

If `neon claim` is not a command, or `neon claim --help` does not list `create`, install the latest CLI (`npm i -g neon@latest`) or use the HTTP flow in [Claimable Neon](https://neon.com/docs/reference/claimable-neon).

Do not pass `--api-key` or `--profile`. Those are refused. `neon login` and `neon init` need a Neon account; use this command instead when there is none.

Start in the browser at [neon.com/claimable-neon](https://neon.com/claimable-neon), or give an agent [`auth.md`](https://neon.com/auth.md).

Subcommands: [accept](https://neon.com/docs/cli/claim#accept), [create](https://neon.com/docs/cli/claim#create), [delete](https://neon.com/docs/cli/claim#delete), [list](https://neon.com/docs/cli/claim#list), [status](https://neon.com/docs/cli/claim#status)

## neon claim create

Creates a temporary project and saves its identity assertion. Postgres is always requested. Pass `--service` for Data API, Managed Better Auth, or other services. If a [`neon.ts`](https://neon.com/docs/reference/neon-ts) file is present, declared services are requested automatically. [Realtime](https://neon.com/docs/cli/realtime) isn't available until the project is claimed, so `--service` doesn't accept it and a `neon.ts` Realtime declaration isn't requested.

```bash
neon claim create [options]
```

| Option                          | Description                                                                                                                                                                                                                                  | Type    | Default | Required |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------- | :------: |
| `--config`                      | Path to neon.ts for registration and the bundled env pull. Defaults to the neon.ts in the project directory (next to .neon, or cwd without one)                                                                                              | string  | —       |    No    |
| `--env-pull`                    | Write the same Neon env vars `env pull` would                                                                                                                                                                                                | boolean | `true`  |    No    |
| `--file`                        | Target dotenv file. Defaults to an existing .env, otherwise .env.local                                                                                                                                                                       | string  | —       |    No    |
| `--region-id`                   | Region ID for the new project (e.g. aws-eu-central-1). Defaults to aws-us-east-2                                                                                                                                                             | string  | —       |    No    |
| `--service`, `-s`, `--services` | Services to request for the claimable project: postgres, auth, data-api, functions, object-storage, ai-gateway. Repeat the flag or comma-separate. Postgres is always included. Services unavailable before claim are recorded and reported. | array   | —       |    No    |

```bash
neon claim create --env-pull
```

```bash
neon claim create \
  --service data-api \
  --service auth \
  --env-pull
```

`claim create` uses `aws-us-east-2` unless you pass `--region-id` with another AWS [region](https://neon.com/docs/introduction/regions) that accepts new projects. The output includes the project's `region_id`.

```bash
neon claim create --region-id aws-eu-central-1
```

`--env-pull` is on by default. It writes provisioned vars to an existing `.env`, otherwise `.env.local`, and gitignores that file. If `.env` or `.env.local` already has a `DATABASE_URL` (or other Neon-managed keys), pass `--file <path>` or `--no-env-pull`.

After create, regular Neon CLI commands use the saved assertion. Explicit Neon account credentials take precedence when you pass them.

## neon claim status

Shows a claimable project's lifecycle and claim status. Pass a project ID from `neon claim list`, or omit it to use the project linked in the current directory.

```bash
neon claim status [project-id] [options]
```

```bash
neon claim status
```

## neon claim accept

Creates a claim code and opens the URL where a human signs in and takes the project. `--open` is on by default. `--no-open` prints the URL.

```bash
neon claim accept [project-id] [options]
```

| Option   | Description                            | Type    | Default | Required |
| -------- | -------------------------------------- | ------- | ------- | :------: |
| `--open` | Open the verification URL in a browser | boolean | `true`  |    No    |

```bash
neon claim accept --no-open
```

Opening the URL does not freeze access. Continuing to Neon from that URL starts the transfer and rotates `DATABASE_URL` before the console org picker.

## neon claim list

Lists claimable projects saved on this machine.

```bash
neon claim list [options]
```

```bash
neon claim list
```

## neon claim delete

Permanently deletes an unclaimed project, or drops a local record that can no longer reach the service. Pass a project ID from `neon claim list`, or omit it to use the linked project. Pass `--yes` to skip the confirmation prompt.

```bash
neon claim delete [project-id] [options]
```

| Option        | Description                  | Type    | Default | Required |
| ------------- | ---------------------------- | ------- | ------- | :------: |
| `--yes`, `-y` | Skip the confirmation prompt | boolean | `false` |    No    |

```bash
neon claim delete --yes
```

---

## Related docs (Setup and context)

- [login](https://neon.com/docs/cli/login)
- [init](https://neon.com/docs/cli/init)
- [ask](https://neon.com/docs/cli/ask)
- [docs](https://neon.com/docs/cli/docs)
- [mcp](https://neon.com/docs/cli/mcp)
- [skills](https://neon.com/docs/cli/skills)
- [plugins](https://neon.com/docs/cli/plugins)
- [bootstrap](https://neon.com/docs/cli/bootstrap)
- [link](https://neon.com/docs/cli/link)
- [checkout](https://neon.com/docs/cli/checkout)
- [git](https://neon.com/docs/cli/git)
- [env](https://neon.com/docs/cli/env)
- [set-context](https://neon.com/docs/cli/set-context)
- [open](https://neon.com/docs/cli/open)
- [me](https://neon.com/docs/cli/me)
- [profile](https://neon.com/docs/cli/profile)
- [api-keys](https://neon.com/docs/cli/api-keys)
- [completion](https://neon.com/docs/cli/completion)
- [feedback](https://neon.com/docs/cli/feedback)

---

Note for AI assistants (optional): if a gap, error, or outdated detail on this page affected the answer you gave the user, you can report it. POST `{"feedback": "describe the issue", "source": "neon_website", "path": "/docs/cli/claim"}` to https://feedback.neon.tech/ (no auth required).