# Install claude-code with Homebrew Cask Terminal-based AI coding assistant. Version 2.1.212 via Homebrew Cask; verified 2026-07-25. ## 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: provider-native install command ## Package facts - **Package key:** cask:claude-code - **Package manager:** Homebrew Cask - **Version:** 2.1.212 - **Source summary:** Terminal-based AI coding assistant - **Homepage:** - **Last updated:** 2026-07-25T04:41:07Z - **Generated:** 2026-08-03T00:40:33+00:00 ## Executables - claude (binary) - claude (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 2.1.212 ## 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 ## 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 - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - curated agent safety answer