Codeium 製の AI IDE。Cursor と同じく VS Code 派生だが、エージェント挙動の自律性が一段強めに設計されている。「Cascade」というチャットパネルが本体機能の中心。

---

凡例

• 🟢 安全 — 読み取り・参照のみ
• 🟡 注意 — ファイル編集・コマンド実行・課金発生
• 🔴 危険 — エージェント全自動・破壊的操作リスクあり

---

クイックリファレンス

キーボードショートカット

重要な設定（Settings 内）

プロジェクト前提知識

---

インストール

公式サイト からダウンロード → インストーラを実行。VS Code の設定・拡張・キーバインドをインポート可能。

初回起動時:

• テーマ選択
• キーバインド（VS Code / Vim）
• アカウント作成（無料プランあり、Pro プランは Cascade 利用回数が多い）

---

Cascade（チャットパネル）

右サイドに表示されるエージェントパネル。Windsurf の中心機能。

Cascade を開く: ⌘ + L (Mac) / Ctrl + L (Win)
コマンドパレット: ⌘ + ⇧ + P (Mac) / Ctrl + Shift + P (Win)

Cascade は単なるチャットではなく、ファイル編集・コマンド実行を自律的に行うエージェント。「機能追加して」「テスト書いて」のような指示で複数ステップを連続実行する。

🟡 注意 / Cascade の各操作には承認プロンプトが出る。流れ作業で yes を連打しないよう注意。

---

モデル選択

Cascade パネル下部のプルダウンで切り替え。

主要モデル（執筆時点）:

• Claude Sonnet 系
• GPT-5 系
• Gemini 2.5 系
• Windsurf 独自の Fast / Premium モデル

タスクの重さで切り替えるのが基本。簡単な質問は Fast、複雑な refactor は Sonnet/Opus 級に。

---

メモリとルール

Windsurf には「Memories」と「Rules」の2つのカスタマイズ機構がある。

Memories

セッション中に Cascade が「この情報は覚えておくべき」と判断したものを自動的にメモリ化する仕組み。ユーザーは Settings から閲覧・削除可能。

Rules

プロジェクトルートに .windsurfrules を置くと、毎回セッションで前提として読み込まれる（Claude Code の CLAUDE.md 相当）。

# .windsurfrules
- TypeScript + Next.js (App Router)
- テスト実行: pnpm test
- 触ってはいけない: src/legacy/**

global_rules.md ファイルで全プロジェクト共通のルールも書ける。

---

MCP（Model Context Protocol）

外部ツール・データソースを Cascade に接続できる。Claude Code、Codex、Gemini と互換性のある仕組み。

Settings → Cascade → MCP Servers で追加:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

🟡 注意 / MCP サーバを足すたびに「Cascade が触れる範囲」を確認。

---

ターミナル統合

Windsurf のターミナルには Cascade が直接コマンドを書き込んで実行する機能がある。

🟡 注意 / コマンド実行前に確認ダイアログが出る（設定で「Auto-execute」をオフ推奨）。「Auto-execute」を有効化すると Cascade がノーチェックでコマンドを走らせる = 🔴 危険なので隔離環境以外では避ける。

---

設定ファイルの場所

---

VS Code 拡張との互換性

Windsurf は VS Code フォークなので、ほとんどの拡張機能がそのまま動く。ただし:

• AI 系拡張（Copilot 等）は競合するので無効化推奨
• 一部の独自プロトコル拡張（Live Share 等）は非対応
• 拡張は VS Code Marketplace ではなく Windsurf 内の拡張ストアから

---

セキュリティで意識すること

• ターミナル統合の「Auto-execute」は基本オフ
• .windsurfrules で「触ってはいけないファイル」を明示
• MCP サーバ追加時のスコープ確認
• メモリに機密情報が残っていないか定期確認（Settings → Memories）
• Cascade に .env 系ファイルを参照させない（.gitignore だけでなく .windsurfignore が必要な場合あり）

---

つまづきがちな点

「無料プランの Cascade 回数制限に達した」 → Cascade の「Premium プロンプト」回数は日次/月次でリセット。Fast モデルだけなら無制限のことが多い。

「Cascade が暴走した」 → パネル上部の「Stop」ボタン。途中まで適用された変更は git status で確認して必要なら revert。

「VS Code の設定を引き継いだら拡張が大量にエラー」 → AI 系拡張（Copilot、Cody 等）は無効化。重複機能で衝突する。

「料金が想定より高い」 → Pro プランの Premium 回数が課金対象。Fast モデルで済む作業は Fast を選ぶ。

---

このページは執筆時点の挙動。Windsurf は更新ペースが速いので、致命的なオプションは 公式ドキュメント で突合してから使う。