Claude Batch Toolkit

claude-batch-toolkit

Send non-urgent work to the Anthropic Batch API (or Vertex AI) at 50% cost — directly from Claude Code.

Code reviews, documentation, architecture analysis, refactoring plans, security audits — anything that can wait ~1 hour gets half-price processing with Claude Opus. Works with the Anthropic API directly or through Google Cloud's Vertex AI.

Install

The installer shows a manifest of every change it will make and asks for confirmation before proceeding.

Install Options

Uninstall

This shows what will be removed, asks for confirmation, and preserves your results in ~/.claude/batches/results/. Use --purge-data to also remove results.

Manual Installation (no script)

If you prefer not to run the install script — or need to install in a restricted environment — follow these steps to set up each component by hand.

Prerequisites

You also need an Anthropic API key (sk-ant-...). Get one from console.anthropic.com.

Verify prerequisites:

Step 1: Create directory structure

Step 2: Install the MCP server

Step 3: Install the skill file

Step 4 *(optional)*: Install the statusline script
Skip this step if you don't want batch job counts in your Claude Code status bar. Everything else works without it.

Step 5: Set up your API key

The toolkit reads ANTHROPIC_API_KEY from ~/.claude/env. This file must be mode 600.

If ~/.claude/env does not exist yet:

If ~/.claude/env already exists, open it in your editor and add (or replace) the ANTHROPIC_API_KEY line, then ensure chmod 600 ~/.claude/env.

Step 6: Register the MCP server in ~/.claude.json

Claude Code discovers MCP servers through ~/.claude.json. You need to add a claude-batch entry under the mcpServers key.

If ~/.claude.json does not exist yet:

If ~/.claude.json already exists — merge (don't…