# Install claude-code with Homebrew Cask Terminal-based AI coding assistant. Version 2.1.211 via Homebrew Cask; verified 2026-07-24. Also installable with nix: nix profile install nixpkgs#claude-code. ## Install ```sh sudo av install cask:claude-code ``` ## Agent safety answer claude-code is an AI coding agent with local file and command access potential. - **Credential access:** May access project files, model credentials, and local tool configs exposed to the session. - **Remote mutation:** Can drive tools that mutate Git, cloud, package, or deployment state. - **Publish/artifact risk:** Can generate code and execute release or deployment commands. - **Recommended control:** Run under containment and gate sensitive host tool actions. - **Agent-use guidance:** Limit workspace scope; require approval before secret exposure, publishing, or remote writes. Additional install commands: ### macOS - Homebrew Cask (100%): ```sh brew install --cask claude-code ``` Evidence: local Homebrew cask metadata ## Package facts - **Package key:** cask:claude-code - **Package manager:** Homebrew Cask - **Package manager page:** - **Version:** 2.1.211 - **Source summary:** Terminal-based AI coding assistant - **Homepage:** - **Upstream docs:** - **Source archive:** - **Last updated:** 2026-07-24T19:07:33Z - **Generated:** 2026-07-25T07:20:51+00:00 ## Executables - claude (binary) - claude (alias) ## Install behavior - Post-install hook: not defined - Bottle: not available ## Freshness - Page generated: 2026-07-25 - Package-manager version: 2.1.211 - Package-manager updated: 2026-07-24 - Local data: ok - Upstream repository: https://claude.com/product/claude-code - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Claude Code is Anthropic's agentic coding tool for the terminal and related developer surfaces. Official docs describe it as a coding assistant that reads a codebase, edits files, runs commands, integrates with development tools, and works across terminal, IDE, desktop, browser, and automation surfaces. ### Project history Anthropic introduced Claude Code on February 24, 2025 alongside Claude 3.7 Sonnet, calling it a limited research preview for delegating substantial engineering tasks to Claude directly from a terminal. The npm registry records the `@anthropic-ai/claude-code` package as created the same day. The project later shifted away from npm as the preferred install path. The official GitHub README now says npm installation is deprecated and points users to native installers, Homebrew, WinGet, and setup documentation. Official docs describe Claude Code as available through terminal, VS Code, JetBrains, desktop, web, GitHub/GitLab CI, Slack, and other workflow surfaces. ### Adoption history Official distribution broadened from the original npm package to native install scripts for macOS, Linux, WSL, and Windows, Homebrew casks, WinGet, and Linux package managers including apt, dnf, and apk. Homebrew's `claude-code` cask tracks the stable channel, while docs mention `claude-code@latest` for the latest channel. The npm registry remains a useful historical source: it records 448 package versions and published version 2.1.196 by June 2026. Homebrew cask metadata records the cask binary artifact as `claude`, with cask zap paths covering Claude cache, config, local state, and `.claude` directories. ### How it is used The CLI is launched as `claude` from a project directory. Official docs highlight workflows such as building features, fixing bugs, writing tests, resolving merge conflicts, updating dependencies, creating commits and pull requests, connecting tools through MCP, customizing with CLAUDE.md, skills, and hooks, and piping command output into the CLI. Claude Code stores settings in user and project scopes: `~/.claude/settings.json`, `.claude/settings.json`, and `.claude/settings.local.json`; it stores other configuration in `~/.claude.json` and project MCP servers in `.mcp.json`. These files became a configuration surface for many companion tools in this batch. ### Why package nerds care Claude Code is package-nerd significant because it rapidly turned an AI coding assistant into a multi-channel developer toolchain package: npm for early installs, native auto-updating binaries, Homebrew casks, WinGet manifests, Linux packages, IDE extensions, and CI actions all point at the same underlying agent. It also created a secondary package ecosystem. Tools such as Claude Code Router, Claude Code Templates, claude-cmd, claude-hooks, and Claude Squad exist because Claude Code exposes configurable files, commands, hooks, MCP servers, worktrees, and terminal workflows that can be wrapped, routed, templated, or orchestrated. ### Timeline - 2025-02-24: Anthropic announces Claude Code as a limited research preview with Claude 3.7 Sonnet. - 2025-02-24: npm registry records creation of `@anthropic-ai/claude-code`. - 2026: Official README marks npm installation deprecated in favor of native install, Homebrew, and WinGet. - 2026-06: npm registry records published version 2.1.196 after 448 published versions. ### Related projects - Claude 3.7 Sonnet is the model announcement alongside Claude Code's public research preview. - Model Context Protocol is documented by Claude Code as the way to connect external tools and data sources. - Claude Code Router, Claude Code Templates, claude-cmd, claude-hooks, and Claude Squad are related companion packages in this batch. - Anthropic's VS Code, JetBrains, desktop, web, Slack, GitHub Actions, and GitLab CI/CD integrations are official adjacent surfaces. ### Sources - - - - - - - ## Security Notes No matching local secret-handling manifest was found for claude-code. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, ~/.claude.json, .mcp.json - Windows: %USERPROFILE%\.claude\settings.json, .claude\settings.json, .claude\settings.local.json, %USERPROFILE%\.claude.json, .mcp.json ## Credential files - Linux: ~/.claude/.credentials.json - Windows: %USERPROFILE%\.claude\.credentials.json ## Source Database Details - **Source Database:** Homebrew cask API - **Tap:** homebrew/cask - **Full Token:** claude-code - **Names:** Claude Code - **Artifacts:** Binary: 1, Target: 1, Zap: 1 - **Deprecated:** no - **Disabled:** no ## Other Package-Manager Records - Nix - claude-code: normalized package name match | nixpkgs package indexes: pkgs/by-name/cl/claude-code/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - claude-code: normalized package name match | MacPorts ports tree: llm/claude-code/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Chocolatey - claude-code: normalized package name match | Chocolatey community package catalog: claude-code from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','chocolatey-preinstaller-checks.extension' - Scoop - main/claude-code: normalized package name match | Scoop official bucket manifest trees: bucket/claude-code.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - Anthropic.ClaudeCode: normalized package name match | Windows Package Manager source index: Anthropic.ClaudeCode from https://cdn.winget.microsoft.com/cache/source.msix - winget - ronghuaxueleng.ClaudeCodeConfigManager.CLI: normalized package name match | Windows Package Manager source index: ronghuaxueleng.ClaudeCodeConfigManager.CLI from https://cdn.winget.microsoft.com/cache/source.msix - Scoop - extras/claude: installed executable or alias match | Scoop official bucket manifest trees: bucket/claude.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 - winget - Anthropic.Claude: installed executable or alias match | Windows Package Manager source index: Anthropic.Claude from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Homebrew Cask packages](https://www.automicvault.com/pkg/homebrew-cask-packages/) - Generated from Homebrew Cask package-manager metadata. - [Homebrew Cask binaries](https://www.automicvault.com/pkg/homebrew-cask-binaries/) - Cask artifact metadata includes a binary. ## Combined YAML source View the package source record on GitHub. [combined/claude-code.yml](https://github.com/automic-vault/db/blob/main/combined/claude-code.yml) ## Sources - Nucleus package database - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer