> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Cascade 概要
> Cascade は、Code/Chat モード、ツール呼び出し、音声入力、チェックポイント、リアルタイムの状況把握、Linter との連携を備えた Windsurf のエージェント型 AI アシスタントです。
Windsurf の Cascade は、人間と AI のコラボレーションを新たな次元へ引き上げます。
Cascade を開くには、`Cmd/Ctrl+L` を押すか、Windsurf ウィンドウ右上の Cascade アイコンをクリックします。エディターまたはターミナルで選択中のテキストは自動的に取り込まれます。
### 機能へのクイックリンク
Cascade の提案で参照する情報をウェブ検索します。
Memories とルールで動作をカスタマイズできます。
MCP サーバーでエージェントの機能を拡張します。
進化した Terminal 体験。
繰り返し作業を自動化します。
アプリケーションをワンクリックでデプロイ。
# モデルの選択
Cascade の会話入力ボックス直下にある選択メニューから、使用したい AI モデルを選びます。以下をクリックすると、利用可能なモデルの全リストと、各プラン・料金での提供状況を確認できます。
Windsurf におけるモデルの提供状況
# Cascade Code / Cascade Chat
Cascade には主に 2 つのモードがあります：**Code** と **Chat**。
Code モードでは、Cascade がコードベースの作成や変更を行えます。一方、Chat モードは、コードベースに関する質問や一般的なコーディング原則への照会に最適化されています。
Chat モードでは、Cascade が新しいコードを提案することがあり、そのまま承認して挿入できます。
# プランとTodoリスト
Cascade には、長時間にわたるタスクのパフォーマンス向上に役立つ計画機能が組み込まれています。
バックグラウンドでは、専用の計画エージェントが長期計画を継続的に洗練し、選択した AI モデルはその計画に基づいて短期的なアクションの実行に集中します。
Cascade は、会話内に Todo リストを作成して、複雑なタスクの進捗を追跡します。計画を変更したい場合は、Cascade に Todo リストの更新を依頼するだけでかまいません。
また、会話の過程で [Memory](/ja/windsurf/cascade/memories) のような新しい情報を取り込むと、Cascade が自動的に計画を更新することもあります。
# キューされたメッセージ
Cascade が現在のタスクを処理している間でも、完了後に順番に実行される新しいメッセージをキューに追加できます。
キューにメッセージを追加するには、Cascade の処理中にメッセージを入力して `Enter` を押してください。
* **すぐに送信**: 空のテキストボックスで Enter をもう一度押すと、その場で送信されます。
* **削除**: 送信前のメッセージをキューから削除します
# ツール呼び出し
Cascade には、Search、Analyze、[Web Search](/ja/windsurf/cascade/web-search)、[MCP](/ja/windsurf/cascade/mcp)、[terminal](/ja/windsurf/terminal) など、さまざまなツールが用意されています。
使用中のパッケージやツールの検出、未インストールの特定、さらには自動インストールまで対応します。プロジェクトの実行方法を Cascade に尋ねて、Accept を押すだけです。
Cascade はプロンプトあたり最大 20 回までツールを呼び出せます。進行が止まった場合は、`continue` ボタンを押すと中断地点から再開します。ただし、ツール呼び出しコストにより、各 `continue` は新しいプロンプトクレジットとしてカウントされます。
`Auto-Continue` を有効にすると、上限に達した際に Cascade が自動で応答を継続します。これらは、使用している AI モデルに応じたプロンプトクレジットを消費します。
# 音声入力
音声入力を使って、声で Cascade とやり取りできます。現時点では、発話をテキストに文字起こしできます。
# 名前付きチェックポイントとリバート
Cascade が行った変更はリバートできます。元のプロンプトにカーソルを合わせて右側のリバート矢印をクリックするか、目次から直接リバートしてください。これにより、指定したステップ時点のコードベースの状態へ、すべてのコード変更が戻ります。
リバートは現在元に戻せません。ご注意ください！
会話内から、プロジェクトの現在の状態に名前を付けたスナップショット／チェックポイントを作成でき、いつでも簡単に移動してリバートできます。
# リアルタイム認識
Windsurf と Cascade には、あなたの操作をリアルタイムに把握する独自の機能があり、直前の操作に関するコンテキストを毎回プロンプトで与える必要がありません。
Cascade に「Continue」と指示するだけで続行できます。
# 問題を Cascade に送る
エディタ下部の Problems パネルに表示されたコード上の問題は、`Send to Cascade` ボタンをクリックするだけで、@メンションとして Cascade パネルに送れます。
# 説明して修正
エディタ内でエラーが発生した場合は、該当箇所を選択して `Explain and Fix` をクリックするだけで、Cascade が自動で修正します。
# ファイルの除外
Cascade に特定のファイルを無視させたい場合は、ワークスペースのルートにある `.codeiumignore` に対象のファイルやパスを追加してください。これにより、指定したパス配下のファイルを Cascade が閲覧・編集・作成することを防げます。ファイルパスの指定は `.gitignore` と同様の形式で記述できます。
## グローバル .codeiumignore
複数のリポジトリを管理する Enterprise 契約の顧客は、`~/.codeium/` フォルダにグローバルな `.codeiumignore` ファイルを配置することで、すべてのリポジトリに対して無視ルールを一括適用できます。このグローバル設定は、システム上のすべての Windsurf ワークスペースに適用され、各リポジトリ固有の `.codeiumignore` ファイルと併用されます。
# Linter 連携
Cascade は生成したコードの lint エラーを自動的に修正できます。これはデフォルトで有効ですが、ツール呼び出しで `Auto-fix` をクリックし、`disable` を選択すると無効化できます。この編集はクレジットを消費しません。
Cascade が自身で生成し自動検出した lint の修正を主目的とした編集を行う場合、
その編集をクレジット不要として扱う（割引する）ことがあります。これは、
lint エラーの修正によって Cascade のツール呼び出し回数が増えることを考慮したものです。
# 会話を共有する
この機能は現在、Teams および Enterprise のお客様のみご利用いただけます。
Cascade パネル右上の `...`（その他のオプション）ボタンをクリックし、`Share Conversation` を選択すると、Cascade のやり取り（トラジェクトリ）をチームと共有できます。
# @メンションで過去の会話を参照する
`@メンション`を使って、他のスレッドから過去の会話を参照できます。
この操作を行うと、Cascade は会話の要約やチェックポイント、あなたが指定した会話の該当箇所など、最も関連性が高く有用な情報を取得します。コンテキストウィンドウの圧迫を避けるため、通常は会話全体は取得しません。
# 複数の Cascade の同時実行
ユーザーは複数の Cascade を同時に起動できます。Cascade パネル左上のドロップダウンメニューで、それぞれを切り替えて操作できます。
2 つの Cascade が同じファイルを同時に編集すると、編集が競合し、後から行った編集が失敗する場合があります。
2 つの Cascade が類似したファイルを編集することが想定される場合は、それぞれを分離するために [worktrees](./worktrees) の利用を検討してください。