Skills
.Work. You
Rest

headless-claude-code

Official

Run Claude Code headlessly in containers and CI.

Software Engineering#automation#authentication#tmux#containers#ci-cd#headless#claude-code
Authorvellum-ai
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Running Claude Code in headless environments (containers, CI runners, and orchestrated processes) without a graphical interface or browser-based login is brittle and hard to reproduce. This Skill provides reference patterns, configuration guidance, and practical scripts to enable reliable headless operation.

Core Features & Use Cases

  • Authentication Strategies: Prioritized methods (ambient cloud credentials, Anthropic tokens, API keys, and token helpers) to keep Claude Code running without interactive prompts.
  • Headless Orchestration: Guidance on tmux-based persistent sessions, non-interactive prompt delivery, and ready-made launcher patterns for automation.
  • Container & CI Readiness: Safe handling of root vs non-root, permission policies, and Git authentication in ephemeral environments.
  • Troubleshooting & Recovery: Pre-seeding onboarding state, readiness checks, and automated fallbacks to reduce downtime.

Quick Start

Launch a headless Claude Code session in a container with a pre-seeded onboarding file and a valid authentication method.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: headless-claude-code
Download link: https://github.com/vellum-ai/vellum-assistant/archive/main.zip#headless-claude-code

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.