はじめに
SuperClaudeを使おうとして最初に詰まったので、忘備録的に。インストール方法と、起動・終了方法だけを解説します。
注：Claude Code自体は無料でインストールできますが、実際に使うにはAnthropic APIの利用料もしくは有料プラン（Pro/Max等）への加入が必要です。
前提
- Claudeには課金済
- Apple Silicon Macを使用
- Homebrewによるパッケージ管理
- ホームディレクトリ（/Users/xxxxx）から開始
- uv環境は構築済（私のPython開発環境構築〜準備編その１・基礎編）
-
uv init testで作成した~/testディレクトリで作業
ポイント
ターミナル内でClaude Codeを起動してからでないと（Claudeのセッション内でないと）、SuperClaudeのコマンドは使えない。当たり前だが最初はわからず、ターミナルでSuperClaudeのコマンド（例えば/sc:analyzeなど）を入力していた。当然エラーが出る。
$ /sc:analyze
zsh: no such file or directory: /sc:analyze
Claude Codeのインストール
$ brew install --cask claude-code
ちなみに、brew install --cask claudeとしてしまうと、Claudeのデスクトップアプリがインストールされるので注意。
==> Downloading https://formulae.brew.sh/api/cask.jws.json
==> Caveats
Claude Code's auto-updater installs updates to `~/.local/bin/claude` and
not to Homebrew's location. It is recommended to disable the auto-updater
with either `DISABLE_AUTOUPDATER=1` or
`claude config set -g autoUpdates false` and use
`brew upgrade --cask claude-code`.
==> Downloading https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42
Already downloaded: /Users/xxxxx/Library/Caches/Homebrew/downloads/962ef84a2a4c5aa290482599ce180572287f6132f2ad1fdc3c6e3ff659a28615--claude
==> Installing Cask claude-code
==> Linking Binary 'claude' to '/opt/homebrew/bin/claude'
🍺 claude-code was successfully installed!
==> No outdated dependents to upgrade!
SuperClaudeのインストール
$ uv add SuperClaude
または
$ uvx pip install SuperClaude
Resolved 3 packages in 235ms
Installed 2 packages in 37ms
+ setuptools==80.9.0
+ superclaude==3.0.0.2
Claude Codeの起動
$ claude
何故か、claude-codeではない。認証部分は省略。
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ │
│ Do you trust the files in this folder? │
│ │
│ /Users/xxxxx/test │
│ │
│ Claude Code may read files in this folder. Reading untrusted files may lead Claude Code to behave in unexpected │
│ ways. │
│ │
│ With your permission Claude Code may execute files in this folder. Executing untrusted code is unsafe. │
│ │
│ https://docs.anthropic.com/s/claude-code-security │
│ │
│ ❯ 1. Yes, proceed │
│ 2. No, exit │
│ │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Enter to confirm · Esc to exit
Claude Code
> 1
╭───────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code! │
│ │
│ /help for help, /status for your current setup │
│ │
│ cwd: /Users/xxxxx/test │
╰───────────────────────────────────────────────────╯
Tips for getting started:
⏺ I'll help you get started! I can see this is a new Python project with a basic structure. Let me examine what you
have so far.
⏺ Read(main.py)
⎿ Read 7 lines (ctrl+r to expand)
⏺ Read(pyproject.toml)
⎿ Read 10 lines (ctrl+r to expand)
⏺ You have a Python project set up with:
- A basic main.py with a "Hello from test!" message
- A pyproject.toml configured for Python 3.13+ with the superclaude dependency
- Lock file (uv.lock) already generated
What would you like to work on? I can help you:
- Build out functionality in main.py
- Add more modules or features
- Set up testing, linting, or other development tools
- Explore the superclaude library capabilities
- Or anything else you have in mind
What's your goal for this project?
Claude Code
> /sc:
/sc:と入力すると、コマンドを提案してくれる。
/sc:test Execute tests, generate test reports, and maintain test coverage (user)
/sc:cleanup Clean up code, remove dead code, and optimize project structure (user)
/sc:design Design system architecture, APIs, and component interfaces (user)
/sc:task Execute complex tasks with intelligent workflow management and cross-session persistence (user)
/sc:git Git operations with intelligent commit messages and branch management (user)
/sc:build Build, compile, and package projects with error handling and optimization (user)
/sc:index Generate comprehensive project documentation and knowledge base (user)
/sc:load Load and analyze project context, configurations, and dependencies (user)
/sc:workflow Generate structured implementation workflows from PRDs and feature requirements with expert
guidance (user)
/sc:analyze Analyze code quality, security, performance, and architecture (user)
終了したいときは、exitと入力するか、Ctrl+Cで終了。
Claude Code
> exit