К основному содержанию
скилл CX Codex

hetzner-deploy — скилл для Claude Code: что делает и как установить

Скилл hetzner-deploy для управления инфраструктурой Hetzner Cloud через CLI hcloud: серверы, сети, файрволы, балансировщики, DNS-зоны и тома.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install hetzner-skills@claude-settings
Открыть на GitHub

Что делает hetzner-deploy

Скилл подключает дерево решений и справочные файлы для hcloud — CLI Hetzner Cloud. Агент получает шаблоны команд для создания серверов (hcloud server create), настройки приватных сетей, файрволов, балансировщиков нагрузки, блочных томов и DNS-зон. Внутри — деревья команд по типам ресурсов (compute, networking, storage, DNS), готовые воркфлоу (быстрый деплой сервера, full-stack с сетью и файрволом) и примеры вывода в JSON, YAML и Go-шаблонах для скриптов.

Аутентификация через API-токен Hetzner Cloud в переменной HCLOUD_TOKEN или именованный контекст hcloud context create. Токен генерируется в консоли проекта, раздел Security > API Tokens. Без токена команды не выполнятся.

Скилл советует запрашивать актуальные типы серверов, цены и локации через CLI (hcloud server-type list, hcloud location list), а не полагаться на устаревшие данные агента.

Какие задачи решает

  • создать сервер Hetzner с cloud-init, файрволом и приватной сетью
  • настроить Load Balancer с несколькими таргетами
  • импортировать DNS-зону из файла
  • подключить блочный том к серверу с автомонтированием
  • получить список доступных типов серверов и цен

Примеры запросов агенту

  • Разверни сервер cpx21 с Ubuntu 24.04 в Нюрнберге, добавь файрвол для SSH и HTTPS
  • Создай приватную сеть 10.0.0.0/16 и подключи к ней сервер app-1
  • Настрой Load Balancer для серверов web-1 и web-2 на порту 80

Как установить hetzner-deploy

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install hetzner-skills@claude-settings

Команда ставит плагин hetzner-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill hetzner-deploy -a claude-code

3Вручную: положить файлы

~/.claude/skills/hetzner-deploy/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hetzner-deploy/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hetzner-deploy

Как установить hetzner-deploy в Claude Code?

Выполни /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install hetzner-skills@claude-settings. Скилл появится в ~/.claude/skills/hetzner-deploy/SKILL.md.

Что делает hetzner-deploy?

Подключает справочники команд hcloud и деревья решений для работы с инфраструктурой Hetzner Cloud: серверами, сетями, файрволами, балансировщиками, DNS и блочными томами. Агент получает шаблоны команд и воркфлоу для типовых задач.

Что нужно для работы hetzner-deploy?

Установленный hcloud CLI и API-токен проекта Hetzner Cloud в переменной окружения HCLOUD_TOKEN или в именованном контексте. Без токена команды не выполнятся.

Исходный текст

SKILL.md · MIT
---
name: hetzner-deploy
description: This skill should be used when user asks to "deploy to Hetzner", "create Hetzner server", "manage Hetzner Cloud", "hcloud CLI", or works with Hetzner Cloud infrastructure including servers, networks, firewalls, load balancers, DNS zones, and volumes.
references:
  - server
  - network
  - firewall
  - getting-started
license: MIT
---

# Hetzner Cloud CLI Skill

Skill for provisioning and managing infrastructure on Hetzner Cloud using the `hcloud` CLI. Use the decision trees below to find the right command group, then load detailed references.

Your knowledge of Hetzner Cloud pricing, server types, locations, and API behavior may be outdated. **Prefer retrieval over pre-training** when citing specific numbers, available types, or configuration options. The reference files alongside this skill are starting points extracted from the official CLI docs.

## Authentication

The CLI authenticates via API token. Set the `HCLOUD_TOKEN` environment variable or create a named context:

```bash
# Stateless (CI, scripting, agent use)
export HCLOUD_TOKEN="your-api-token"

# Named context (interactive use)
hcloud context create my-project
```

Generate tokens at https://console.hetzner.cloud under your project's Security > API Tokens.

## Installation

```bash
# macOS / Linux (Homebrew)
brew install hcloud

# Linux (binary)
curl -sSLO https://github.com/hetznercloud/cli/releases/latest/download/hcloud-linux-amd64.tar.gz
sudo tar -C /usr/local/bin --no-same-owner -xzf hcloud-linux-amd64.tar.gz hcloud

# Docker
docker run --rm -e HCLOUD_TOKEN="$HCLOUD_TOKEN" hetznercloud/cli:latest <command>
```

## Quick Decision Trees

### "I need compute"

```
Need a server?
├─ Create a new server → hcloud server create --name <n> --type <t> --image <img>
├─ With cloud-init user data → add --user-data-from-file <path>
├─ With firewall + network → add --firewall <fw> --network <net>
├─ List available types → hcloud server-type list
├─ List available images → hcloud image list
├─ SSH into server → hcloud server ssh <name>
├─ Create snapshot → hcloud server create-image --type snapshot <name>
├─ Rescue mode → hcloud server enable-rescue <name>
└─ Delete server → hcloud server delete <name>
```

