Skip to content

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.jobs on the bus, one at a time, and writes results to claude.results.
  • Each job runs claude -p in 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 to main.
  • 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 /jobs with {"prompt": "...", "repo": "owner/name", "allowed_tools": "...", "notify": "telegram"} returns a job id
    • GET /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 /new to 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