# 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.42.38/39/40. 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.42.38:8006/api2/json/`. Authenticate with:

```
Authorization: PVEAPIToken=root@pam!claude=fefcffca-df6e-48de-8adf-7907cd2ea879
```

SSH is available to all three nodes (42.38, 42.39, 42.40) without password from the development machine. Use `pvesh` over SSH for CLI-based management.

## Cluster Topology

- **3 identical nodes**: Intel i3-6100 (2C/4T), 16GB RAM each
- **Primary storage**: Synology NAS at 192.168.42.20 via iSCSI (`syno-lvm`, 1TB shared LVM)
- **Backup storage**: Synology CIFS (`synology-backup`, 2.75TB) + Proxmox Backup Server (VM 111 at 192.168.42.30)
- **Networking**: All VMs/CTs on `vmbr0`, static IPs matching VMID pattern `192.168.42.<VMID>`
- **Gateway**: 192.168.42.10 (OpenWRT VM 110 handles routing/firewall)

## Key Files

- `PVE_API.md` — API authentication methods, endpoint reference, token management
- `PVECluster_Architecture.md` — Full cluster architecture: nodes, VMs/CTs, storage, networking, backup strategy

## Language

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