proxmox — скилл для Claude Code: что делает и как установить
Справочник по администрированию Proxmox VE, управлению VM и LXC, настройке сетей, кластеров и резервного копирования.
MIT 1 установок ★ 7 обновлён 2026-01-20
npx skills add poindexter12/waypoint --skill proxmox -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/proxmox/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/proxmox/
1Через Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a codex2Вручную: положить файлы
.agents/skills/proxmox/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a cursor2Вручную: положить файлы
.cursor/skills/proxmox/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install poindexter12/waypoint technologies/skills/proxmox2Вручную: положить файлы
.github/skills/proxmox/SKILL.md1Через Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a gemini-cli2Командой платформы
gemini skills install https://github.com/poindexter12/waypoint --path technologies/skills/proxmoxВручную: положить файлы
.devin/skills/proxmox/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add poindexter12/waypoint --skill proxmox -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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