ROMFASTSQL/proxmox/claude-agent

Claude Agent LXC - Documentație

Informații Container

Parametru	Valoare
VMID	171
Hostname	claude-agent
IP intern	10.0.20.171
IP Tailscale	100.95.55.51
Host Proxmox	pveelite (10.0.20.202)
User	claude
Storage	local-zfs (32GB)
RAM	4GB
CPU	2 cores

Componente Instalate

• Ubuntu 24.04 LTS
• Node.js v20.x (via nvm)
• Claude Code
• tmux
• Git (configurat pentru Gitea)
• Tailscale

Conectare

De pe calculator (rețea internă)

ssh claude@10.0.20.171

De pe telefon/exterior (Tailscale)

ssh claude@100.95.55.51

VS Code Remote SSH

Config în ~/.ssh/config:

Host claude-agent
    HostName 10.0.20.171
    User claude

Scripturi Workflow

start-agent.sh

Pornește sau se atașează la sesiunea tmux "agent".

~/start-agent.sh

work.sh (recomandat)

Meniu interactiv pentru workflow complet:

• Listează proiectele disponibile în /workspace
• Permite crearea de branch-uri noi
• Continuarea pe branch-uri existente
• Finalizare task (commit + push)
• Vizualizare branch-uri

~/work.sh

new-task.sh

Creează branch nou pentru un task (hardcodat pentru romfastsql).

~/new-task.sh fix/nume-bug

finish-task.sh

Finalizează task-ul curent (commit + push).

~/finish-task.sh

Workflow Complet

De pe telefon (JuiceSSH + Tailscale)

1. Conectează-te la 100.95.55.51 cu user claude
2. Rulează:

~/start-agent.sh    # pornește tmux
~/work.sh           # meniu interactiv

3. Alege proiectul
4. Alege acțiunea (task nou / continuă / finalizează)
5. Lucrează cu Claude Code
6. Când termini: ~/work.sh → opțiunea 3 (finalizează)

De pe calculator (VS Code)

1. VS Code → Remote SSH → claude-agent
2. Open Folder → /workspace/<proiect>
3. Terminal → source ~/.nvm/nvm.sh && claude

Structura Directoare pe LXC

/home/claude/
├── .ssh/
│   ├── authorized_keys      # Chei SSH pentru acces
│   ├── gitea_ed25519        # Cheie pentru Gitea
│   └── config               # Config SSH pentru Gitea
├── .nvm/                    # Node Version Manager
├── .claude/
│   └── settings.json        # Permisiuni Claude Code
├── .tmux.conf               # Configurare tmux
├── start-agent.sh -> /workspace/start-agent.sh
└── work.sh -> /workspace/work.sh

/workspace/
├── start-agent.sh           # Script pornire tmux
├── work.sh                  # Script workflow interactiv
├── new-task.sh              # Script creare branch
├── finish-task.sh           # Script finalizare task
├── CLAUDE.md                # Info agent
├── SETUP-COMPLETE.md        # Documentație setup
├── romfastsql/              # Proiect clonat
└── test/                    # Alte proiecte

Comenzi tmux Utile

Comandă	Acțiune
Ctrl+A, d	Detașare din sesiune
Ctrl+A, c	Fereastră nouă
Ctrl+A, n	Fereastră următoare
Ctrl+A, p	Fereastră anterioară
Ctrl+A, [	Mod scroll (q pentru ieșire)
tmux attach -t agent	Reatașare la sesiune
tmux ls	Listare sesiuni

Git / Gitea

Clonare proiect nou

cd /workspace
git clone git@gitea.romfast.ro:romfast/<nume-repo>.git

Workflow branch-uri

git checkout main
git pull
git checkout -b feature/nume-feature
# ... lucrezi ...
git add .
git commit -m "descriere"
git push -u origin feature/nume-feature
# Creează Pull Request în Gitea

Troubleshooting

Claude Code nu pornește

source ~/.nvm/nvm.sh
which claude
claude --version

tmux nu găsește sesiunea

tmux ls
tmux new -s agent -c /workspace

Git clone eșuează

# Testează conexiunea SSH la Gitea
ssh -T git@gitea.romfast.ro

Tailscale nu funcționează

sudo systemctl status tailscaled
sudo tailscale status
tailscale ip

Instalare pe LXC nou

Scripturile pot fi copiate pe un LXC nou:

scp proxmox/claude-agent/*.sh claude@<ip>:/workspace/
ssh claude@<ip> "chmod +x /workspace/*.sh"
ssh claude@<ip> "ln -s /workspace/start-agent.sh ~/start-agent.sh"
ssh claude@<ip> "ln -s /workspace/work.sh ~/work.sh"

---

Data setup: 2025-12-31 Ultima actualizare: 2025-12-31