▶️
Homebrew で始める Claude Code:インストールから初期設定まで
ステップ1:有料プランに登録
Claude Codeを使用するには、有料プランへの登録が必要となります。
ステップ2:プライバシー設定
必要に応じてプライバシー設定を行います。
手順:
- https://claude.ai にログイン
- 設定 → プライバシー
ステップ3:Claude Codeをインストール
brew install --cask claude-code
確認:
claude --version
アップデート:
brew upgrade claude-code
ステップ4:認証
claude
初回起動でブラウザが開くので、ログインして認証します。
ステップ5:SuperClaudeをインストール(任意)
SuperClaudeを入れると、より高度な機能が使えます。
5-1. pipxをインストール
brew install pipx
pipx ensurepath
ターミナルを再起動してPATHを反映します。
5-2. SuperClaude Frameworkをインストール
pipx install SuperClaude
SuperClaude install --quick
ステップ6:プロジェクトで使う
プロジェクトのディレクトリに移動して起動:
cd /path/to/your/project
claude
これで Claude とのコミュニケーションが開始されます。
設定ファイル
Claude Code に許可すること、許可しないことなどを設定します。
設定ファイルの階層構造:
-
~/.claude/settings.json- 全プロジェクト共通の設定 -
.claude/settings.json- プロジェクト固有の設定 -
.claude/settings.local.json- 個人用設定
項目例:
{
"permissions": {
"allowedTools": ["Read", "Write", "Bash(npm *)"],
"deny": [
"Bash(sudo:*)",
"Bash(rm -rf:*)",
"Bash(git push:*)",
"Read(id_rsa)",
"Write(/etc/**)"
]
}
}
allowedToolsの説明:
-
"Read"- Claudeがファイルを読み取れる -
"Write"- Claudeがファイルを作成・編集できる -
"Bash(...)"- 特定のコマンドを実行できる(例:"Bash(npm *)") - 記載のないツールは自動的に禁止される
CLAUDE.mdファイルも作成推奨:
なぜCLAUDE.mdを作るべき?
- Claudeが毎回プロジェクトを理解する手間を省ける
- トークン消費を削減(毎回説明する必要がない)
- チーム全体で共通のコンテキストを共有できる
- Gitにコミットして、誰でも同じ設定で使える
.claude/CLAUDE.md
CLAUDE.md例
# プロジェクトコンテキスト
## コーディング規約
- TypeScriptを使用
- Jestでテストを書く
- 関数型コンポーネントとHooksを使用
## アーキテクチャ
- フロントエンド:Next.js + TypeScript
- バックエンド:Node.js + Express
- データベース:PostgreSQL + Prisma
## ファイル構成
- コンポーネント:`src/components/`
- ユーティリティ:`src/utils/`
- テスト:`.test.ts`拡張子
参考リンク
- 公式ドキュメント:https://docs.claude.com/en/docs/claude-code
- SuperClaude Framework:https://github.com/SuperClaude-Org/SuperClaude_Framework
Discussion