Skip to content

Claude Code

Claude Code

Category: Development Type: Workload Template Tags: cluster-level

Overview

Claude Code is Anthropic's AI coding agent, delivered as a browser-accessible web terminal (powered by wetty). Each Claude Code workload is an isolated session with persistent storage for project files and configuration — no local install required.

How It Works

Workload Template — Installs the Claude Code workload schema into Genesis. Once installed, the Claude Code type appears in Genesis on the Workloads page, where it can be authored into a workload template. Users can then launch and provision their own coding agent session on demand within a project through Hubble.

Prerequisites

  • A Kubernetes storage class available in the cluster
  • API credentials for Claude (ANTHROPIC_API_KEY or equivalent) — set via the workload's environment variables at launch

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Claude Code"
  3. Click Install
  4. Click Confirm to deploy (no install-time fields required)

Once installed, the Claude Code schema is available in Genesis. From the Workloads page, author the template — users can then launch and provision sessions on demand through Hubble.

Configuration

Install-Time Fields

No install-time configuration is required for this plugin.

Workload Launch Fields

These fields are configured when authoring the workload template in Genesis and used each time a user provisions a Claude Code session through Hubble:

Field Details
nginx_registry string · Required · Default: docker.io
Registry to pull the nginx sidecar image from
nginx_repo string · Required · Default: nginx
Repository to pull the nginx sidecar image from
nginx_tag string · Required · Default: alpine
Tag to pull the nginx sidecar image from
timezone string · Required · Default: America/New_York
Timezone for the Claude Code instance
storage_class k8sStorageClass · Optional
Storage class for the persistent /data disk
storage_size string · Required · Default: 10Gi
Storage size for the persistent /data disk
publicAccess boolean · Required · Default: false
Allow public access (disable Hubble authentication)

Custom Environment Variables

Genesis lets you add arbitrary environment variables to the workload at launch time. These are commonly useful for the claude CLI (@anthropic-ai/claude-code):

Variable Description
ANTHROPIC_API_KEY Anthropic Console API key used by the claude CLI to authenticate.
ANTHROPIC_MODEL Overrides the default Claude model used by the CLI.
ANTHROPIC_BASE_URL Overrides the API base URL, e.g. to point at a proxy or compatible endpoint.

Notes

  • Claude API credentials are not set via the install-time fields above — configure them as custom environment variables at workload launch (see table above), e.g. ANTHROPIC_API_KEY
  • The nginx sidecar provides browser-accessible proxying for the wetty terminal interface
  • Project files and Claude Code configuration are persisted to the /data volume across workload restarts
  • Setting publicAccess to true removes authentication from the workstation endpoint — use only in trusted network environments
plugins/claude-code/terra.yaml
1
2
3
4
5
6
7
8
9
resource_id: "claude-code"
name: "Claude Code - Web Terminal"
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/claude-code/assets/logo.png
description: "Claude Code AI coding agent web terminal powered by wetty"
category: "development"
tags:
  - cluster-level
editable: false
fields: []