MochiuWiki : SUSE, EC, PCB

AIモデル - Windsurf

概要

Windsurf (旧Codeium) は、Codeium社が開発したAI駆動の統合開発環境である。
VS Codeをベースにしたスタンドアロンエディタで、Cascadeと呼ばれるAIエージェント機能を中心に展開している。

2024年11月にCodeiumからWindsurfにリブランドされた。

主要機能を以下に示す。

  • Cascade (AIエージェント)
    マルチファイル推論、計画機能、ツール統合を備えたAIエージェント
    Writeモード (コード編集) と Chatモード (質問・分析) を切り替え可能
  • Windsurf Tab (自動補完)
    Supercomplete (追加・削除を同時提案する推奨モード) とAutocomplete (従来型補完) を搭載
    SWE-1-miniモデルによるリアルタイム補完
  • SWE-1モデルファミリー
    Windsurf独自開発のソフトウェアエンジニアリング特化モデル
    SWE-1.5、SWE-1、SWE-1-miniの3種類
  • Memory (メモリ機能)
    会話間のコンテキストを自動保存
    ワークスペースに紐づけられ、クレジットを消費しない
  • MCP (Model Context Protocol) 対応
    外部サービスとの連携を実現するプロトコル
  • Workflows (ワークフロー)
    反復的なタスクをスラッシュコマンドで自動化
    ワークフロー間のチェーン呼び出しも可能
  • Worktrees (Wave 13以降)
    Git Worktreeを利用した並列タスクの安全な分離実行
    ワークスペースあたり最大20のWorktreeを管理可能


料金プラン
プラン 月額料金 クレジット/月 特徴
Free $0 25クレジット 基本機能、お試し用
Pro Trial 無料 (2週間) 100クレジット Pro機能を2週間無料体験
Pro $15/月 500クレジット 個人開発者向け、高性能モデル利用可
Teams $30/月/ユーザ 500クレジット チーム管理機能、管理者ダッシュボード
Enterprise $60/月/ユーザ 1000クレジット SSO、SAML、専用サポート


クレジットは月次でリセットされ、使い切った場合は追加購入も可能である。
2025年4月に料金体系が簡素化され、従来の2種類のクレジット制度からシンプルなプロンプトクレジット制度に統一された。

Claude CodeとWindsurfの機能対応表
Claude Code Windsurf 説明
サブエージェント Cascadeの計画エージェント / MCP サブエージェント相当機能はCascadeの自律編集とMCPで実現
スキル Agent Skills SKILL.mdベースの多段階ワークフロー定義
ルール Windsurf Rules / .windsurfrules / AGENTS.md .windsurf/rules/ に配置するMarkdownファイル、または .windsurfrules / AGENTS.md
MCPサーバ MCPサーバ -
(該当なし) Workflows スラッシュコマンドで呼び出す反復タスクの自動化
(該当なし) Worktrees Git Worktreeを利用した並列タスク実行 (Wave 13以降)



対応AIモデル

対応モデル一覧
プロバイダ モデル名
Windsurf SWE-1.5, SWE-1, SWE-1-mini
Anthropic Claude Opus 4.6, Claude Sonnet 4.5, Claude Sonnet 4
OpenAI GPT-5.3-Codex, GPT-5.2-Codex, GPT-4.1, GPT-4o
Google Gemini 3 Flash, Gemini 3 Pro, Gemini 2.5 Pro
その他 Grok, DeepSeek


SWE-1モデルファミリー

Windsurf独自開発のソフトウェアエンジニアリング特化モデルである。

各モデルの特徴を以下に示す。

  • SWE-1.5
    SWE-Bench Proで40.08[%]を達成
    実行速度950 トークン/s (Haiku 4.5の6倍、Sonnet 4.5の13倍高速)
    ソフトウェアエンジニアリング特化のフロンティアサイズモデル
  • SWE-1
    最大規模の高性能モデル
    Claude 4.5 Sonnet、GPT-5.1と競合するレベル
    有料ユーザ向け
  • SWE-1-mini
    Windsurf Tabのリアルタイム補完に特化した軽量モデル
    全ユーザに無制限提供


Cascadeハーネスによる性能向上