### "I need networking"

```
Need networking?
├─ Private network (VPC) → hcloud network create --name <n> --ip-range <cidr>
│  ├─ Add subnet → hcloud network add-subnet --network <n> --type cloud --network-zone <z> --ip-range <cidr>
│  └─ Attach server → hcloud server attach-to-network --network <n> --server <s>
├─ Firewall → hcloud firewall create --name <n> --rules-file <json>
│  ├─ Apply to server → hcloud firewall apply-to-resource --firewall <n> --type server --server <s>
│  └─ Replace rules → hcloud firewall replace-rules --rules-file <json> <name>
├─ Load balancer → hcloud load-balancer create --name <n> --type <t> --location <loc>
│  ├─ Add target → hcloud load-balancer add-target --server <s> <lb>
│  └─ Add service → hcloud load-balancer add-service --protocol <p> --listen-port <port> <lb>
├─ Floating IP → hcloud floating-ip create --type ipv4 --home-location <loc>
│  └─ Assign → hcloud floating-ip assign <ip> --server <s>
└─ Primary IP → hcloud primary-ip create --name <n> --type ipv4 --datacenter <dc>
```

### "I need storage"

```
Need storage?
├─ Block volume → hcloud volume create --name <n> --size <gb> --server <s> --automount --format ext4
│  ├─ Resize → hcloud volume resize --size <gb> <name>
│  └─ Detach → hcloud volume detach <name>
└─ Storage Box (managed NFS/CIFS/SCP) → hcloud storage-box create --name <n> --type <t> --location <loc>
   ├─ Subaccounts → hcloud storage-box subaccount create <box>
   └─ Snapshots → hcloud storage-box snapshot create <box>
```

### "I need DNS"

```
Need DNS?
├─ Create zone → hcloud zone create --name <domain>
├─ Add records → hcloud zone add-records --zone <z> --type A --name <n> --value <ip>
├─ Set full record set → hcloud zone set-records --zone <z> --type A --name <n> --value <ip1> --value <ip2>
├─ Import zone file → hcloud zone import-zonefile --zone <z> <file>
├─ Export zone file → hcloud zone export-zonefile <zone>
└─ Manage individual RRSets → hcloud zone rrset list <zone>
```

### "I need info"

```
Need reference data?
├─ Server types + pricing → hcloud server-type list / describe <type>
├─ Locations → hcloud location list / describe <loc>
├─ Datacenters → hcloud datacenter list / describe <dc>
├─ Available images → hcloud image list
├─ ISO images → hcloud iso list
├─ Load balancer types → hcloud load-balancer-type list
└─ Storage box types → hcloud storage-box-type list
```

### "I need to configure the CLI"

```
Need CLI config?
├─ Create context → hcloud context create <name>
├─ Switch context → hcloud context use <name>
├─ Set default SSH key → hcloud config set default-ssh-keys <key>
├─ View config → hcloud config list
└─ Shell completion → hcloud completion bash/zsh/fish
```

## Common Workflows

### Quick server deploy

```bash
# Upload SSH key, create server, connect
hcloud ssh-key create --name deploy-key --public-key-from-file ~/.ssh/id_ed25519.pub
hcloud server create --name web-1 --type cpx21 --image ubuntu-24.04 --ssh-key deploy-key --location fsn1
hcloud server ssh web-1
```

### Full stack with network + firewall

```bash
# Network
hcloud network create --name prod-net --ip-range 10.0.0.0/16
hcloud network add-subnet --network prod-net --type cloud --network-zone eu-central --ip-range 10.0.1.0/24

# Firewall (allow SSH + HTTP/S)
cat > rules.json << 'EOF'
[
  {"direction":"in","protocol":"tcp","port":"22","source_ips":["0.0.0.0/0","::/0"]},
  {"direction":"in","protocol":"tcp","port":"80","source_ips":["0.0.0.0/0","::/0"]},
  {"direction":"in","protocol":"tcp","port":"443","source_ips":["0.0.0.0/0","::/0"]}
]
EOF
hcloud firewall create --name web-fw --rules-file rules.json

# Server with network + firewall
hcloud server create --name app-1 --type cpx21 --image ubuntu-24.04 \
  --ssh-key deploy-key --network prod-net --firewall web-fw --location fsn1

# Load balancer
hcloud load-balancer create --name web-lb --type lb11 --location fsn1
hcloud load-balancer attach-to-network --network prod-net web-lb
hcloud load-balancer add-target --server app-1 web-lb
hcloud load-balancer add-service --protocol tcp --listen-port 80 --destination-port 80 web-lb
```

## Output Formats

All `describe`, `list`, and `create` commands support structured output for scripting and agent use:

