SakanaAI Fugu 利用ガイド：Codex でマルチエージェントモデルを有効にする方法

Wed, 24 Jun 2026 07:41:25 +0800

SakanaAI/fugu が一般の開発者にとって面白いのは、単に「マルチエージェントモデル」だからではありません。Codex で使うための入口がすでに用意されているからです。

次のような検索意図があるなら：

Fugu のインストール方法
SakanaAI Fugu の使い方
Codex に Fugu を接続する方法
codex-fugu とは

この記事はインストールと初回利用のガイドとして読めます。

公式リンク：

GitHub リポジトリ：SakanaAI/fugu
製品ページ：Sakana Fugu

Fugu を最初に何へ使うべきか

インストールする前に、まず確認しておきたい点があります。Fugu はすべてのタスクに最適とは限りません。

Fugu は、複雑で複数ステップがあり、モデル同士の協調や検証が役立つ開発タスクに向いています。たとえば：

コードベースを読んで構造をまとめる；
bug を特定する；
コードを修正してテストを続ける；
コードレビューをする；
複雑なエラーを分析する；
工程設計を考える；
長い推論が必要なタスクを処理する；
論文再現、研究分析、セキュリティ分析などの難しい作業。

「Python でファイルを読むには？」のような簡単な質問なら、通常のモデルで十分です。Fugu は、AI にもう少し深く考え、何度か検証してほしい場面に向いています。

インストール前の確認

SakanaAI/fugu の README によると、公式の1行インストールは次に対応しています。

Ubuntu；
macOS。

Windows ユーザー、または1行インストールが完了しない場合は、公式の手動インストール手順に従う必要があります。

事前に確認したいこと：

https://sakana.ai/ にアクセスできる；
ターミナルで curl が使える；
自分の環境が Ubuntu、macOS、Windows のどれか分かっている；
Codex 環境がすでに使える；
会社ネットワークのプロキシやファイアウォールがある場合、インストールスクリプトをダウンロードできる。

EU/EEA 地域にいる場合は、公式ページの利用制限にも注意してください。Fugu は GDPR と EU 固有の規制対応中のため、現在 EU/EEA では利用できません。

1行コマンドで Fugu をインストールする

公式 README にあるインストールコマンドは次の通りです。

`1`	`curl -fsSL https://sakana.ai/fugu/install \| bash`

このコマンドは Sakana の公式アドレスからインストールスクリプトを取得し、bash に渡して実行します。

慎重に進めたい場合は、まずスクリプトの内容だけを表示して確認できます。

`1`	`curl -fsSL https://sakana.ai/fugu/install`

ソースと内容に問題がないことを確認してから、公式のインストールコマンドを実行します。

curl | bash 形式のコマンドは便利ですが、リモートスクリプトを実行するものです。公式 README または公式ドキュメントからだけコピーし、出どころ不明の記事、コメント、スクリーンショットからはコピーしない方が安全です。

codex-fugu を起動する

インストール後、公式 README にある起動コマンドは次の通りです。

`1`	`codex-fugu`

このコマンドが正常に起動すれば、Fugu は Codex の利用フローに接続されています。

最初から大きなリポジトリの問題を投げるのではなく、小さなタスクで試しましょう。たとえば：

`1`	`現在のプロジェクト構造を読み、主要ディレクトリがそれぞれ何をするか説明してください。`

または：

`1`	`最近の変更を確認し、ビルドや公開に影響する可能性のあるリスクを探してください。`

このようなタスクは具体的でありながら重すぎず、Fugu の出力スタイル、速度、安定性を見るのに向いています。

インストール後のおすすめテスト

初めて codex-fugu を使うなら、次の順番がおすすめです。

まずリポジトリ構造について質問する；
次に特定のファイルを見てもらう；
小さな bug を分析してもらう；
最後に複数ファイルにまたがるタスクを試す。

たとえば：

`1`	`まずこのリポジトリを確認し、入口ファイル、コンテンツディレクトリ、ビルドスクリプトがどこにあるか教えてください。`

次に：

`1`	`content/post/2026/06/127/index.zh-cn.md の front matter が完全か確認してください。`

さらに：

`1`	`この記事の title、slug、description に不一致がないか確認し、修正案を出してください。`

小さいところから大きいところへ進める方が安定します。まず現在のプロジェクトを理解できているか確認してから、複雑なタスクを任せるのがよいです。

Fugu に向いている Codex タスク

Fugu はマルチエージェント協調をモデル/API として提供するものなので、複数ラウンドの思考が必要なタスクに向いています。

1. コードレビュー

次のように依頼できます。

`1`	`現在の未コミット変更を code review の観点で確認してください。bug、回帰リスク、テスト不足を優先してください。`

この種のタスクは複数ファイルを読み、文脈を理解し、リスクを判断する必要があります。単純なQ&Aより、マルチエージェント協調の価値が出やすいです。

2. Bug の特定

次のように依頼できます。

`1`	`この機能でエラーが出ています。まずログから原因候補を特定し、関連ファイルを確認し、最後に最小修正案を出してください。`

Bug の特定は段階的な調査が必要です。Fugu のようなシステムは、分析、検証、修正提案をつなげる用途に向いています。

3. 複数ファイルの変更

次のように依頼できます。

`1`	`この設定値をハードコードから環境変数読み込みに変更し、関連テストの更新が必要か確認してください。`