同じベースモデル (例: Claude Sonnet) でもCascadeハーネス経由で実行すると、ネイティブ実装と比較して11パーセントポイント以上のSWE-benchスコア向上が確認されている。
これはハーネス設計とモデルの深い統合 (エディタ連携、リント検査、コマンド実行の最適化) による相乗効果である。


主要機能

Cascade

Cascadeは、Windsurfの中核的なAIエージェント機能である。

主な機能を以下に示す。

  • マルチファイル推論
    複数ファイル間の依存関係を自動検出して一括編集
  • 計画機能
    マルチステップの編集計画を自動生成
    Todoリスト作成と複雑なタスク追跡
  • ツール統合
    検索、Web検索、MCPサーバ、ターミナル実行 (最大25ツール呼び出し/プロンプト)
  • フロー認識 (Flow Awareness)
    ユーザのアクション、ターミナル出力、エディタの変更をAIが常に把握


Writeモード と Chatモードの違い
項目 Writeモード Chatモード
用途 コードベース修正・生成 質問と分析
ファイル操作 編集・作成・削除が可能 ファイル修正は不可
特徴 マルチファイル変更計画と実行 コンテキスト理解と推論に特化


ターボモード
モード 説明
Off 全コマンド実行前に手動承認が必須
Auto AIが安全性を判定して自動実行 (Premiumのみ)
Turbo 拒否リスト以外のコマンドを自動実行


Windsurf Tab

コード補完機能を提供する。

主な機能を以下に示す。

  • Supercomplete (推奨モード)
    カーソル周辺の追加・削除を同時に提案する高度な補完
  • Autocomplete
    従来型のカーソル位置での補完
  • Tab to Jump
    関連する編集箇所への自動ジャンプ
  • Tab to Import
    使用しているライブラリの自動インポート


コンテキスト認識の仕組みを以下に示す。

  • ファイル内容と構造
    現在のファイルとプロジェクト構造を解析
  • ターミナルの実行結果
    直前の実行結果を補完に反映
  • Cascadeチャット履歴
    会話の文脈を考慮
  • エディタアクション履歴
    過去の編集パターンを学習
  • クリップボード (オプトイン)
    クリップボード内容を補完に活用


Memory

会話間のコンテキストを自動保存する機能である。

Memoryの特徴を以下に示す。

  • 会話間のコンテキストを自動保存 (クレジット不消費)
  • 手動でメモリを作成可能
  • ワークスペースに紐づけ (他のワークスペースとは共有されない)


その他の機能

その他の補助機能を以下に示す。

  • リバート機能
    Cascadeが行った変更を過去の状態に戻せる
    現在はリバート後の再適用は不可
  • 音声入力
    音声テキスト変換に対応
  • メッセージキューイング
    Cascadeの処理中に追加リクエストをキュー登録可能



Windsurfアカウントの契約手順

ステップ 1 : アカウントの作成

WindsurfのWebサイトにアクセスしてアカウントを作成する。


アカウント作成手順を以下に示す。

  1. Windsurfの公式Webサイトにアクセスする。
  2. [Get Started] または [Sign Up] を選択する。
  3. メールアドレスまたはGoogleアカウントで登録する。
  4. 確認メールが届くので、メール内のリンクをクリックして認証を完了する。


ステップ 2 : プランの選択と契約

ログイン後、プランを選択して契約する。

  1. ダッシュボードの [Plans] または [Pricing]ページにアクセスする。
  2. 使用するプラン (Free / Pro) を選択する。
    Pro Trialを選択すると、2週間無料でPro機能を体験できる。
  3. Proプランの場合、クレジットカード情報を入力する。(Stripe経由)
  4. 契約完了後、サブスクリプション管理ページからプラン変更やキャンセルが可能



Windsurf Editorの設定手順

ステップ 1 : Windsurf Editorのダウンロードとインストール

対応OS一覧を以下に示す。

対応OS
OS 最小バージョン
Windows Windows 10 以降
MacOS macOS Yosemite (10.10) 以降
Linux Ubuntu 20.04 以降


インストール手順を以下に示す。

  1. 上記URLからOSに対応したインストーラをダウンロードする。
    ダウンロードページ : https://windsurf.com/download
  2. ダウンロードしたインストーラを実行する。
  3. インストールウィザードの指示に従ってインストールを完了する。
  4. Windsurf Editorを起動する。


