diff --git a/CLAUDE.md b/CLAUDE.md
index d2413bb..226fe2b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -377,6 +377,42 @@ tests/
 
 Reference documentation: `~/Projects/homelab/`
 
+### Central Reference Files
+
+| File | Purpose | Usage |
+|------|---------|-------|
+| `~/.secrets` | API keys and passwords | `source ~/.secrets` |
+| `~/.hosts` | IPs, hostnames, URLs | `source ~/.hosts` |
+| `~/.ssh/config` | SSH aliases and keys | `ssh pve`, `ssh truenas` |
+
+### SSH Access
+
+**Primary key**: `~/.ssh/homelab` (used for all homelab hosts)
+
+```bash
+# Use aliases from ~/.ssh/config
+ssh pve              # Proxmox primary
+ssh pve2             # Proxmox secondary
+ssh truenas          # NAS
+ssh saltbox          # Media services
+ssh docker-host      # Docker services
+ssh lmdev1           # AI dev with GPU
+ssh trading-vm       # Trading with A6000
+ssh pihole           # DNS
+ssh traefik          # Reverse proxy
+```
+
+### Hosts Reference
+
+Source `~/.hosts` for IP variables:
+```bash
+source ~/.hosts
+curl http://$IP_TRUENAS:8080/api/...
+ping $IP_GATEWAY
+hosts_list    # Show all hosts
+hosts_check   # Ping critical hosts
+```
+
 ### API Credentials
 
 **Central secrets file**: `~/.secrets`