Claude Code

Use Anthropic's Claude Code CLI with Verun — prerequisites, selecting the agent, and Verun-specific configuration.

Claude Code is Anthropic's CLI-based coding agent. It is the default agent in Verun and the most commonly used provider.

Overview

Claude Code runs as a terminal process that Verun manages inside each task's worktree. It reads your codebase, writes code, and runs terminal commands — all within the isolated worktree.

Prerequisites

Claude Code CLI installed and authenticated
An active Anthropic API key or Claude subscription
Node.js 18+ (required by the Claude Code CLI)

Verify the CLI is available:

claude --version

Selecting Claude Code in Verun

Open a task and click the + button in the session list.
Select Claude Code from the agent menu.
Optionally pick a model (Opus 4.7, Opus 4.6, Sonnet 4.6, Haiku 4.5) from the submenu.
The session opens and Claude Code begins in the task's worktree.

Alternatively, set Claude Code as the default in .verun.json:

{
  "defaultAgentType": "claude"
}

Configuration

Claude Code uses its own configuration files (CLAUDE.md, .claude/) for project-specific instructions. Place these in your project root — they are available inside each worktree automatically.

Verun-specific settings via .verun.json:

{
  "defaultAgentType": "claude",
  "hooks": {
    "setup": "npm install"
  },
  "startCommand": "PORT=$VERUN_PORT_0 npm run dev",
  "autoStart": true
}

Known Limitations

Claude Code requires an active internet connection to communicate with Anthropic's API.
Large repositories may take longer to index on first session start.
The CLI must be installed and authenticated before starting a Verun session — Verun does not manage CLI authentication.