ステップ 2 : 初期セットアップ

初回起動時にセットアップウィザードが表示される。

  1. VS Codeからの設定インポート
    VS Codeを使用している場合、設定や拡張機能を自動でインポートできる。
  2. キーバインドの選択
    [VS Code標準] または [Vim] から選択する。
  3. テーマの選択
    任意のカラーテーマを選択する。


日本語言語パックのインストール手順を以下に示す。

  1. [Ctrl] + [Shift] + [X]キーを同時押下して拡張機能マーケットプレイスを開く。
  2. 検索バーに Japanese Language Pack と入力する。
  3. [Japanese Language Pack for Visual Studio Code]を見つけて、[Install]を選択する。
  4. Windsurf Editorを再起動する。


ステップ 3 : AIモデルの選択

Cascadeで使用するAIモデルを選択する。

  1. Cascadeパネルを開く。([Ctrl] + [L]キーを同時押下)
  2. パネル上部のモデル選択ドロップダウンから使用するモデルを選択する。
    契約プランに応じて、選択可能なモデルが異なる。


ステップ 4 : BYOK (Bring Your Own Key) の設定

自分のAPIキーを使用して、追加のAIモデルにアクセスする設定を行う。

  1. Windsurf設定画面を開く。
  2. [Cascade] - [BYOK]セクションに移動する。
  3. 使用するプロバイダのAPIキーを入力する。
    対応モデル : Claude Sonnet 4.5、Claude Opus 4.5等



JetBrains IDEでの設定手順

ステップ 1 : Windsurfプラグインのインストール

JetBrains IDE (最小バージョン: 2023.3以降) 向けのWindsurfプラグインをインストールする。

対応IDE一覧を以下に示す。

  • IntelliJ IDEA
  • PyCharm
  • WebStorm
  • GoLand
  • PHPStorm
  • CLion
  • RubyMine
  • Rider
  • DataGrip


インストール手順を以下に示す。

  1. JetBrains IDEを起動する。
  2. [設定] (Windows / Linux) または [Preferences] (MacOS) を開く。
  3. [プラグイン] - [マーケットプレース]を選択する。
  4. 検索バーに Windsurf と入力する。
  5. [Windsurf]プラグインを見つけて、[Install]を選択する。
  6. IDEを再起動する。


ステップ 2 : アカウント認証

  1. プラグインインストール後、言語サーバが自動的にダウンロードされる。
  2. 認証ポップアップが表示されるので、[Log in]を選択する。
  3. Webブラウザが開き、Windsurfのオンラインポータルで認証を完了する。


ステップ 3 : リモート開発環境での設定

JetBrains Gateway (最小バージョン: 2025.1.3以降) でリモート開発を行う場合、専用のプラグインが必要である。

  1. JetBrains Gatewayで[プラグイン] - [マーケットプレース]を開く。
  2. Windsurf (Remote Development) プラグインを検索してインストールする。



Vim / Neovimでの設定手順

Vimでの設定

windsurf.vim プラグインを使用する。(Vim 9.0.0185以降)

vim-plugを使用したインストール例を以下に示す。

 call plug#begin()
 Plug 'Exafunction/windsurf.vim', { 'branch': 'main' }
 call plug#end()


認証手順を以下に示す。

  1. Vimを起動する。
  2. コマンドモードで以下を実行する。
    :Codeium Auth
  3. Webブラウザが開き、認証トークンが表示される。
  4. トークンをコピーしてVimのプロンプトに貼り付ける。


Neovimでの設定

windsurf.nvimプラグインを使用する。(Neovim 0.6以降)

lazy.nvimを使用したインストール例を以下に示す。

 {
    "Exafunction/windsurf.nvim",
    dependencies = {
       "nvim-lua/plenary.nvim",
       "hrsh7th/nvim-cmp",
    },
    config = function()
       require("codeium").setup({})
    end,
 }


認証手順を以下に示す。

  1. Neovimを起動する。
  2. コマンドモードで以下を実行する。
    :Codeium Auth
  3. ブラウザで認証を完了する。


