Claudeには3つのグレードがあり、用途に合わせて選びます:
Gonmuraでは、計画やレビューにはOpus、実装にはSonnetを使い分けています。
料金は使った量（トークン数）に応じた従量課金です。日本語1文字≒1〜2トークン。
| モデル | 速度 | 品質 | コスト |
|---|---|---|---|
| Opus | ゆっくり | ◎ 最高 | 高い |
| Sonnet | 速い | ○ 十分 | 中程度 |
| Haiku | 最速 | △ 軽量 | 安い |
CLAUDE.md は AIコーディングツール（Claude Code）にプロジェクトのルールを教える設定ファイル です。
新しいバイトが入ったらまずマニュアルを渡しますよね。AIも同じで、プロジェクトのルールをあらかじめ教えておく必要があります。CLAUDE.md がそのマニュアルの役割を担います。
CLAUDE.md = AIに渡す業務マニュアル。プロジェクトごとに用意することで、AIが的確にコードを書けるようになります。
・AIは毎回ゼロから質問が必要
・プロジェクトのルールを知らない
・一貫性のないコードが生成される
・AIがプロジェクトを初めから理解
・ルールに沿ったコードを自動生成
・チームの一員のように動く
| 項目 | 記載例 |
|---|---|
| プロジェクト概要 | 「学校向け出席管理アプリ。Firebase + Next.js」 |
| 技術スタック | 「TypeScript, Next.js 15, Firestore, Tailwind CSS」 |
| ディレクトリ構成 | 「src/app/ にページ、src/lib/ にユーティリティ」 |
| コーディング規約 | 「関数コンポーネントを使用、日本語コメント推奨」 |
| ビルド・テスト手順 | 「npm run build でビルド、npm test でテスト実行」 |
API（エーピーアイ）は、あるサービスの機能を外から使うための「注文カウンター」です。
レストランでウェイターに注文するように、アプリ同士が「これやって！」とお願いする仕組みです。
実はみんな毎日使っています:
全部自分で作る必要がある。天気データも、地図も、決済も全部ゼロから。
他社の得意な機能を「借りて」使える。自分は自分の得意なことに集中できる。
スキルとは、Claude Codeに特定の作業のやり方を覚えさせる仕組みです。たとえば「デプロイの手順」「Firebaseの注意事項」など、チームのノウハウをClaude Codeに教えておけます。
| スキル名 | 何をしてくれるか | どんな時に動くか |
|---|---|---|
| portless | 開発サーバーをわかりやすい名前のURLで起動してくれる | 「npm run dev」と言った時 |
| firebase-rules | Firebaseに間違ったプロジェクトをデプロイしないよう確認してくれる | 「firebase deploy」と言った時 |
| verification-before-completion | 「完了」と言う前にちゃんとビルドが通るか自動チェック | 「完了しました」「コミットします」と言った時 |
| frontend-design | AIっぽくないオシャレなWebページを作ってくれる | 「ページを作って」と言った時 |
| /deploy | Cloudflareへのデプロイを手順通りに実行してくれる | /deploy と入力した時 |
上の3つは自動で動きます。何も意識しなくても、チーム全員のClaude Codeが同じルールで動作します。
Skillsには「このAPIをこの手順で呼び出して」という手順書を書けます。直接APIを叩く手順をSkillに書いておけば、トークンを節約しながら外部サービスを使えます。シンプルなAPI連携なら、この方法が一番効率的です。
MCP（Model Context Protocol）は、Claude Codeを外部ツールとつなげる仕組みです。素のClaude Codeはテキストのやり取りしかできませんが、MCPを接続するとブラウザ操作・メール送信・Figmaの読み取りなど、様々なことができるようになります。
たとえばこんなことが可能に:
他にも Firebase操作・ブラウザ自動操作・モバイルアプリテストなど、計16のMCPサーバーが利用可能です。
複雑なAPIをまとめてくれる
例：Google Sheets MCP、Firebase MCP
何十回もAPIを叩く手間を「1回の指示」にまとめてくれる翻訳者のような存在。自分でAPIを調べて叩く必要がなくなる。
外部ツールを直接操作する
例：ブラウザ操作MCP（Chrome DevTools）、モバイル操作MCP
APIがなくてもツールを直接動かせるリモコンのような存在。ブラウザをまるで手で操作するように自動化できる。
タイプ1はAPIを使って外部サービスと会話する。タイプ2はツール専用の通信方法（プロトコル）でブラウザやアプリに直接指示を送る。どちらもClaude Codeが自動でやってくれるので、仕組みは気にしなくてOK。
現在16のMCPサーバーが設定されています。主なものを紹介します:
| サーバー名 | できること | 補足 |
|---|---|---|
| brave-search | Web検索 | APIキーが必要 |
| firebase | Firebaseプロジェクトの管理・デプロイ | すぐ使える |
| chrome-devtools | Chromeブラウザの操作・スクリーンショット | すぐ使える |
| XcodeBuildMCP | iOSアプリのビルド・テスト | すぐ使える |
| gws | Googleカレンダー・Gmail・Drive操作 | 初回認証が必要 |
| figma | Figmaデザインの読み取り | すぐ使える |
| cloudflare | Webサイトのデプロイ・DNS管理 | APIキーが必要 |
「すぐ使える」サーバーは設定済みですぐ利用可能。APIキーが必要なものは初回のみキーの設定が必要です。
3つは「どれを選ぶか」ではなく、それぞれ独立しつつ組み合わせて使う仕組みです。
| 組み合わせパターン | 例 | トークン |
|---|---|---|
| Skills + MCP | 「Braveで検索してまとめて」 | 多い |
| Skills + API直接 | 「curlでBrave APIを叩いて」 | 少ない |
| MCPだけ | Claudeが判断してMCPを使う | 多い |
| MCP（API不使用） | ブラウザ操作、ファイル操作 | 中程度 |
「Braveでネット検索する」を例に比較します。
| MCP（家電） | Skills+API（直火） | |
|---|---|---|
| Claudeの手間 | ボタン1つ | コマンドを自分で組み立て |
| トークン（利用料） | 多い（使わなくても常駐） | 少ない（必要な時だけ） |
| セットアップ | 簡単（設定1回） | API仕様を調べて書く |
| サービス | おすすめ | 理由 |
|---|---|---|
| Brave検索 | Skills+API直接でOK | URL1つ+キー1つでシンプル |
| GitHub | MCPの方が楽 | 43個のエンドポイント、OAuth認証 |
| Google Sheets | MCPほぼ必須 | OAuth認証+トークンの自動更新が必要 |
あなたが部長で、部下に仕事を任せるとき、全部1人にやらせますか？エージェントはClaude Codeに"専門部署"を作る仕組みです。企画部、品質管理部、調査チーム…それぞれが得意な仕事をこなします。
特定の作業のやり方を書いたメモ。Claude Codeが参照して使う。1人のClaudeが全部こなす。
専門分野を持った「別のClaude」を呼び出す。複数のエージェントがチームとして動く。
| エージェント | 役割 | たとえ |
|---|---|---|
| planner（計画係） | 実装前に計画を立てる | プロジェクトマネージャー |
| coder（実装係） | 実際にコードを書く | プログラマー |
| reviewer（確認係） | コードをチェックして問題を指摘 | 上司のチェック |
| tester（テスト係） | テストを書いて動作確認 | 品質管理担当 |
| searcher（調査係） | 必要な情報を調べてくる | リサーチャー |
| fixer（修正係） | 指摘された問題を修正する | トラブルシューター |
Chapter 1〜7で学んだ内容を実際にセットアップするとどうなるか見てみましょう。
| 作業 | 手動でやること | 所要時間（目安） |
|---|---|---|
| CLAUDE.md設定 | プロジェクトごとにルールファイルを作成 | 10分〜 |
| スキル設定 | 60以上のSKILL.mdを正しいディレクトリに配置 | 30分〜 |
| エージェント設定 | 5つのエージェント定義を作成・配置 | 15分〜 |
| MCP設定 | 16のMCPサーバーを1つずつコマンドで追加 | 30分〜 |
| APIキー設定 | 各サービスのAPIキーを取得し環境変数に設定 | 20分〜 |
| フック設定 | 10個のシェルスクリプトを配置・権限設定 | 15分〜 |
手動設定だと①人によって設定がバラバラになる ②スキルが改善されても自分で更新が必要 ③新メンバーが入るたびにゼロからセットアップ ④「あの人の環境だと動くけど自分のでは動かない」問題
kouki-claude-config は、Claude Codeの全設定をGitリポジトリで一元管理する仕組みです。Unixの「dotfiles」文化と同じ考え方で、設定をコードとして管理します。
リポジトリの中身:
git clone https://github.com/Gonmura-inc/in-kouki-claude-config.git ~/workspace/kouki-claude-config
cd ~/workspace/kouki-claude-config
./install.sh
install.sh が自動でやってくれること:
ファイルのショートカットのようなもの。リポジトリ内のファイルが ~/.claude/ から参照されます。リポジトリを更新すれば設定も自動で最新に。
.envファイルのAPIキーを使って、テンプレートのプレースホルダーを自動置換。キーが未設定のサーバーは自動スキップ。
| 問題 | 状況 |
|---|---|
| 設定のバラつき | 人によって使えるスキル・MCPが違う |
| 改善が届かない | スキルを改善しても各自が手動更新 |
| オンボーディング | 新人のセットアップに半日かかる |
| 解決策 | 効果 |
|---|---|
| Git管理で統一 | 全員が同じ設定を共有 |
| git pull で更新 | 改善が即座に全員に届く |
| 3行で完了 | 新人も5分で環境構築 |
① 誰かがスキルやエージェントを改善 → ② GitHubにpush → ③ メンバーがgit pull → ④ 全員の環境が自動更新。この仕組みにより、チーム全体のAI活用レベルが継続的に向上します。
kouki-claude-configをインストールしたら、あとはプロジェクトごとにCLAUDE.mdを置くことと、必要なスキルを追加することの2つだけ。しかもそれすらAIに「CLAUDE.md作って」「スキル作って」と頼めばOKです。
PC画面で閲覧してください
このスライドはPC画面（横向き）での閲覧を推奨しています。