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

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

Справочник по администрированию Proxmox VE, управлению VM и LXC, настройке сетей, кластеров и резервного копирования.

MIT 1 установок ★ 7 обновлён 2026-01-20

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

Что делает proxmox

Скилл подключает справочную базу по Proxmox VE для работы с виртуальными машинами и контейнерами. Внутри собраны шпаргалки по консольным утилитам qm, pct, pvecm, pvesh и vzdump, чеклист валидации перед деплоем и готовые таблицы для выбора между VM и LXC.

Помимо базовых команд, архитектура скилла опирается на подключаемые тематические файлы. Они охватывают интеграцию с Terraform и Ansible, развёртывание через cloud-init, настройку мостов и VLAN, запуск Docker и диагностику типовых сбоев. Без установленного доступа к консоли хоста или API Proxmox скилл остаётся справочным руководством: исполнять команды он будет только через доступные агенту средства окружения.

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

  • подобрать консольные команды для управления VM через qm или контейнерами через pct
  • выбрать между виртуальной машиной и LXC под конкретную задачу
  • проверить готовность кластера, сети и хранилищ перед деплоем
  • настроить команды создания бэкапов vzdump и шаблоны cloud-init

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

  • Как снять блокировку с зависшей виртуальной машины с ID 104 в Proxmox?
  • Помоги составить команду vzdump для полного сжатого бэкапа всех виртуалок на диск
  • Что лучше выбрать в Proxmox для запуска Docker: LXC или полноценную VM?

Как установить proxmox

1Через Skills CLI (Vercel)

npx skills add poindexter12/waypoint --skill proxmox -a claude-code

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

~/.claude/skills/proxmox/SKILL.md

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

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

Вопросы о proxmox

Как установить proxmox в Claude Code?

Выполните в терминале команду npx skills add poindexter12/waypoint --skill proxmox -a claude-code.

Что делает скилл proxmox?

Он предоставляет агенту справочные инструкции по CLI Proxmox VE, архитектуре сетей, шаблонам автоматизации в Terraform и Ansible, а также алгоритмам устранения неполадок.

Умеет ли скилл сам подключаться к серверу Proxmox?

Скилл содержит только руководства, справочные команды и чеклисты. Доступ к реальному серверу зависит от прав и инструментов командной строки, настроенных в вашем терминале.

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

SKILL.md · MIT
---
name: proxmox
description: |
  Proxmox VE virtualization platform reference for VM/LXC management, clustering,
  storage, and networking. Includes Terraform and Ansible integration patterns.
  Use when working with Proxmox configurations, CLI commands, troubleshooting
  VMs/containers, or planning resource allocation.
  Triggers: proxmox, qemu, kvm, lxc, pve, vm, container, cluster, vzdump, qm, pct.
agent: proxmox-expert
---

# Proxmox Skill

Proxmox VE virtualization platform reference for VM management, containers, clustering, and homelab infrastructure.

## Quick Reference

```bash
# VM management (qm)
qm list                           # List all VMs
qm status <vmid>                  # Check VM status
qm start <vmid>                   # Start VM
qm stop <vmid>                    # Stop VM (graceful)
qm shutdown <vmid>                # Shutdown VM (ACPI)
qm unlock <vmid>                  # Remove lock
qm config <vmid>                  # Show VM config

# Container management (pct)
pct list                          # List all containers
pct status <ctid>                 # Check container status
pct start <ctid>                  # Start container
pct stop <ctid>                   # Stop container
pct enter <ctid>                  # Enter container shell

# Cluster management (pvecm)
pvecm status                      # Cluster status and quorum
pvecm nodes                       # List cluster nodes

# API shell (pvesh)
pvesh get /nodes                  # List nodes via API
pvesh get /nodes/<node>/status    # Node resource status

# Backup (vzdump)
vzdump <vmid> --mode snapshot --storage <storage>
vzdump --all --compress zstd
```

## Reference Files

Load on-demand based on task:

| Topic | File | When to Load |
|-------|------|--------------|
| VM vs LXC | [vm-lxc.md](references/vm-lxc.md) | Choosing virtualization type |
| Docker Hosting | [docker-hosting.md](references/docker-hosting.md) | Running Docker on Proxmox |
| Networking | [networking.md](references/networking.md) | Bridges, VLANs, SDN, firewall |
| Storage | [storage.md](references/storage.md) | Storage backends, content types |
| Cloud-init | [cloud-init-templates.md](references/cloud-init-templates.md) | VM provisioning with cloud-init |
| Clustering | [clustering.md](references/clustering.md) | HA, quorum, fencing |
| Backup | [backup.md](references/backup.md) | vzdump modes, restore |
| CLI Tools | [cli-tools.md](references/cli-tools.md) | qm, pct, pvecm, pvesh commands |
| Troubleshooting | [troubleshooting.md](references/troubleshooting.md) | Common errors, diagnostics |
| Automation Tools | [automation-tools.md](references/automation-tools.md) | Terraform/Ansible integration |

## Validation Checklist

Before deploying VMs/containers:

- [ ] Cluster status healthy (`pvecm status`)
- [ ] Node resources available (CPU, RAM, disk)
- [ ] Storage accessible and mounted
- [ ] Network bridges configured correctly
- [ ] VLAN tags match network design
- [ ] Resource allocation within node limits
- [ ] HA configuration correct (if enabled)
- [ ] Backup schedule in place
- [ ] Naming convention followed

## VM vs LXC Quick Decision

| Factor | Use VM | Use LXC |
|--------|--------|---------|
| OS | Windows, BSD, any | Linux only |
| Isolation | Full kernel isolation | Shared kernel |
| Performance | Good | Better (lighter) |
| Startup | Slower | Fast |
| Density | Lower | Higher |
| Complexity | Any workload | Simple services |

## Homelab Network VLANs

| VLAN | Purpose | Proxmox Bridge |
|------|---------|----------------|
| 5 | Management (Web UI, API, SSH) | vmbr5 |
| 1 | Trusted network | vmbr0 |
| 11 | Storage (NFS/Ceph, MTU 9000) | vmbr11 |
| 12 | High-speed transfers | vmbr12 |

© poindexter12 · MIT · poindexter12/waypoint

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

Все скиллы по теме «DevOps и инфраструктура» →
proxmox-admin github.com/bastos Скилл proxmox-admin для работы с Proxmox VE из терминала: создаёт ВМ через qm, контейнеры через pct, настраивает хранилища и кластеры. CX Codex +1 886установок mcp-proxmox antonio-mello-ai MCP-сервер mcp-proxmox подключает Claude Code к Proxmox VE для управления виртуальными машинами, контейнерами, хранилищами и снапшотами. Инфраструктурой можно управлять через запросы. CX Codex +1 ★ 17звёзд репо Proxmox VE gethosthewalrus MCP-сервер с инструментами Proxmox VE: узлы, VM, контейнеры, сеть и файрвол. Ассистент управляет кластером через API, а не через веб-интерфейс. CX Codex +1 qemu-kvm mohitmishra786 Скилл qemu-kvm ведёт агента по запуску виртуальных машин на QEMU с ускорением KVM: флаги, virtio-устройства, проброс VFIO и загрузка своих ядер. CX Codex +1 395установок Proximo — the Proxmox MCP you can hand the keys john-broadway Proximo — the Proxmox MCP you can hand the keys — MCP-сервер для управления Proxmox VE, PBS, PMG и PDM через языковые модели: показывает план и радиус изменений до выполнения команды. CX Codex +1 ★ 96звёзд репо Proxmox MCP Servosity Read-only MCP-сервер и CLI для Proxmox VE и Backup Server: показывает по всем клиентским кластерам, у каких гостей есть свежая проверенная точка восстановления, а у каких нет. CX Codex +1 ★ 87звёзд репо

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

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