※注意
Vim / Neovimプラグインはメンテナンスモードであり、最新のCascade機能はWindsurf EditorまたはJetBrains IDEでの利用を推奨する。


ルール (Rules) の作成手順

ルールはCascadeに従わせる指示を定義するもので、コーディング規約やプロジェクト構造の強制に使用する。

ルール機能の概要

Windsurfには、Cascadeへの指示を定義する仕組みが3種類存在する。

プロジェクト指示ファイルの種類
種類 ファイル/ディレクトリ 説明
.windsurf/rules/ (推奨) .windsurf/rules/*.md Wave 8以降の標準形式
複数ルールファイルに分割可能で、発動モードによる細かい制御が可能
.windsurfrules (レガシー) プロジェクトルート/.windsurfrules Wave 8以前の標準形式
プロジェクトルートに単一ファイルを置くだけで自動的に読み込まれる。(Claude CodeのCLAUDE.mdに最も近い概念)
AGENTS.md 任意のディレクトリ/AGENTS.md ディレクトリスコープ型の指示ファイル
ルートに配置すると全体に適用、サブディレクトリに配置するとその配下のみに適用


ルールには以下の特徴がある。

  • グローバルルール
    全てのワークスペースに適用される。
    global_rules.mdとして保存される。

  • ワークスペースルール
    プロジェクト固有のルールである。
    .windsurf/rules/ ディレクトリに保存される。
  • 文字数制限
    個別ルールファイルは最大6,000文字、グローバル + ワークスペース合計で最大12,000文字である。

  • Markdown形式で記述する。


.windsurfrules (レガシー形式)

.windsurfrules ファイルは、Claude CodeのCLAUDE.mdに最も近い概念である。
プロジェクトルートに単一のテキストファイルを配置するだけで、Cascadeが自動的に検出して読み込む。

Wave 8以前の標準形式であり、現在も後方互換性として動作するが、新規プロジェクトでは .windsurf/rules/ ディレクトリの使用が推奨される。

.windsurfrules の記述例を以下に示す。

 My build system is Bazel
 My testing framework is pytest
 Don't modify any files in vendor/


AGENTS.md (ディレクトリスコープ型)

AGENTS.md ファイルは、ディレクトリ単位で指示を適用する仕組みである。
Claude CodeのCLAUDE.mdと同様に、配置したディレクトリの階層に応じて適用範囲が決まる。

AGENTS.mdファイルの特徴を以下に示す。

  • ルートに配置するとプロジェクト全体に適用される。
  • サブディレクトリに配置するとその配下のみに適用される。
  • 大文字小文字を区別しない。(agents.mdファイルでも認識される)
  • 通常のMarkdown形式で記述する。(特殊なフロントマターは不要)


Claude CodeのCLAUDE.mdとの比較
項目 Claude Code (CLAUDE.md) Windsurf (.windsurfrules) Windsurf (AGENTS.md)
ファイル形式 単一Markdownファイル 単一テキストファイル 単一Markdownファイル
配置場所 プロジェクトルート プロジェクトルート 任意のディレクトリ
自動読み込み はい はい はい
ディレクトリスコープ あり (サブディレクトリに配置可) なし (ルートのみ) あり (サブディレクトリに配置可)
現在のステータス 現行 レガシー (動作可) 現行


4つの発動モード (Activation Mode)

ルールには4つの発動モードがある。

発動モード
モード 説明
Manual @mention で手動実行する。(Cascade入力ボックスで @rule-name と指定)
Always On 常に適用される。
Model Decision AIがルールの説明文から判断して自動適用する。
Glob ファイルパターン (例: *.js、src/**/*.tsx) に基づき自動適用する。


ルールファイルの記述例

日本語化ルール
 # 言語設定
 - すべての応答は日本語で出力する
 - コードのコメントは日本語で記述する
 - 技術用語は必要に応じて英語を併記する


コーディング規約ルール
 # コーディング規約
 
 ## 命名規則
 - ローカル変数: camelCase (例: localVariable)
 - メンバ変数: m_付きcamelCase (例: m_memberVariable)
 - 定数・マクロ: ALL_CAPS (例: MAX_BUFFER_SIZE)
 - クラス名: PascalCase (例: DataProcessor)
 
 ## Qt開発固有ルール
 - Qt6を標準として使用する
 - シグナル・スロット接続は新しい構文を使用:
   connect(sender, &Sender::signal, receiver, &Receiver::slot);
 - QObjectの親子関係を活用し、メモリ管理を簡素化する


