logo

quickActions

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
Deployed4 times
PublisherzeaburZeabur
Created2026-03-30
Services
service icon
Minimum1 Core4 GB
Recommended2 Cores4 GB
Tags
AIDeveloper Tools

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 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. Copy the command you need (e.g. claude --dangerously-skip-permissions for full permissions) and click Enter Terminal.
  5. Authenticate Claude Code — paste the command, then follow the login prompts to sign in with your Claude Pro/Max/Team/Enterprise subscription.

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