Appearance
Claude on the server
Claude Code also runs on the server, signed in with my Claude subscription (a token from claude setup-token), so it isn't billed per call.
The runner
claude-runner (apps/claude-runner) is an internal-only Coolify app.
- It reads jobs from
claude.jobson the bus, one at a time, and writes results toclaude.results. - Each job runs
claude -pin a throwaway folder, which is deleted afterwards, optionally with a GitHub repo cloned into it. - By default the tools are read-only:
Read, Grep, Glob, WebFetch, WebSearch. A job can ask for others. Anything that edits code should push a branch and open a PR, never push tomain. - Jobs are capped at 30 turns and 30 minutes, and run with
--permission-mode dontAsk, so anything not allowed is refused rather than prompted. - There's a small HTTP API on
:8080, reachable on the internal network only and protected by a bearer token:POST /jobswith{"prompt": "...", "repo": "owner/name", "allowed_tools": "...", "notify": "telegram"}returns a job idGET /jobs/<id>returns the result once it's done
- Inside the container,
runner submit "prompt"queues a job and waits for the answer.
sh
infra ssh 'sudo docker exec claude-runner runner submit "what changed in n8n today?"'Telegram chat
The runner also polls my Telegram bot. Messages from my chat only become jobs, and the answer comes back as a reply. Messages from anyone else are ignored and logged.
- The conversation carries on between messages, because jobs reuse one saved Claude session. Send
/newto start a fresh one. - It has the Coolify MCP tools with a read-only token, so it can look at apps, logs, deployments, backups and metrics, but can't change anything. When something needs doing, it says what to run.
- Its reply style is set to short, plain text, suited to a phone.
Interactive use
Claude Code is also installed for stu on the server itself. For a long session:
sh
infra ssh
tmux new -s claude
claude