C++ / Qt開発向けルール
 # C++/Qt開発ルール
 
 ## コーディング規約
 - C++17以降の規格に準拠する
 - スマートポインタ (std::unique_ptr, std::shared_ptr) を優先的に使用
 - 生ポインタは所有権を持たない観察用途のみで使用
 - 例外処理よりもエラーコード返却を優先 (組み込み向け)
 
 ## テスト
 - コード生成後は単体テストコードも生成する
 - テストフレームワークはGoogle Testを使用する
 
 ## ドキュメント
 - 関数にはDoxygenスタイルのコメントを付ける


ルールの管理方法

ルールの管理は以下の手順で行う。

  1. Cascadeスライダーメニュー (右上) の [Customizations] アイコンを選択する。
  2. [Rules] パネルに移動する。
  3. [+ Global] または [+ Workspace] を選択して新規ルールを作成する。
  4. 各ルールの発動モード (Activation Mode) を設定する。



スキル (Agent Skills) の作成手順

Agent Skillsとは

Agent Skillsは、複雑な多段階タスクを実行するためのフォルダベースのリソースである。
スキルは指示 (instructions) と支援ファイル (supporting files) をバンドルして、Cascadeが呼び出し可能にする。

ルールとスキルの使い分け
ルールとスキルの比較
項目 Rules (ルール) Skills (スキル)
用途 コーディング規約、言語選択、スタイルガイドライン 複数ステップのワークフロー、テンプレート活用タスク
形式 単一Markdownファイル SKILL.md + 支援ファイル群
適用範囲 常時またはパターンマッチ タスク実行時のみ
呼び出し 自動 (Activation Mode) 自動 (descriptionベース) または 手動 (@skill-name)


ワークスペーススキル vs グローバルスキル

スキルには以下の2種類がある。

  • ワークスペーススキル
    .windsurf/skills/<スキル名>/ ディレクトリに配置する。
    プロジェクト固有である。
  • グローバルスキル
    ~/.codeium/windsurf/skills/<スキル名>/ ディレクトリに配置する。
    全ワークスペース共通である。


スキルのディレクトリ構造

スキルは以下のディレクトリ構造で構成される。

.windsurf/skills/<skill-name>/
├── SKILL.md          # コア指示 (必須)
├── scripts/          # Python / Bash実行ファイル
├── references/       # ドキュメント (Markdown等)
└── assets/           # YAML、JSON、設定ファイル


SKILL.mdファイルの記述例

SKILL.mdファイルはYAMLフロントマターを含む必要がある。

  • name
    最大64文字、小文字・数字・ハイフンのみ
  • description
    最大1024文字、スキルの説明 (Cascadeが自動呼び出しの判断に使用)


デプロイメント自動化スキル
 ---
 name: deploy-production
 description: Handle production deployment with safety checks and monitoring
 ---
 
 ## Purpose
 This skill guides you through production deployments with validation and rollback capability.
 
 ## Prerequisites
 - All tests must pass
 - Code must be reviewed and merged
 
 ## Step-by-step Procedure
 1. Verify deployment readiness
 2. Execute deployment
 3. Monitor for errors
 4. Execute rollback if needed (see rollback-procedure.md)
 
 ## Supporting Resources
 - See deployment-checklist.md for detailed checks
 - Refer to rollback-procedure.md for recovery steps


コードレビュースキル
 ---
 name: code-reviewer
 description: Perform comprehensive code review with security and performance analysis
 ---
 
 ## 責務
 - バグや潜在的な問題の発見
 - コード品質の改善提案
 - セキュリティ上の脆弱性チェック
 - パフォーマンス最適化の提案
 
 ## レビュー観点
 - C++コードではメモリリーク、ダングリングポインタに注意
 - Qtコードではシグナル・スロットの接続漏れを確認
 - 例外処理・エラーハンドリングの有無を確認
 
 ## 出力フォーマット
 レビュー結果は以下の形式で出力:
 1. 重大な問題 (修正必須)
 2. 中程度の問題 (修正推奨)
 3. 軽微な問題 (改善提案)
 4. 良い点 (コメント)


