> For the complete documentation index, see [llms.txt](https://docs.sadclaw.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sadclaw.cloud/getting-started/quick-start.md).

# Quick start (5 minutes)

Go from zero to your first SadClaw VM in minutes.

SadClaw lets an agent pay **USDC on Solana** to buy a VM. The VM is owned as a **Metaplex NFT**.

{% hint style="info" %}
You'll use 3 things:

* The CLI (`npx sadclaw`)
* A Solana wallet with USDC
* USDC (Solana network)
  {% endhint %}

## 1) Run the CLI

```bash
npx sadclaw
```

If this is your first run, it should print help.

## 2) Initialize your wallet

```bash
npx sadclaw init
```

This creates a new Solana wallet for your agent, or lets you import an existing one.

**Expected output:**

```
🦀 SadClaw CLI
━━━━━━━━━━━━━━━━━━━━━━

✓ Wallet created successfully
  Address: 7xKX...abc123

Save your seed phrase securely!
```

## 3) Fund the wallet with USDC

Send USDC (on Solana) to your wallet address.

**Minimum amounts by tier:**

| Tier     | Min USDC (1 hour) |
| -------- | ----------------- |
| MICRO    | $0.04             |
| SMALL    | $0.06             |
| STANDARD | $0.10             |
| LARGE    | $0.20             |
| XLARGE   | $0.40             |

{% hint style="warning" %}
Make sure you're sending USDC on **Solana**, not Ethereum or other networks.
{% endhint %}

## 4) Check your balance

```bash
npx sadclaw balance
```

## 5) Buy your first VM

```bash
npx sadclaw buy --tier STANDARD --duration 24
```

**Options:**

* `--tier`: MICRO, SMALL, STANDARD, LARGE, XLARGE
* `--duration`: Hours (1-720)
* `--region`: fsn1 (Germany), nbg1 (Germany), hel1 (Finland)

**Expected output:**

```
🦀 Purchasing VM...

Tier: STANDARD
Duration: 24 hours
Cost: 2.40 USDC
Region: fsn1

✓ Transaction confirmed
✓ NFT minted: 9abc...xyz789
✓ VM provisioning...
✓ VM ready!

IP Address: 123.45.67.89
SSH User: root
```

## 6) Connect via SSH

```bash
npx sadclaw ssh 9abc...xyz789
```

Or manually:

```bash
ssh root@123.45.67.89
```

## Next steps

* [VM tiers & pricing](https://docs.sadclaw.cloud/guides/vm-tiers.md) - Compare all available tiers
* [Autonomous agents](https://docs.sadclaw.cloud/guides/autonomous-agents.md) - Integrate with your AI agent
* [SDK reference](https://docs.sadclaw.cloud/reference/sdk.md) - Programmatic access
