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

hetzner-cloud — скилл для Claude Code: управление облаком

Скилл для Claude Code управляет ресурсами Hetzner Cloud через CLI hcloud. Он подключается к запросам о Hetzner, кодах локаций или VPS в проекте на Hetzner.

MIT 125 установок ★ 74 обновлён 2026-11-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laguagu/claude-code-nextjs-skills --skill hetzner-cloud -a claude-code
Открыть на GitHub

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

Скилл управляет серверами и другими ресурсами Hetzner Cloud через установленный CLI hcloud: сетями, файрволами, балансировщиками, томами, DNS-зонами, SSH-ключами, IP-адресами, снимками и сертификатами. Он также помогает проверять состояние ресурсов и доступность сервиса после изменений.

Для записи в облако нужен авторизованный контекст проекта или переменная HCLOUD_TOKEN. SSH-ключи, сети и файрволы, назначенные новому серверу, должны существовать заранее. Скилл охватывает только Cloud, DNS и Storage Box через CLI; выделенные серверы Hetzner Robot сюда не входят.

Удаление ресурсов происходит сразу, а резервные копии сервера не включают подключённые тома. DNS-зона заработает после делегирования её серверов имён у регистратора.

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

  • создать сервер Hetzner Cloud в нужной локации
  • изменить правила файрвола и проверить их применение
  • подключить том к серверу в той же локации
  • проверить делегирование DNS-зоны
  • сохранить снимок перед удалением сервера

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

  • Создай VPS в Hetzner Cloud и проверь доступные типы серверов в локации fsn1.
  • Проверь правила файрвола перед заменой набора правил.
  • Проверь, делегирована ли DNS-зона на назначенные серверы имён.

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

1Через Skills CLI (Vercel)

npx skills add laguagu/claude-code-nextjs-skills --skill hetzner-cloud -a claude-code

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

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

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

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

Вопросы о hetzner-cloud

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

Выполни npx skills add laguagu/claude-code-nextjs-skills --skill hetzner-cloud -a claude-code. Файл скилла находится по пути ~/.claude/skills/hetzner-cloud/SKILL.md.

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

Он управляет ресурсами Hetzner Cloud через CLI hcloud и помогает проверять состояние инфраструктуры после изменений. Для Hetzner Robot, который обслуживает выделенные серверы, скилл не предназначен.

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

Нужен установленный CLI hcloud и авторизованный контекст проекта либо переменная HCLOUD_TOKEN. Для создания сервера также должны существовать назначаемые ему SSH-ключи, сети и файрволы.

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

SKILL.md · MIT
---
name: hetzner-cloud
description: Manage Hetzner Cloud infrastructure with the `hcloud` CLI — servers, networks, firewalls, load balancers, volumes, DNS zones, SSH keys, primary/floating IPs, snapshots, certificates, placement groups, storage boxes. Use whenever the user mentions Hetzner, hcloud or Hetzner location codes (fsn1, hel1, nbg1, ash, hil, sin), or wants a VPS or cloud server in a project that already runs on Hetzner — even if they don't say "hcloud". CLI-only; not for Hetzner Robot (dedicated servers, separate product and API).
---

# Hetzner Cloud

Use the installed `hcloud` CLI and its `--help`/JSON output for current
resource types, locations, flags and pricing. This covers Cloud/DNS/Storage
Box APIs supported by that CLI; dedicated servers/auctions use Hetzner Robot.

## Authentication and discovery

Use the authorized project's existing context or `HCLOUD_TOKEN`. A token in
an env file is not automatically exported. Creating a context normally
prompts; `hcloud context create --token-from-env <name>` uses the process
token without prompting. Keep tokens out of command arguments/logs.

Confirm project/context before writes. Discover server types, system images,
architecture, location/network zone and price through current CLI/API data
(`hcloud server-type list`, `hcloud location list`,
`hcloud image list --type system --architecture arm`, `hcloud all list` for the
whole project). Do not quote a remembered server specification or price.

## Dependencies and verification

Referenced SSH keys/firewalls/networks must exist before server creation.
Inspect a proposed firewall change against the current rules and retain a
working management path. `firewall replace-rules --rules-file` replaces the
set, so omitted rules disappear. `zone import-zonefile --zonefile` likewise
replaces all Zone RRSets; omitted records disappear.

Cloud Firewalls do not yet protect private Network traffic
or Load Balancers. Use host/application controls where needed. Verify rule
changes with fresh connections; established connections survive updates.

Treat server state, network reachability and application health as separate
checks. Read the API action result and resource state back after changes;
verify the intended service from its actual caller.

## Gotchas worth retaining

- A recycled IP can trigger SSH's changed-host-key warning. Authenticate the
  new fingerprint through a trusted console/channel before updating
  known_hosts; `ssh-keyscan` alone does not establish identity.
- Servers and Primary IPs lost their `datacenter` request/response property on
  2026-07-01. The CLI's `--datacenter` flags on `server create` and
  `primary-ip create` are removed; use `--location` (or `--assignee-id` for a
  Primary IP). The datacenter endpoints were removed on 2026-10-01, so the
  still-shipped `hcloud datacenter list/describe` commands fail with HTTP 410
  Gone. Inspect the server type's per-location availability and prices with
  `hcloud server-type describe <type> -o json`.
- Volumes are location-pinned; a server in another location cannot attach them.
  Private networks span locations within one network zone, not across zones.
- DNS zones do not take effect until the registrar delegates to the zone's
  assigned nameservers. Before debugging records, read the Authoritative
  Nameservers section of `hcloud zone describe <zone>` (JSON:
  `.authoritative_nameservers`): `delegation_status` should be `valid` and
  `delegated` should match `assigned`; `delegation_last_check` shows how old
  that result is.