スキルの呼び出し方法

スキルは以下の2つの方法で呼び出すことができる。

  • 自動呼び出し
    リクエストがスキルのdescriptionと一致すると、Cascadeが自動実行する。
    例: "This project needs a staging deployment" と入力すると、deploy-to-stagingスキルが自動的に呼び出される。
  • 手動呼び出し
    Cascadeの入力ボックスで @skill-name と入力して明示的に指定する。
    例: @code-reviewer と入力してコードレビュースキルを呼び出す。



ワークフロー (Workflows) の作成手順

ワークフロー機能の概要

ワークフローは、反復的なタスクを自動化するための仕組みである。
スラッシュコマンド (/workflow-name) で即座に実行可能であり、デプロイ、PRレビュー、テスト等の定型作業を効率化する。

ワークフローの特徴を以下に示す。

  • .windsurf/workflows/ ディレクトリにMarkdownファイルとして配置する。
  • スラッシュコマンド (/workflow-name) で呼び出す。
  • ワークフロー内から別のワークフローをチェーン呼び出し可能である。
  • 1ファイル最大12,000文字である。


ワークフローファイルの記述例

調査ワークフロー
 ---
 name: research
 description: 指定されたトピックの技術調査を実行する
 ---
 
 ## 手順
 1. 指定されたトピックの概要を調査する
 2. 公式ドキュメントから重要な情報を収集する
 3. ベストプラクティスと注意事項をまとめる
 4. 結果を構造化して出力する


チェーンワークフロー

ワークフロー内から別のワークフローを呼び出す例を以下に示す。

 ---
 name: create-mediawiki-page
 description: 調査から執筆までを一括で実行するワークフロー
 ---
 
 ## 手順
 1. /research を実行して技術情報を収集する
 2. 収集した情報を整理する
 3. /write-mediawiki を実行してMediaWikiページを作成する


ワークフローとスキルの使い分け

ワークフローとスキルは類似しているが、以下に示す基準で使い分ける。

ワークフローとスキルの比較
観点 Workflows Skills
起動方法 /slash-command (明示的) @mention または自動起動
ファイル形式 単一Markdownファイル フォルダ (SKILL.md + リソース群)
リソース管理 なし (手順のみ) テンプレート、チェックリスト等を同梱可
向いている用途 定型的な手順の自動化 複雑な手順 + 参考資料が必要なタスク
チェーン呼び出し 他のWorkflowを呼び出し可能 不可 (単独で完結)



Worktrees (並列実行)

Worktrees機能の概要

Worktreesは、Git Worktreeを利用して並列タスクを安全に分離実行するための機能である。(Wave 13以降で利用可能)

Worktreesの特徴を以下に示す。

  • 各タスクが独立したGit Worktreeで実行されるため、ブランチ間の干渉を防止する。
  • ~/.windsurf/worktrees/<リポジトリ名>/ に自動管理される。
  • ワークスペースあたり最大20のWorktreeを管理可能である。
  • Cascadeペインでセッション開始時にWorktreeモードを選択する。


フック設定

.windsurf/hooks.json ファイルを使用して、Worktree作成時の環境セットアップを自動化できる。

 {
    "post_setup_worktree": {
       "command": "npm install && npm run build"
    }
 }


post_setup_worktree フックは、Worktreeの作成後に自動的に実行される。
依存関係のインストールやビルドプロセスの実行等、環境構築に必要なコマンドを指定する。


Cascade によるサブエージェント相当機能

Claude Codeのサブエージェントとの比較

Claude Codeのサブエージェントは以下の特徴を持つ。

  • YAMLフロントマターを持つMarkdownファイルとして定義される。
  • 独立したコンテキストウィンドウ (各エージェントが200Kトークン) を持つ。
  • ツールアクセス制限 (Read、Write、Edit、Bash等) が可能である。
  • 異なるモデル (Opus、Sonnet、Haiku等) の使用が可能である。
  • .claude/agents/ または ~/.claude/agents/ に配置される。


WindsurfのCascadeの特徴を以下に示す。

  • Cascadeはネイティブのサブエージェント機能を持たない。
  • 代わりに計画エージェント機能と自律編集機能でサブエージェントに近い動作を実現する。
  • MCPサーバ経由での外部サービス連携も可能である。


