Windsurf (Codeium) のセットアップ方法：実践ガイド

TL;DR

• 2分でインストール：VS Code（ext install Codeium.codeium）または JetBrains（プラグインで「Codeium」を検索）。
• カスケードモード：エージェント型 ワークフローによるマルチステップコーディング（例：/refactor + /test）。
• 無料プラン：自動補完は無制限、チャットリクエストは1日50回。Proプラン（$12/ユーザー/月）でチャット無制限を解除。
• プライバシー：テレメトリーなし、セルフホスティング可能（Enterprise）。AIセキュリティ態勢フレームワーク™ の PROTECT および COMPLY フェーズに準拠。

1. インストールとセットアップ

VS Code（推奨）

# CLI経由でインストール（VS Codeを開いておく必要あり）
code --install-extension Codeium.codeium

期待される出力：

Installing extensions...
Extension 'Codeium.codeium' v3.12.0 was successfully installed.

インストール後：

1. VS Codeを再読み込み。
2. GitHub/GitLab/Googleでサインイン（または自動補完のみで匿名利用）。
3. 権限を承認（ワークスペースファイルへの読み書き権限）。

注意点：

• 自動補完が表示されない場合は、ステータスバー（右下）でエラーを確認。コマンドパレット（Ctrl+Shift+P）から Codeium: Restart Extension を実行。

JetBrains（IntelliJ、PyCharmなど）

1. Settings > Plugins を開く。
2. Codeium を検索してインストール。
3. IDEを再起動。
4. ポップアップからサインイン。

注意点：

• JetBrainsのプラグインはVS Codeより更新が遅い。最新機能を利用するには、CodeiumのJetBrains Nightly Builds を使用。

CLI（ターミナル）

# Pythonパッケージをインストール（Python 3.8以上が必要）
pip install codeium --upgrade

インストール確認：

codeium --version
# 出力: codeium, version 3.12.0

認証：

codeium auth
# ブラウザが開きサインイン。トークンは ~/.codeium/credentials.json に保存。

2. カスケードモード（エージェント型コーディング）

カスケードモードでは、AIアクションを連鎖させて（例：リファクタリング → テスト → ドキュメント作成）1つのプロンプトで実行できます。AIセキュリティ態勢フレームワーク™ の ASSESS および PROTECT フェーズに重要（例：自動セキュリティ修正）。

カスケードモードの有効化

1. Codeiumのチャットパネルを開く（VS Codeでは Ctrl+Shift+I）。
2. /cascade と入力してマルチステップワークフローを開始。

例：セキュアリファクタリング

プロンプト：

/cascade
1. このPython関数を型ヒントを使用してリファクタリングし、ハードコードされたシークレットを削除。
2. `user_id` パラメータに入力検証を追加。
3. pytestを使用してユニットテストを生成。

期待される出力：

# リファクタリングされた関数（ステップ1）
def get_user_data(user_id: str, api_key: str = os.getenv("API_KEY")) -> dict:
    if not isinstance(user_id, str) or len(user_id) != 36:
        raise ValueError("user_idは36文字のUUID文字列である必要があります")
    # ... 関数の残りの部分

# 生成されたテスト（ステップ3）
def test_get_user_data():
    with patch("os.getenv", return_value="test_key"):
        assert get_user_data("123e4567-e89b-12d3-a456-426614174000") == {...}

プロのヒント：

• /cascade + /explain を使用して変更点をコンプライアンスのために監査（AIセキュリティ態勢フレームワーク™ の COMPLY フェーズ）。
• 一般的なワークフローはカスタムコマンドとして保存（セクション5を参照）。

3. 自動補完の設定

自動補完の有効化/無効化

VS Code：

1. Settings (Ctrl+,) を開く。
2. Codeium: Enable Autocomplete を検索。
3. チェックボックスを切り替え。

JetBrains：

1. Settings > Tools > Codeium に移動。
2. Enable Autocomplete をチェック/解除。

トリガーキーのカスタマイズ

settings.json に追加（VS Code）：

{
  "codeium.enableAutoSuggestions": true,
  "codeium.suggestionTriggerKeys": ["Tab", "Enter"] // デフォルト: ["Tab"]
}

注意点：

• Tab がスニペットと競合する場合は、Enter を使用。

言語別設定

{
  "codeium.languageSettings": {
    "python": {
      "maxSuggestions": 5, // デフォルト: 3
      "suggestionDelay": 200 // ミリ秒（デフォルト: 300）
    },
    "javascript": {
      "disableAutocomplete": true // 特定の言語では無効化
    }
  }
}

4. コマンドパレットとショートカット

必須ショートカット

カスタムコマンド

~/.codeium/commands.json でスラッシュコマンドを定義：

{
  "commands": [
    {
      "name": "secure-refactor",
      "description": "セキュリティチェック付きでコードをリファクタリング",
      "prompt": "/cascade\n1. 入力検証を追加\n2. ハードコードされたシークレットを削除\n3. 機密操作のログを追加"
    }
  ]
}

使用方法： チャットパネルで /secure-refactor と入力。

5. モデルの選択

クラウドモデル（デフォルト）

Codeiumはコード最適化のための独自モデルを使用。無料/Proプランでは設定不要。

ローカルモデル（実験的）

要件：

• 16GB以上のRAM、NVIDIA GPU（推奨）。
• Ollama または LM Studio をインストール。

ローカルモデルの設定：

1. settings.json（VS Code/JetBrains）を開く。
2. 以下を追加：

{
  "codeium.useLocalModel": true,
  "codeium.localModelPath": "/path/to/model.gguf" // 例: CodeLlama-7B
}

注意点：

• ローカルモデルは動作が遅く、マルチファイルコンテキストに対応していない。オフライン作業のみに使用。

6. モノレポでの作業

マルチファイルコンテキストの有効化

1. IDEでモノレポのルートディレクトリを開く。
2. Codeiumが自動的にワークスペース内のファイルをインデックス化。

制限事項：

• コンテキストの最大トークン数は32k（長いファイルは切り捨てられる場合あり）。
• 大規模リポジトリ（10kファイル以上）の場合は、settings.json でディレクトリを除外：

{
  "codeium.excludedDirectories": [
    "**/node_modules",
    "**/dist",
    "**/.git"
  ]
}

例：クロスファイルリファクタリング

プロンプト：

/cascade
1. `backend/services/user.py` の `UserService` クラスを、`backend/clients/auth.py` の新しい `AuthClient` を使用するように更新。
2. データベーススキーマ変更のためのマイグレーションスクリプトを生成。

期待される出力：

• Codeiumは以下を実行：
  1. user.py に AuthClient をインポート。
  2. 非推奨の認証メソッドを置き換え。
  3. migrations/002_add_auth_client.sql ファイルを生成。

7. 無料プラン vs. Proプランの機能比較

Proプランへのアップグレード：

1. IDE内のCodeiumパネルを開く。
2. Upgrade をクリックし、プランを選択。

一般的なエラーと対処法

主な代替ツールの比較

次のステップ

1. カスケードモード を設定し、最も繰り返しの多いタスクを自動化（例：/cascade /refactor /test）。
2. カスタムコマンド を設定してセキュリティチェックを実施（例：/secure-audit でシークレットをスキャン）。
3. 規制業界の場合はセルフホスティング を検討（Codeium Enterprise にお問い合わせ）。

AIツールを導入するチーム向けに、Hyperion Consultingは AIセキュリティ態勢フレームワーク™ ワークショップを提供し、Codeiumをセキュリティおよびコンプライアンス目標に合わせるサポートを行っています。詳細は hyperion-consulting.io をご覧ください。