複数ファイルの変更では境界を見落としがちです。Fugu を使う場合は、先に影響範囲を説明してもらってから編集に進むのが安全です。

4. ドキュメントとチュートリアル整理

次のように依頼できます。

`1`	`現在の README とコード構造をもとに、初心者向けのインストールと実行ガイドを整理してください。`

資料を読み、構造化し、実行可能な手順として書く必要があるため、この種のタスクも Fugu に向いています。

5. 難易度の高い分析タスク

研究、論文再現、セキュリティ分析、長い工程調査には Fugu Ultra を検討できます。

ただし日常の開発タスクで最初から Ultra を使う必要はありません。まず通常の Fugu でコスト、速度、結果を見た方が堅実です。

Fugu と Fugu Ultra の選び方

Sakana の公式ページでは、Fugu には2つのモデルがあると説明されています。

Fugu
Fugu Ultra

簡単に言うと：

モデル	向いている場面	方向性
Fugu	日常のコーディング、コードレビュー、チャットボット、普通の複雑タスク	性能と遅延のバランス
Fugu Ultra	高難度推論、研究、競技、安全分析、長いタスク	結果品質を優先

日常的には：

普通の開発タスクはまず Fugu；
複数ファイルの複雑なタスクもまず Fugu；
結果が浅い場合に Fugu Ultra を検討；
高コスト・高リスクなタスクでは、モデル回答だけでなくテストと人間のレビューを組み合わせる。

Windows ユーザーはどうするか

公式 README では、1行インストールは Ubuntu と macOS に対応するとされています。Windows ユーザー、またはインストールが完了しない場合は、公式の手動ガイドに従う必要があります。

Windows では次を優先して検討します。

WSL Ubuntu を使う；
macOS または Linux マシンでインストールする；
Sakana 公式コンソールまたはドキュメントの Windows 手動手順を確認する；
Linux/macOS の shell コマンドを PowerShell にそのまま貼らない。

特に：

`1`	`curl -fsSL https://sakana.ai/fugu/install \| bash`

これは bash コマンドであり、PowerShell のネイティブコマンドではありません。Windows に bash 環境がなければ失敗する可能性が高いです。

よくある問題

1. curl コマンドが失敗する

まずネットワークを確認します。

`1`	`curl -I https://sakana.ai/fugu/install`

接続できない場合は、ネットワーク、プロキシ、証明書、ファイアウォールの問題かもしれません。

2. bash が見つからない

現在の環境に bash がないということです。Windows PowerShell でよく起こります。

対処法：

WSL に切り替える；
macOS/Linux を使う；
公式の手動インストール手順に従う。

3. codex-fugu コマンドが見つからない

考えられる原因：

インストールが成功していない；
コマンドが PATH に追加されていない；
現在のターミナルが環境変数を読み直していない；
インストールスクリプトが現在の shell にしか反映されていない。

まずターミナルを開き直して、もう一度試します。

`1`	`codex-fugu`

それでもだめなら、公式のインストール説明に戻ってパス設定を確認します。

4. 通常モデルより遅い

必ずしも異常ではありません。

Fugu の背後では複数モデルが協調するため、複雑なタスクでは内部ステップが増えることがあります。軽い質問すべてに向くわけではありません。

5. 会社のコードをアップロードしてよいか

慎重に判断してください。

公式ページでは、データ、プライバシー、コンプライアンス要件に応じて特定 provider やモデルを除外できると説明されています。ただし会社コード、顧客データ、脆弱性情報、特許資料を扱う場合は、組織のデータポリシーとモデルプール設定を先に確認すべきです。

利用のコツ

初回から最大で最難のタスクを投げるのはおすすめしません。

より安定した流れは：

小さなリポジトリで試す；
まず構造を読ませる；
小さな bug を渡す；
複数ファイル変更を試す；
最後に複雑な工程タスクへ進む。

プロンプトも具体的にします。

まず関連ファイルを読んでから修正計画を出してください。影響範囲を確認したうえで、必要なファイルだけ変更してください。完了後、何を確認したか説明してください。

このような制約を入れると、結果を制御しやすくなります。

まとめ

Fugu を一言で理解するなら、「マルチエージェントシステムを1つのモデル/APIとして包んだもの」です。

ただし実際に試す価値があるのは、Codex 向けの入口です。

1
2

curl -fsSL https://sakana.ai/fugu/install | bash
codex-fugu

日常開発者にとって、Fugu はコードレビュー、bug 特定、複数ファイル変更、複雑なドキュメント整理、長い工程タスクに向いています。まず小さなタスクから試し、日常の Codex ワークフローに入れるか判断しましょう。

Fugu on KnightLiブログ

SakanaAI Fugu 利用ガイド：Codex でマルチエージェントモデルを有効にする方法

Fugu を最初に何へ使うべきか

インストール前の確認

1行コマンドで Fugu をインストールする

codex-fugu を起動する

インストール後のおすすめテスト

Fugu に向いている Codex タスク

1. コードレビュー

2. Bug の特定

3. 複数ファイルの変更

4. ドキュメントとチュートリアル整理

5. 難易度の高い分析タスク

Fugu と Fugu Ultra の選び方

Windows ユーザーはどうするか

よくある問題

1. curl コマンドが失敗する

2. bash が見つからない

3. codex-fugu コマンドが見つからない

4. 通常モデルより遅い

5. 会社のコードをアップロードしてよいか

利用のコツ

まとめ