サブエージェント機能の比較
項目 Claude Code サブエージェント Windsurf Cascade
エージェント定義 Markdownファイル (.claude/agents/) ネイティブ機能なし
コンテキスト 各エージェント独立 (200Kトークン) 単一のCascadeセッション
モデル選択 エージェントごとに異なるモデル指定可 セッション単位でモデル選択
ツール制限 エージェントごとにツールアクセス制御可 統一されたツールアクセス
並列実行 複数サブエージェントの並列起動可 単一セッションでの順次実行
外部連携 MCPサーバ対応 MCPサーバ対応


Cascadeの自律編集と計画エージェント

Cascadeは以下に示す機能により、サブエージェント相当の動作を実現する。

  • 計画エージェント
    複数ファイル間の依存関係を自動検出し、マルチステップの編集計画を生成する。
    タスクの進捗追跡 (Todoリスト) も自動管理する。
  • 自律編集
    リポジトリ全体のリファクタリング、コンポーネント配線、テスト更新などを自動実行する。
    ユーザの手動編集とCascadeの提案をシームレスに統合する。


MCPサーバによる機能拡張

MCPサーバを使用して外部サービスと連携することで、Claude Codeのサブエージェントに近い機能を実現できる。

MCPサーバの活用例を以下に示す。

  • GitHub MCPサーバ
    Issue管理、PR作成を自然言語で操作する。
  • データベースMCP
    PostgreSQL等への読み取り専用アクセスを提供する。
  • ファイルシステムMCP
    セキュアなファイル操作を実現する。



MCP (Model Context Protocol) の設定

MCP設定ファイルの場所

MCP設定は以下の場所に保存される。

  • グローバル設定
    ~/.codeium/windsurf/mcp_config.json
  • 対応トランスポート
    stdio、Streamable HTTP、SSE (Server-Sent Events)
  • OAuth認証サポート


MCPサーバの追加方法

方法 1 : MCPマーケットプレイスから追加

MCPマーケットプレイスを使用して、MCPサーバを追加する手順を以下に示す。

  1. Cascadeパネル上部の[MCPs]アイコンを選択する。
  2. [MCP Marketplace]を開く。
  3. インストールするMCPサーバを検索する。
    公式MCPサーバは青いチェックマークで表示される。
  4. [Install]を選択してインストールを完了する。


方法 2 : 設定ファイルを直接編集

~/.codeium/windsurf/mcp_config.json を直接編集して、MCPサーバを追加する。

MCPサーバの設定例

以下にMCPサーバの設定例を示す。

 {
    "mcpServers": {
       "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"],
          "env": {
             "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
          }
       },
       "filesystem": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
       }
    }
 }


環境変数補間は、${env:VARIABLE_NAME} 形式で環境変数を参照可能である。

主要なMCPサーバ一覧

主要なMCPサーバ
MCPサーバ 機能
GitHub リポジトリ、Issue、PR管理
Slack チャンネル通知、ワークスペース連携
PostgreSQL 読み取り専用データベースアクセス
Filesystem セキュアなファイル操作 (アクセス制御付き)
Brave Search Web検索機能
Memory 永続的な知識グラフシステム



プロジェクトの構成例

公式推奨の構成パターン

Windsurfの公式ドキュメントでは、5つの機能を相互補完的に使用することが推奨されている。

Windsurfの5つの主要設定機能
機能 役割 起動方法
AGENTS.md ディレクトリスコープの指示 (環境説明) 自動適用
Rules 永続的な制約・ガイダンス Always On / Manual / Model Decision / Glob
Workflows 反復タスクの自動化 /workflow-name スラッシュコマンド
Skills 複雑なマルチステップ手順 + リソースバンドル @skill-name または自動起動
Worktrees 並列実行のためのブランチ分離 (Wave 13以降) Cascadeペインでモード選択


推奨ディレクトリ構成

推奨プロジェクト構成を以下に示す。