```bash
hcloud server list --output json          # JSON array
hcloud server describe my-srv --output yaml  # YAML
hcloud server describe my-srv --output format='{{.ServerType.Cores}}'  # Go template
hcloud server list --output columns=id,name,status  # Custom table columns
```

## Resource Index

### Compute
| Resource | Reference |
|----------|-----------|
| Server | `references/server/` |
| Server Types | `references/info/` |

### Networking
| Resource | Reference |
|----------|-----------|
| Network (VPC) | `references/network/` |
| Firewall | `references/firewall/` |
| Load Balancer | `references/load-balancer/` |
| Floating IP | `references/floating-ip/` |
| Primary IP | `references/primary-ip/` |

### Storage
| Resource | Reference |
|----------|-----------|
| Volume | `references/volume/` |
| Storage Box | `references/storage-box/` |

### DNS
| Resource | Reference |
|----------|-----------|
| Zone & Records | `references/dns/` |

### Security & Access
| Resource | Reference |
|----------|-----------|
| SSH Key | `references/ssh-key/` |
| Certificate | `references/certificate/` |
| Image | `references/image/` |
| Placement Group | `references/placement-group/` |

### Reference Data
| Resource | Reference |
|----------|-----------|
| Server Types, LB Types, Storage Box Types, Datacenters, Locations, ISOs | `references/info/` |

### CLI Configuration
| Resource | Reference |
|----------|-----------|
| Config, Context, Completion | `references/config/` |
| All Resources | `references/all/` |
| Raw API Calls | `references/api/` |

### Getting Started
| Resource | Reference |
|----------|-----------|
| Setup, Server Tutorial, Output Options, Configuration | `references/getting-started/` |

© fcakyon · MIT · fcakyon/claude-codex-settings

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
hetzner-cloud laguagu Управляет ресурсами Hetzner Cloud через CLI hcloud. Он подключается к запросам о Hetzner, кодах локаций или VPS в проекте на Hetzner. CX Codex +1 125установок aracli-deploy-management reason-machines Скилл aracli-deploy-management для Claude Code разбирает развёртывание и управление совместимыми с OpenClaw ИИ-агентами. Помогает сравнить облако, собственные серверы и способы управления. CX Codex +1 1 200установок modal-serverless-gpu Orchestra Research Скилл modal-serverless-gpu для Claude Code и Codex по запуску ML-задач на серверных GPU Modal: обучение, инференс, батчи без поднятия собственного кластера. CX Codex +1 1 100установок openai-cloudflare-deploy OpenAI Скилл openai-cloudflare-deploy для Claude Code автоматизирует развёртывание приложений и инфраструктуры на Cloudflare: Workers, Pages, хранилища, базы данных и сервисы безопасности. CX Codex +1 ★ 540звёзд репо zeabur zeabur Помогает управлять проектами и сервисами Zeabur через CLI. Управляет деплоем, доменами, переменными, логами и диагностикой. ★ 38звёзд репо azure Microsoft Подключает Claude Code к Azure для управления ресурсами, деплоя приложений и мониторинга сервисов. Подходит для задач облачной инфраструктуры. ★ 3 232звёзд репо

Из того же набора113

Весь набор →
supabase-js Скилл снабжает ассистента шпаргалками и синтаксисом официального SDK @supabase/supabase-js: от базовых фильтров PostgREST до загрузки файлов и Edge Functions. CX Codex +1 ★ 1 216звёзд репо create-pr Скилл create-pr для Claude Code готовит pull request для ревью: проверяет ветку и изменения, собирает результаты проверок и публикует PR через gh. CX Codex +1 ★ 1 216звёзд репо electron Скилл для управления десктоп-приложениями на Electron (Slack, VS Code, Discord, Figma, Notion, Spotify) через Chrome DevTools Protocol. CX Codex +1 ★ 1 216звёзд репо pull Команда pull для Claude Code синхронизирует локальную конфигурацию, схему базы и Edge Functions со связанным проектом Supabase. Обновляет локальные данные одной командой. CX Codex +1 ★ 1 216звёзд репо ui-regression Скилл ui-regression проверяет интерфейсы веб-приложений и браузерных расширений на локальном сервере, стейджинге или проде: сценарии, локализацию, ошибки и вёрстку. CX Codex +1 ★ 1 216звёзд репо humanize Скилл humanize для Claude Code переписывает текст, чтобы убрать шаблонный тон и сохранить смысл. Срабатывает на просьбы отредактировать ответы, документацию, комментарии, письма и другие тексты. CX Codex +1 ★ 1 216звёзд репо writing-guidelines Скилл writing-guidelines проверяет техническую документацию и тексты интерфейса на соответствие редполитике, лаконичность и признаки машинной генерации. CX Codex +1 ★ 1 216звёзд репо aeo Скилл помогает строить AEO-стратегию, находить пробелы в ответах ИИ и планировать контент для видимости продукта в AI-поиске. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой