claude-code-hetzner-vps

claude-code-hetzner-vps

Spin up a secure, Claude Code-ready VPS for ~$5/month in under 5 minutes.

A free tool by Pete Sena | The Resonance Labs

---

What is Claude Code?

Claude Code is Anthropic's official CLI tool that lets you use Claude AI directly in your terminal. It can read files, write code, run commands, and help you build software faster. This plugin extends Claude Code with commands to provision secure cloud servers.

---

Installation

Option 1: From Marketplace (Easiest)

# In Claude Code
/plugin marketplace add The-Resonance/claude-code-hetzner-vps
/plugin install claude-code-hetzner-vps

Option 2: Clone and Use

# Clone the plugin
git clone https://github.com/The-Resonance/claude-code-hetzner-vps.git ~/.claude-plugins/hetzner-vps

# Start Claude Code with the plugin
claude --plugin-dir ~/.claude-plugins/hetzner-vps

Option 3: Test Locally

git clone https://github.com/The-Resonance/claude-code-hetzner-vps.git
cd claude-code-hetzner-vps
claude --plugin-dir .

Once loaded, you'll have access to these commands:

• /provision - Create a secure VPS
• /status - Check server status
• /destroy - Delete a server
• /cost-estimate - See pricing before you spend

---

The Problem

You want to run Claude Code on a remote server—maybe for longer tasks, CI/CD pipelines, or just to keep your laptop free. But setting up a secure cloud server means:

• Configuring firewalls
• Hardening SSH
• Setting up fail2ban
• Installing dependencies
• ...and hoping you didn't miss a security step

The Solution

One command. Fully secured. Claude Code pre-installed.

/provision my-server

That's it. You get:

• UFW firewall blocking everything except SSH
• fail2ban banning brute-force attackers
• SSH hardening (key-only, no root, limited retries)
• Automatic security updates
• Claude Code ready to use

---

5-Minute Setup (Complete Walkthrough)

Step 1: Create a Hetzner Account

1. Go to console.hetzner.cloud
2. Click Register and create an account
3. Verify your email
4. You may need to add payment info (no charge until you provision)

Step 2: Create a Project

1. In the Hetzner Console, click + New Project
2. Name it something like claude-servers
3. Click into your new project

Step 3: Generate an API Token

1. Go to Security → API Tokens
2. Click Generate API Token
3. Name it claude-code-cli
4. Select Read & Write permissions
5. Click Generate
6. Copy the token immediately (you won't see it again!)

Step 4: Install the hcloud CLI

macOS:

brew install hcloud

Linux:

curl -fsSL https://github.com/hetznercloud/cli/releases/latest/download/hcloud-linux-amd64.tar.gz | tar xz
sudo mv hcloud /usr/local/bin/

Step 5: Configure hcloud Authentication

hcloud context create claude-servers

When prompted, paste your API token from Step 3.

Verify it works:

hcloud server list

Should return an empty list (no errors).

Step 6: Ensure You Have an SSH Key

Check if you have one:

ls ~/.ssh/id_ed25519.pub || ls ~/.ssh/id_rsa.pub

If not, generate one:

ssh-keygen -t ed25519 -C "[email protected]"

Press Enter to accept defaults.

Step 7: Provision Your Server

# Check cost first
/cost-estimate cx22

# Create the server
/provision my-dev-server cx22 nbg1

This takes about 60 seconds. You'll see the server IP when done.

Step 8: Connect via SSH

Wait ~2 minutes for cloud-init to complete, then:

ssh claude@<your-server-ip>

You'll see the branded welcome message confirming security features are active.

Step 9: Use Claude Code

claude

Done! You're running Claude Code on your own secure VPS.

---

GitHub + Vercel Workflow

To push code and work with Vercel, set up GitHub authentication on your server:

Install GitHub CLI

sudo apt install gh -y

Authenticate with GitHub

gh auth login

Select:

• GitHub.com
• HTTPS
• Yes (authenticate with browser)
• Login with a one-time code

Set Up SSH Key for Git

# Generate a key for this server
ssh-keygen -t ed25519 -C "your-server-name"

# Add the required scope (important!)
gh auth refresh -h github.com -s admin:public_key

# Add the key to your GitHub account
gh ssh-key add ~/.ssh/id_ed25519.pub --title "my-hetzner-server"

# Test the connection
ssh -T [email protected]

Clone and Work

# Clone your repo
git clone [email protected]:username/your-repo.git
cd your-repo

# Run Claude Code
claude