claude-install

Documentation

Complete reference for the claude-install cross-platform installer

Overview

claude-install.sh is a single Bash script (~1400 lines) that handles both fresh installation and clean reinstallation of Claude Code on Linux and macOS (ARM and Intel). It is interactive and uses set -e for fail-fast behavior.

$ chmod +x claude-install.sh && ./claude-install.sh

Script Architecture

The script is organized as 14 sequential steps:

0

Platform Detection

OS, architecture, Rosetta, fresh/reinstall mode

1

Terminal Architecture Check

macOS iTerm2 binary architecture

2

Node.js Setup

nvm, Node v22, Homebrew/system Node handling

3

Bun Verification

Architecture check and reinstall if needed

4

Backup Config

Reinstall only: credentials, settings, memory

5

Remove Existing

Reinstall only: clean removal of old install

6

Choose Install Method

Native installer (curl) or npm global

7

Install Claude Code

Execute chosen installation method

8

Install Plugins

20 plugins from 5 marketplaces

9

MCP Server Selection

Interactive menu for ~20 MCP servers

10

Install MCP Servers

Configure selected servers as JSON

11

Write Settings

settings.json with plugins, permissions, MCP

12

Write .claude.json

Install method and auto-updates config

13

Shell Profile Setup

nvm sourcing and PATH in shell config

14

Final Verification

Check all binaries, configs, print summary

Plugins (27)

PluginCategoryMarketplace
SuperpowersDevelopmentSuperpowers Marketplace
Superpowers LabExperimentalSuperpowers Marketplace
Superpowers ChromeWeb DevelopmentSuperpowers Marketplace
Developing for Claude CodePlugin DevelopmentSuperpowers Marketplace
Double Shot LattePerformanceSuperpowers Marketplace
Elements of StyleWritingSuperpowers Marketplace
Episodic MemoryMemorySuperpowers Marketplace
Feature DevDevelopmentClaude Code Plugins
Frontend DesignDesignClaude Code Plugins
Plugin DevPlugin DevelopmentClaude Code Plugins
PR Review ToolkitCode QualityClaude Code Plugins
Ralph WiggumAutomationClaude Code Plugins
Security GuidanceSecurityClaude Code Plugins
Fullstack Dev SkillsDevelopmentFullstack Dev Skills
Context Engineering FundamentalsAI EngineeringContext Engineering Marketplace
Agent ArchitectureAI EngineeringContext Engineering Marketplace
Agent EvaluationAI EngineeringContext Engineering Marketplace
Agent DevelopmentAI EngineeringContext Engineering Marketplace
Cognitive ArchitectureAI EngineeringContext Engineering Marketplace
Claude MemMemorythedotmack
Claude HUDUIClaude HUD
Rust Analyzer LSPLanguage ServerClaude Plugins Official
Last30DaysResearchLast30Days Skill
Oh My Claude CodeOrchestrationOh My Claude Code
Marketing SkillsMarketingMarketing Skills
GitNexusCode IntelligenceGitNexus Marketplace
ImpeccableDesignImpeccable

Marketplaces (12)

Claude Code Plugins

6 plugins

Official Anthropic plugins for feature development, frontend design, PR review, plugin creation, and security guidance.

github.com/anthropics/claude-code

Claude HUD

1 plugin

Customizable heads-up display statusline for Claude Code with layout presets and configurable display elements.

github.com/jarrodwatts/claude-hud

Claude Plugins Official

1 plugin

Anthropic's official plugin marketplace featuring language server integrations and core developer tooling for Claude Code.

github.com/anthropics/claude-plugins-official

Context Engineering Marketplace

5 plugins

Advanced agent architecture, evaluation, and cognitive patterns for building and optimizing AI agent systems.

github.com/muratcankoylan/Agent-Skills-for-Context-Engineering

Fullstack Dev Skills

1 plugin

90+ specialized developer skills covering every major framework, language, and DevOps tool for full-stack development.

github.com/jeffallan/claude-skills

GitNexus Marketplace

1 plugin

Code intelligence powered by a knowledge graph — execution flow tracing, blast radius analysis, and semantic code search.

github.com/abhigyanpatwari/GitNexus