プロジェクト/
├── .windsurf/
│   ├── hooks.json                   # Worktreeフック設定 (並列実行時)
│   ├── rules/
│   │   ├── japanese-output.md       # 日本語対応ルール
│   │   ├── coding-standards.md      # コーディング規約ルール
│   │   └── qt-development.md        # Qt開発固有ルール
│   │
│   ├── workflows/
│   │   ├── research.md              # /research (調査ワークフロー)
│   │   ├── write-mediawiki.md       # /write-mediawiki (執筆ワークフロー)
│   │   └── create-mediawiki-page.md # /create-mediawiki-page (チェーンワークフロー)
│   │
│   └── skills/
│       ├── deploy-production/       # デプロイメント自動化スキル
│       │   ├── SKILL.md
│       │   ├── deployment-checklist.md
│       │   └── rollback-procedure.md
│       │
│       └── code-reviewer/           # コードレビュースキル
│           └── SKILL.md
│
├── .windsurfrules                   # レガシー形式のルールファイル (任意)
├── AGENTS.md                        # ディレクトリスコープ型の指示ファイル (任意)
│
├── ~/.codeium/windsurf/
│   └── mcp_config.json              # MCPサーバ設定 (グローバル)
│
└── src/
    ├── AGENTS.md                    # src/配下のみに適用される指示 (任意)
    └── ...


機能別の用途と保存場所

機能別保存場所
機能 用途 保存場所
ルール (Rules) プロジェクト固有規約・制約 .windsurf/rules/
.windsurfrules プロジェクト全体の指示 (レガシー) プロジェクトルート
AGENTS.md ディレクトリスコープ型の指示 任意のディレクトリ
ワークフロー (Workflows) 反復タスクの自動化 .windsurf/workflows/
スキル (Agent Skills) 多段階ワークフロー・テンプレート活用 .windsurf/skills/
Worktrees 並列タスクの分離実行 ~/.windsurf/worktrees/ (自動管理)
MCP 外部API連携・機能拡張 ~/.codeium/windsurf/mcp_config.json
Memory 会話間コンテキストの自動保存 Windsurf内部管理



AIコーディングツール機能比較

AIコーディングツール比較
項目 Windsurf Claude Code Cline
AIアシスタント名 Cascade Claude Cline
ルール .windsurf/rules/ (Markdown) CLAUDE.md .clinerules (Markdown)
スキル/指示 Agent Skills (SKILL.md) Skills (SKILL.md) Custom Instructions
サブエージェント Cascadeの計画エージェント サブエージェント (.claude/agents/) sub-agents-mcp等で実現
MCP対応 対応 (MCPマーケットプレイス) 対応 対応



トラブルシューティング

Windsurf Editorが起動しない

  • インストーラを再ダウンロードして再インストールする。
  • セキュリティソフトがWindsurfの実行をブロックしていないか確認する。


Cascadeが応答しない / エラーが発生する

  • インターネット接続を確認する。
  • クレジット残量を確認する (ダッシュボードの [Usage] ページ)。
  • 選択しているAIモデルが契約プランで利用可能か確認する。
  • Windsurf Editorを再起動する。


自動補完が動作しない

  • Windsurf Tabが有効になっているか設定で確認する。
  • Supercompleteモードが選択されているか確認する。
  • 対象のプログラミング言語がサポートされているか確認する。


MCPサーバが接続できない

  • mcp_config.jsonの構文が正しいか確認する。(JSON形式のバリデーション)
  • 環境変数 (${env:VARIABLE_NAME}) が正しく設定されているか確認する。
  • MCPサーバのプロセスが正常に起動しているか確認する。
  • Windsurf Editorを再起動する。


JetBrains IDEでプラグインが動作しない

  • JetBrains IDEのバージョンが2023.3以降であることを確認する。
  • プラグインを最新版に更新する。
  • IDEを再起動する。
  • リモート開発の場合、Windsurf (Remote Development) プラグイン (バージョン2025.1.3以降) がインストールされているか確認する。


日本語の応答にならない

ルール機能を使用して日本語出力を設定する。

  1. .windsurf/rules/ ディレクトリに日本語化ルールファイルを作成する。
  2. 以下の内容を記述する
    「全ての応答は日本語で出力する」
  3. 発動モードを [Always On] に設定する。



参考リンク



「https://mochiu.net/index.php?title=AIモデル_-_Windsurf&oldid=14273」から取得