- Deletion is immediate. Confirm resource IDs and the requested destructive
  scope; establish recoverable data first. Automatic backups are deleted with
  the server; snapshots survive. Create a Snapshot or
  convert a backup to one before deletion if recovery is required.
  Server snapshots/backups exclude
  attached Volumes, which need their own backup. See
  [snapshot scope](https://docs.hetzner.com/cloud/servers/backups-snapshots/overview/).
  Assigned Primary/Floating IPs cannot be deleted; unassign them first.
- `status: running` does not prove reachability. Inspect
  `hcloud server describe <srv> -o json | jq '.public_net | {v4:.ipv4.blocked, v6:.ipv6.blocked}'`
  for a provider block (abuse report or unpaid invoice) when several
  otherwise-open ports time out, SSH open to `0.0.0.0/0` included, or every
  server on the account fails at once. Such symptoms alone do not prove a
  block; a provider-level block needs Hetzner support, not an app firewall fix.
- `firewall create`/`replace-rules --rules-file` takes a bare JSON array of
  rule objects (the `rules` value of `hcloud firewall describe <fw> -o json`),
  not the API's `{"rules": [...]}` body, although the flag help points at the
  API schema. `source_ips`/`destination_ips` are arrays of CIDR strings
  (`203.0.113.4/32`, not a bare IP) and `port` is a string (`"22"`, `"80-85"`).
  In PowerShell serialize with `ConvertTo-Json -InputObject @($rules) -Depth 5`
  so a single rule stays an array. A parse or CIDR error rejects the whole file
  and leaves the previous rules in place; verify the returned/live rules.

## Sources

- [API changelog](https://docs.hetzner.cloud/changelog) for renames and removals
- [API reference](https://docs.hetzner.cloud/reference/cloud)
- [Product documentation](https://docs.hetzner.com/cloud/)
- [CLI manual/source](https://github.com/hetznercloud/cli/tree/main/docs/reference/manual)

© laguagu · MIT · laguagu/claude-code-nextjs-skills

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

Все скиллы по теме «DevOps и инфраструктура» →
hetzner-deploy fcakyon Скилл hetzner-deploy для управления инфраструктурой Hetzner Cloud через CLI hcloud: серверы, сети, файрволы, балансировщики, DNS-зоны и тома. CX Codex +1 ★ 1 216звёзд репо network-engineer VoltAgent Субагент network-engineer разбирает сетевой путь, проблемы подключения, балансировку и изменения инфраструктуры. Он помогает найти причину и проверить безопасный откат. CX Codex ★ 6 505звёзд репо hetzner-skills fcakyon Даёт доступ к Hetzner Cloud CLI прямо в среде разработки. Управляйте серверами, сетями, брандмауэрами, DNS и хранилищем через команды агента, не переключаясь в терминал. CX Codex ★ 1 216звёзд репо digitalocean-networking bobmatnyc Скилл digitalocean-networking с правилами построения сетей в DigitalOcean: VPC, фаерволы, балансировщики нагрузки и DNS. Помогает проектировать изолированные контуры для Droplets и Kubernetes. CX Codex +1 422установок huawei-cloud-billing-scout huaweicloud Скилл huawei-cloud-billing-scout для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Находит остатки на счёте, статьи расходов и расхождения в биллинге Huawei Cloud. CX Codex +1 18 500установок huawei-cloud-cli-guidance huaweicloud Скилл huawei-cloud-cli-guidance для Claude Code и Codex помогает работать с утилитой KooCLI в Huawei Cloud. Ассистент подсказывает синтаксис hcloud, правила авторизации и шаги разбора ошибок. CX Codex +1 239установок

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

Весь набор →
next-best-practices Скилл next-best-practices для Claude Code подсказывает практики Next.js App Router при написании и проверке кода. Помогает разбирать ошибки гидратации, границы RSC и проблемы с данными. CX Codex +1 286установок postgres-semantic-search Скилл postgres-semantic-search для Claude Code настраивает поиск и извлечение данных в PostgreSQL. Помогает собрать семантический или гибридный поиск, оценить качество результатов и разобраться со слабыми совпадениями. CX Codex +1 227установок cache-components Скилл cache-components даёт экспертные советы по кэшированию компонентов и частичному предрендерингу в Next.js 16.4+. CX Codex +1 222установок ai-sdk-6 Скилл ai-sdk-6 для работы с проектами на Vercel AI SDK v6. Помогает строить агентов, чат-ботов, инструменты и потоки структурированного вывода, если кодовая база уже на версии 6. CX Codex +1 218установок ai-app Скилл ai-app для Claude Code настраивает фулстек-приложения на Next.js с AI SDK и shadcn/ui. Запускается при создании чат-ботов, панелей управления агентами и ИИ-интерфейсов. CX Codex +1 198установок nextjs-chatbot Скилл nextjs-chatbot помогает собрать веб-чат на Next.js: подтверждение вызовов инструментов, сохранённая история, отрисовка результатов, подсказки и встраиваемый виджет. CX Codex +1 161установок ai-sdk Проверяет версию Vercel AI SDK в проекте и направляет агента к нужной документации. Включается при запросах о потоковом выводе, useChat, агентах и вызове инструментов. CX Codex +1 149установок go Скилл go для Claude Code запускает веб-приложение и проверяет правки интерфейса в браузере. Выявляет неработающие элементы, ошибки консоли и сбои сетевых запросов. CX Codex +1 112установок

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

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