Claude Code Setup

My universal setup for Claude Code with hooks, MCPs, etc...

📑 Contents

• Claude Code Setup
  • 📑 Contents
  • 🚀 Features
  • 📋 Prerequisites
  • ⚡ Quick Start
  • 🔌 LSP Plugins (Optional)
  • 🌍 Global Installation (Optional+Recommended)
  • 💻 Shell Aliases (Optional)
  • 💡 Tips
  • 🌐 Agent Browser

🚀 Features

• Security Guard — blocks dangerous commands (rm -rf /, .env writes, privileged docker, etc.)
• TTS Notifications — cached voice alerts when Claude finishes or needs input
• Desktop Notifications — native OS notifications (Linux, macOS, Windows)
• Status Line — shows project, branch, model, and context usage
• Slash Commands — /research, /ultrathink, /commit, /push-and-pr, /prime, /publish, /release
• MCP Servers — context7
• LSP Plugins — TypeScript, Python (Pyright), Go (gopls) for better code understanding
• Cross-platform — Linux, macOS, Windows

---

📋 Prerequisites

• Node.js 18+
• uv (Python package manager)
• ffmpeg or mpv (audio player for TTS)
• Claude Code CLI: npm install -g @anthropic-ai/claude-code

---

⚡ Quick Start

Paste this into Claude Code and it will set everything up:

Clone https://github.com/DefaultPerson/claude-code-setup and install it globally into ~/.claude/ (hooks, commands, settings, mcp). Read the repo's README.md for full context. Replace all placeholder paths with real ones. Ask me interactively for any API keys and preferences (language, notifications). After setup, read the README again and offer to apply optional extras (LSP plugins, shell aliases, agent-browser). Verify everything works at the end.

Manual Setup

git clone https://github.com/DefaultPerson/claude-code-setup.git
cd claude-code-setup

cp .mcp.json.sample .mcp.json              # Windows: .mcp.json.windows
cp .claude/settings.example.json .claude/settings.json

Edit files — replace paths and API keys (see .mcp.json.sample).

Replace /home/user/project in settings.json with your path:

sed -i 's|/home/user/project|'"$(pwd)"'|g' .claude/settings.json   # Linux
sed -i '' 's|/home/user/project|'"$(pwd)"'|g' .claude/settings.json # macOS

Start Claude:

claude

---

🔌 LSP Plugins (Optional)

Enable LSP for better code analysis (types, definitions, errors):

claude /install-plugin typescript-lsp@claude-plugins-official
claude /install-plugin pyright-lsp@claude-plugins-official
claude /install-plugin gopls-lsp@claude-plugins-official

Requires language servers installed: npm i -g typescript, pip install pyright, go install golang.org/x/tools/gopls@latest.

---

🌍 Global Installation (Optional+Recommended)

Apply hooks to all projects:

cp -r .claude/hooks ~/.claude/hooks
cp .claude/settings.example.json ~/.claude/settings.json
sed -i 's|/home/user/project/.claude|'"$HOME"'/.claude|g' ~/.claude/settings.json

---

💻 Shell Aliases (Optional)

Add to .bashrc / .zshrc / PowerShell profile:

alias cc="claude"
alias ccr="claude --resume"
alias ccd='claude --dangerously-skip-permissions'
alias ccdr='claude --dangerously-skip-permissions --resume'

# Tmux grid: tg (4 panes), tg -n 3 (3 panes)
tg() {
    local n=4
    while getopts "n:" opt; do
        case $opt in n) n=$OPTARG ;; esac
    done
    tmux new-session -d -s "grid-$$"
    for ((i=1; i<n; i++)); do
        tmux split-window -t "grid-$$"
        tmux select-layout -t "grid-$$" tiled
    done
    tmux attach -t "grid-$$"
}

# 2 panes side-by-side
tg2() {
    tmux new-session -d -s "split-$$"
    tmux split-window -h -t "split-$$"
    tmux attach -t "split-$$"
}

# Add pane to current grid
ta() {
    tmux split-window
    tmux select-layout tiled
}

alias tg3='tg -n 3'

---

💡 Tips

Tip

Terminal as Editor Tab (VS Code): Cmd/Ctrl+Shift+P → "Terminal: Create New Terminal in Editor Area" — opens terminal as a tab next to your code, not in the bottom panel.

Tip

If something doesn't work — just ask Claude Code to fix it. Describe the problem and Claude will diagnose and resolve it.

---

🌐 Agent Browser

Better alternative to Playwright MCP: agent-browser | skill

---

🤙 My tg channel >> link