Installation Guide

Complete installation guide for Claude Code, dependencies, and this configuration.

Use the plugin marketplace to install agents/commands/hooks/MCP. You'll still need to complete prerequisites and create the AGENTS.md symlink.

Prerequisites

Claude Code

Install Claude Code using the native installer (no Node.js required):

macOS/Linux/WSL:

# Install via native installer
curl -fsSL https://claude.ai/install.sh | bash

# Or via Homebrew
brew install --cask claude-code

# Verify installation
claude --version

Windows PowerShell:

# Install via native installer
irm https://claude.ai/install.ps1 | iex

# Verify installation
claude --version

Migrate from legacy npm installation:

claude install

Optionally install IDE extension:

Claude Code VSCode extension for IDE integration

OpenAI Codex

Install OpenAI Codex:

npm install -g @openai/codex

Optionally install IDE extension:

Codex VSCode extension for IDE integration

Required Tools

jq (JSON processor - required for hooks)

macOS:

brew install jq

Ubuntu/Debian:

sudo apt-get install jq

Other Linux distributions:

# Check your package manager, e.g.:
# sudo yum install jq (RHEL/CentOS)
# sudo pacman -S jq (Arch)

GitHub CLI (required for pr-manager agent)

macOS:

brew install gh

Ubuntu/Debian:

sudo apt-get install gh

Other Linux distributions:

# Check your package manager, e.g.:
# sudo yum install gh (RHEL/CentOS)
# sudo pacman -S github-cli (Arch)

Code Quality Tools

# Python formatting (required for Python hook)
pip install ruff

# Prettier for JS/TS/CSS/JSON/YAML/HTML/Markdown/Shell formatting (required for prettier hooks)
# Note: npm is required for prettier even though Claude Code no longer needs it
npm install -g prettier@3.6.2 prettier-plugin-sh

Post-Installation Setup

Create Shared Agent Guidance

Create a symlink for cross-tool compatibility (AGENTS.md):

ln -s CLAUDE.md AGENTS.md

This lets tools like OpenAI Codex, Gemini CLI, Cursor, Github Copilot and Qwen Code reuse the same instructions.

2.5 KiB Raw Blame History