asdf-claude-code

asdf plugin for Claude Code from Anthropic.

This plugin installs Anthropic's native claude binary from the official Claude Code release service. It supports macOS and Linux on x64 and ARM64, including musl-based Linux distributions where Anthropic publishes musl builds.

Install

asdf plugin add claude-code https://github.com/thlib/asdf-claude-code.git
asdf install claude-code latest
asdf set -u claude-code latest

Versions

Anthropic exposes release-channel endpoints for latest and stable, and versioned manifests for concrete versions.

asdf latest claude-code
asdf list all claude-code
asdf install claude-code stable
asdf install claude-code 2.1.190

asdf list all claude-code shows the current concrete versions for the stable and latest channels. If you know a specific Claude Code version, you can install it directly even if it is not shown by list-all.

Verify

claude --version
claude doctor

Claude Code requires a paid Claude Code-capable account or supported third-party API provider. Run claude after installation to authenticate.

Requirements

• asdf
• curl or wget
• sha256sum or shasum
• jq is optional; the plugin has a shell fallback for manifest parsing.

How It Works

The plugin mirrors Anthropic's native installer behavior for platform detection and checksum verification, then installs the verified binary into asdf's version directory as bin/claude.

It intentionally does not run claude install, because that installer manages a user-level launcher outside asdf. Claude Code runtime configuration and authentication remain in the normal Claude Code locations such as ~/.claude.