Impeccable

1 plugin

Design fluency for AI harnesses — 1 skill, 20 commands, and curated anti-patterns for impeccable frontend design.

github.com/pbakaus/impeccable

Last30Days Skill

1 plugin

Deep research engine that scans the last 30 days across Reddit, X/Twitter, YouTube, TikTok, Hacker News, and 10+ sources.

github.com/mvanhorn/last30days-skill

Marketing Skills

1 plugin

35 marketing skills for technical marketers and founders — CRO, copywriting, SEO, paid ads, growth, and revenue ops.

github.com/coreyhaines31/marketingskills

Oh My Claude Code

1 plugin

Multi-agent orchestration layer with 30+ specialized agents, parallel pipelines, model routing, and team workflows.

github.com/Yeachan-Heo/oh-my-claudecode

Superpowers Marketplace

7 plugins

Premium Claude Code plugins for power users — session memory, Chrome DevTools, writing style, and deep development workflows.

github.com/obra/superpowers-marketplace

thedotmack

1 plugin

Cross-session persistent memory with smart search, timeline views, and token-optimized code exploration.

github.com/thedotmack/claude-mem

MCP Servers (19)

AI & Reasoning

Context7Recommended

Up-to-date library documentation in context. Get accurate, current docs for any popular library.

@upstash/context7-mcp
Sequential ThinkingRecommended

Dynamic problem-solving through sequential thought chains. Break down complex problems step by step.

@modelcontextprotocol/server-sequential-thinking

Cloud & Infrastructure

AWS KB Retrieval

Query AWS Knowledge Bases for enterprise RAG workflows and AWS documentation.

@modelcontextprotocol/server-aws-kb-retrieval

Communication

NotionAPI Key

Read and update Notion pages and databases. Sync your knowledge base with development.

@modelcontextprotocol/server-notion
SlackAPI Key

Read and send Slack messages. Integrate team communication into your development workflow.

@modelcontextprotocol/server-slack

Developer Tools

Docker

Manage Docker containers and images — build, run, inspect, and manage containerized applications.

@modelcontextprotocol/server-docker
GitHubRecommendedAPI Key

GitHub integration — manage repos, issues, PRs, and code reviews directly from Claude Code.

@modelcontextprotocol/server-github
GitLabAPI Key

GitLab integration — issues, merge requests, and repo management for GitLab-hosted projects.

@modelcontextprotocol/server-gitlab
GitNexus

Code intelligence knowledge graph — dependency analysis, impact tracking, and code understanding.

gitnexus
LinearAPI Key

Linear issue tracking integration for managing projects, issues, and sprints.

mcp-linear
RufloRecommended

Multi-agent AI orchestration platform with swarm intelligence, 170+ tools for complex workflows.

ruflo
SentryAPI Key

Error tracking and monitoring — investigate production errors and performance issues.

@modelcontextprotocol/server-sentry

File & Data

FilesystemRecommended

Read, write, and search files with fine-grained permissions. Essential for any file-based workflow.

@modelcontextprotocol/server-filesystem
MemoryRecommended

Persistent knowledge graph for long-term memory across sessions. Store and retrieve structured facts.

@modelcontextprotocol/server-memory
PostgreSQL

Connect to and query PostgreSQL databases. Run queries, inspect schemas, and manage data.

@modelcontextprotocol/server-postgres
SQLite

Query and manage SQLite databases directly. Great for local data storage and analysis.

mcp-server-sqlite

Web & Search

Brave SearchRecommendedAPI Key

Web search powered by Brave Search API. Find current information and web content.

@modelcontextprotocol/server-brave-search
FetchRecommended

Fetch and parse web pages, APIs, and URLs. Convert HTML to markdown for analysis.

@modelcontextprotocol/server-fetch
Puppeteer

Browser automation with headless Chrome — screenshots, scraping, form filling, and more.

@modelcontextprotocol/server-puppeteer

Platform Support

PlatformArchitectureNotes
macOSARM64 (Apple Silicon)Full support including Rosetta detection
macOSx86_64 (Intel)Full support
Linuxx86_64Full support
Linuxaarch64/arm64Full support