# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This repository documents and manages a 3-node Proxmox VE cluster ("PVECluster") running at 192.168.88.73/249/247. It contains infrastructure documentation and will serve as the base for automation scripts and tooling.

## Proxmox VE API Access

All API calls go through `https://192.168.88.247:8006/api2/json/`. Authenticate with:

```
Authorization: PVEAPIToken=root@pam!claude=17e96169-a32f-4e2d-951e-859c77770306
```

SSH is available to all three nodes (88.73, 88.249, 88.247) with password `25915525` (root@pam). Use `pvesh` over SSH for CLI-based management. Any node IP can serve as the API entry point — they share the same management interface.

## Cluster Topology

- **3 heterogeneous nodes**:
  - `pve-000` (192.168.88.73) — 4C / 32 GB — runs most LXCs + medium VMs (16 guests)
  - `pve-001` (192.168.88.249) — 24C / 132 GB — runs heavy Windows VMs and OpenArchiver (9 guests)
  - `pve-002` (192.168.88.247) — 4C / 16 GB IBM x3250 M4 (Xeon E3-1220 v2) — currently idle, used as management/SSH entry point
- **Primary storage**: Synology DS1621 at 192.168.88.60 via iSCSI (`pve-iscsi-3t`, 4.5 TB shared LVM)
- **Backup storage**: Proxmox Backup Server (VM 101 at 192.168.88.169, datastore `backup1`, 1 TB)
- **Networking**:
  - `vmbr0` — main 192.168.88.0/24 LAN (all nodes)
  - `vmbr1` — 192.168.77.0/24 OpenWRT LAN (pve-000 only, IP .241)
  - `vmbr2` — OpenWRT WAN bridge (pve-000 only, no IP)
  - Default gateway: `192.168.88.1` (upstream router)
- **Internet routing**: VM 115 OpenWRT runs HiNet PPPoE (210.242.157.197) and serves the 192.168.77.0/24 subnet

## Key Files

- `PVE_API.md` — API authentication methods, endpoint reference, token management
- `API.md` — Full Proxmox VE API reference handbook
- `PVECluster_Architecture.md` — Full cluster architecture: nodes, VMs/CTs, storage, networking, backup strategy
- `SUMMARY.md` — Real-time cluster status snapshot
- `QUICKSTART.md` — 5-minute getting-started guide

## Notable Points

- VMs are tagged by owner (`veljko`, `chao`, `lucas`, `celia`, `gia`, `apollo`, `vic`, `timmy`) — useful for filtering
- Backup schedule is daily at 23:00, retains 7 daily, covers 14 critical VMs/CTs
- `pve-002` has zero workload — available as failover target or batch-job runner
- VM 115 (OpenWRT) is a single point of failure for the 192.168.77.0/24 subnet

## Language

Always respond in Traditional Chinese (繁體中文，台灣用語).