logo
Back to Templates
icon

Claude Code

Anthropic's AI coding agent CLI running as a persistent developer workstation. Connect via Zeabur Terminal to use Claude Code for code generation, editing, debugging, and git operations.

template cover
Deployed215 times
PublisherzeaburZeabur
Created2026-03-30
SourceView Source
Minimum1 Cores4 GB
Recommended2 Cores4 GB
Tags
AIDeveloper Tools

Services

service icon

claude-code

zeabur/claude-code:latest

Claude Code

Claude Code is Anthropic's official AI-powered coding agent CLI. It understands your codebase, generates and edits code, runs commands, and helps with complex development tasks -- all from the command line.

This template deploys Claude Code as a persistent developer workstation on Zeabur with a web-based terminal (ttyd) accessible from your browser.

Getting Started

  1. Deploy the template and wait for the service to start. The first boot installs Claude Code and channel plugins automatically — wait until the health check turns green before proceeding.
  2. Open the service URL in your browser (the domain bound to your service).
  3. Log in — enter the password from the Instructions tab on the Zeabur dashboard.
  4. Select options — check the options you want (e.g. skip permissions, Telegram/Discord channel).
  5. Enter bot token (if using channels) — paste your bot token into the input field that appears.
  6. Copy the command and click Enter Terminal.
  7. Authenticate Claude Code — paste the command, then follow the login prompts to sign in with your Claude Pro/Max/Team/Enterprise subscription.

Channels (Telegram / Discord)

Channels let you chat with Claude Code from your phone via Telegram or Discord while it works on your files.

Setup

  1. Create a bot — BotFather for Telegram, or Discord Developer Portal for Discord (enable Message Content Intent, invite bot with Send Messages permission).
  2. Select the channel on the landing page and paste your bot token.
  3. Copy and run the command in the terminal — the channel starts automatically.
  4. Pair your account — DM your bot, it replies with a pairing code. Run /discord:access pair <code> or /telegram:access pair <code> in Claude Code.
  5. Lock down access — run /discord:access policy allowlist or /telegram:access policy allowlist so only you can send messages.

After pairing, you can chat with Claude from Telegram/Discord. Your bot token is saved in the browser for next time.

Notes

  • Channels require a Claude Pro/Max/Team/Enterprise subscription (not API key).
  • The bot token is passed as an environment variable in the command (e.g. DISCORD_BOT_TOKEN=xxx claude ...) — it is NOT stored on the server.
  • Channels are an experimental feature in Claude Code.

Using API Key (Optional)

If you prefer API key authentication instead of a subscription:

  1. Set ANTHROPIC_API_KEY to your Anthropic API key from console.anthropic.com.
  2. Optionally set ANTHROPIC_BASE_URL to use Zeabur AI Hub (e.g., https://ai.hub.zeabur.com).

Common Commands

CommandDescription
claudeStart interactive Claude Code session
claude -p "prompt"Run a one-shot prompt
claude loginAuthenticate with Anthropic
claude --versionCheck installed version
claude configView or modify configuration

Persistent Storage

The /home/node directory is mounted as a persistent volume. All your projects, Claude Code configuration, and session data stored under /home/node will survive service restarts and redeployments.

Recommended workflow:

  • Clone repositories into /home/node/projects/
  • Your Claude Code settings are stored in /home/node/.claude/

Environment Variables

VariableRequiredDescription
ANTHROPIC_API_KEYNoAnthropic API key or Zeabur AI Hub token (only needed if not using subscription login)
ANTHROPIC_BASE_URLNoCustom API endpoint (set this for Zeabur AI Hub)
WEB_TERMINAL_PASSWORDAutoPassword for web terminal login (auto-generated, visible in dashboard)
  • Minimum: 1 vCPU / 4 GB RAM
  • Recommended: 2 vCPU / 4 GB RAM

Claude Code's official system requirement is 4 GB+ RAM. AI processing happens on the Anthropic API side, so locally it only runs the Node.js CLI and shell tools, keeping CPU requirements low.

Changelog

2026-03-31 -- Initial Release

  • ttyd web terminal with password auth
  • Claude Code native installer (auto-installed on first boot)
  • Homebrew and npm global packages persisted in volume
  • Resource requirements and domain binding

2026-04-02 -- Channel Support & Landing Page Redesign

  • Landing page redesigned with checkbox-based command builder
  • Channel support: Telegram, Discord (via --channels flag)
  • Pre-installed channel plugins using CLAUDE_CODE_PLUGIN_SEED_DIR
  • Bun runtime pre-installed for channel plugin dependencies
  • Bot token input on landing page (prepended as env var in command)