Homebrew Claude Code

Homebrew Tap for Claude Code

Community-maintained Homebrew tap that tracks Anthropic's latest Claude Code channel.

Why This Exists

Anthropic's official Homebrew casks distinguish between stable and latest channels. This tap exists for one job: keep a single `claude-code` cask pinned to the live `latest` channel and refresh it automatically every 5 minutes.

This intentionally differs from the official naming:

• brew install --cask claude-code from Homebrew installs the official stable cask
• brew install --cask claude-code@latest from Homebrew installs Anthropic's official latest-channel cask
• brew install --cask hksw-io/claude-code/claude-code installs this tap's latest-channel mirror

Install

brew install --cask hksw-io/claude-code/claude-code

Upgrade:

brew upgrade --cask hksw-io/claude-code/claude-code

If you want plain `brew upgrade` to include casks that update outside Homebrew/core, set:

export HOMEBREW_UPGRADE_GREEDY=1

Version Policy

This tap polls Anthropic's `latest` marker every 5 minutes and mirrors whatever version it points to.

The active cask follows a "highest seen wins" policy:

• a newly observed higher version replaces Casks/claude-code.rb
• a newly observed lower version is still tagged and released in this repo, but does not downgrade the active cask
• once a higher version has been published here, the tap will not move backward automatically

Example:

• if latest moves from 2.1.110 to 2.1.111, the cask updates to 2.1.111
• if latest later rolls back to 2.1.110, the repo records that observation but keeps the active cask at 2.1.111

If you want Anthropic's exact channel behavior, including automatic rollbacks, use the official Homebrew latest-channel cask instead.

How It Works

This tap polls:

• https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/latest
• `https://storage.googleapis.com/claude-code-dist-86c565f