メインコンテンツへ移動
AIチュートリアル

Capriチュートリアル:WindowsデスクトップにサイバーパンクAIエージェントをセットアップする

WindowsでCapriをダウンロードして設定し、Claude Code、Codex、Antigravityなどのアシスタントを接続して、デスクトップ操作やコーディングタスクを実行し、承認を管理しながら、ファイルやプロジェクトへのアクセスを安全に制限する方法を解説します。

Capriチュートリアル:WindowsデスクトップにサイバーパンクAIエージェントをセットアップする

Capriとは?

Capriは、Windows向けのサイバーパンク風AIエージェントです。ネイティブなデスクトップインターフェースと、Claude Code、Codex、AntigravityなどのAIアシスタント向けエージェントレイヤーを提供します。ターミナルだけで作業する代わりに、自然な言葉で目標を説明すると、Capriがリクエストを選択したアシスタントに振り分け、ツールを調整し、結果を報告します。

Capriは、ファイル、プロジェクトフォルダー、コード、シェルコマンド、アプリケーション、Web関連のタスクを扱えます。開発者だけでなく、デスクトップ向けの汎用アシスタントを求める人にも適するよう設計されています。

現在、このアプリはWindows 10以降で利用できます。macOSとLinuxへの対応は予定されていますが、まだ利用できません。

主な機能

  • 複数のAIエンジン:Claude Code、Codex、Antigravity、またはカスタムアダプターを介した別のアシスタントを利用できます。
  • デスクトップネイティブのインターフェース:ターミナルだけに依存するワークフローではなく、グラフィカルアプリケーションから作業できます。
  • ファイルとプロジェクトの操作:ファイルやフォルダーの検索、読み取り、整理、編集、分析をCapriに依頼できます。
  • エージェントワークフロー:Capriはタスクを計画し、ツールを使い、結果を確認して、何が起きたかを説明できます。
  • コーディング支援:好みのエンジンを使って、コードの作成、リファクタリング、デバッグ、実行ができます。
  • 自動化:繰り返し作業を自然な言葉によるリクエストに変えられます。
  • 承認コントロール:機密性の高い操作を確認し、実行前に承認または拒否できます。
  • サイバーパンクインターフェース:暗くネオンを取り入れたデスクトップ体験を利用できます。

WindowsにCapriをインストールする

1. リリースをダウンロードする

Capriの最新リリースを開き、利用可能なWindowsパッケージから1つを選択します。

  • Capri-Setup.exe:通常のインストールとスタートメニューへのショートカット作成には、インストーラーを使用します。
  • Capri-Portable.zip:インストールせず、フォルダーからCapriを実行したい場合は、ポータブル版を使用します。

2. アプリケーションを起動する

インストーラー版の場合は、Capri-Setup.exeを実行してセットアップウィザードを完了し、スタートメニューからCapriを開きます。ポータブル版の場合は、Capri-Portable.zipをフォルダーに展開し、その場所からアプリケーションを実行します。

Capriは新しいアプリケーションであるため、Windows SmartScreenに警告が表示される場合があります。リポジトリの公式Releasesページからファイルをダウンロードした場合は、詳細情報を選択し、続けて実行を選択します。

3. AIアシスタントに接続する

初回起動時に、Capriは使用するアシスタントを尋ねます。利用可能なエンジンを選択し、アカウントにサインインするか、必要なAPIキーを入力します。CapriはClaude Code、Codex、Antigravityを標準でサポートしています。その他のアシスタントは、カスタムアダプターを介して接続できます。

選択したエンジンによってリクエストを処理するAIシステムが決まります。一方、Capriはデスクトップインターフェース、ルーティング、ツール、承認ワークフローを提供します。

最初のタスクを実行する

自然な言葉で目標を説明する

Capriに達成してほしいことを具体的に説明するリクエストから始めます。例:

ダウンロードフォルダーを整理して、種類ごとにグループ化してください。

Capriはフォルダーをスキャンして計画を提案し、操作の承認後にファイルを移動できます。最初のテストでは、取り替えのきかないデータが入っていないフォルダーを使用してください。

コーディングタスクを試す

Capriは接続されたエンジンを使ってプロジェクトを調査し、問題を見つけ、コードを変更し、チェックを実行できます。適したリクエストの例:

このプロジェクトのバグを見つけ、原因を説明して修正し、既存のチェックを実行してください。

ファイルの変更やコマンドの実行を伴うタスクでは、承認する前に提案された操作を確認してください。

ドキュメントを扱う

複数のファイルを処理して、まとめた結果を作成するようCapriに依頼することもできます。

このフォルダー内のすべてのPDFを1つのドキュメントに要約してください。

Capriに付与された権限とアクセス範囲に応じて、アシスタントはファイルを読み取り、統合した要約を書き出せます。

Capriがリクエストを処理する方法

  1. 目標を説明する:自然な言葉でリクエストを入力します。
  2. リクエストを振り分ける:Capriが選択したAIエンジンに送信します。
  3. 作業を計画する:エンジンが必要な手順とツールを判断します。
  4. 承認を求める:機密性の高い操作を承認する機会がCapriから提示されます。
  5. 実行して報告する:Capriが関連するツールを使い、結果を報告します。

ツールレイヤーは、ファイルとプロジェクト、シェルとアプリケーション、Web関連のタスクを扱えます。承認ゲートは、システムやデータを変更する可能性のある操作について、ユーザーが関与し続けられるようにするためのものです。

エンジンを選択・切り替える

CapriはClaude Code、Codex、Antigravityを直接サポートしています。READMEには、カスタムアダプターを介してその他のアシスタントをサポートする方法も記載されています。タスクに最も適したエンジンを使用し、別のアシスタントのほうが適している場合は切り替えてください。

たとえば、コーディングワークフローには1つのエンジンを使い、一般的なデスクトップタスクには別のエンジンを使えます。サインインやAPIキーの手順は、接続するアシスタントのプロバイダーによって異なります。

権限とインターフェースを設定する

READMEには、次の設定例が記載されています。

engine: claude-code        # claude-code | codex | antigravity | custom

permissions:
  mode: ask                # ask before acting | auto | read-only
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

engine設定では、接続するアシスタントを選択します。権限モードは、操作前に確認する、 自動的に実行する、または読み取り専用アクセスを使用するよう設定できます。allowed_foldersリストでは、Capriがアクセスできる場所を制限し、インターフェース設定ではサイバーパンクテーマを選択します。

アプリケーションに慣れるまでは、制限の厳しい設定を使用してください。まずはmode: askから始め、タスクに必要なフォルダーだけを許可します。

高度な使い方と自動化のヒント

タスクの範囲を明確にする

適切なリクエストでは、場所、求める結果、制限事項を明確にします。Capriにすべてを整理するよう頼む代わりに、フォルダーを指定し、項目をどのように分類するかを説明してください。これにより、提案されたプランを確認しやすくなります。

繰り返し作業は慎重に自動化する

Capriは、繰り返し作業を1文の指示にまとめられるよう設計されています。プロジェクトの例には、新しいWebアプリをセットアップして起動することや、Documentsフォルダーを定期的にバックアップするよう依頼することがあります。継続的なワークフローを有効にする前に、実行されるアクションを確認し、保存先とファイルが正しいことを確かめてください。

ロードマップではタスクスケジューラーが別途計画中の機能として記載されています。そのため、リリース済みアプリケーションですべてのスケジュール機能が利用できるとは考えないでください。

必要に応じてカスタムアダプターを使用する

使いたいアシスタントが組み込みエンジンに含まれていない場合、プロジェクトでは他のアシスタントに接続する方法としてカスタムアダプターを説明しています。カスタム連携を計画する前に、現在のリリースドキュメントとリポジトリのIssueで実装の詳細を確認してください。

安全に関する推奨事項

  • 承認前にアクションを確認する: ファイルの削除、移動、上書き、シェルコマンドには特に注意してください。
  • フォルダーへのアクセスを制限する: 現在のタスクに必要なディレクトリだけへのアクセスをCapriに許可します。
  • バックアップを維持する: 大規模な操作や自動操作を実行する前に、重要なデータをバックアップしてください。
  • 認証情報を保護する: APIキー、アカウントトークン、その他の認証情報を決して共有しないでください。
  • プロバイダーのポリシーを確認する: リクエストは、接続したAIアシスタントによって、そのプロバイダーの利用規約とプライバシーポリシーに基づいて処理されます。

Capriはアクションを確認できるよう設計されていますが、デスクトップ自動化ツールにリスクがないわけではありません。承認プロンプトを煩わしいものではなく、セキュリティ境界として扱ってください。

トラブルシューティングとサポート

Windowsによってアプリケーションがブロックされた場合は、SmartScreenの上書きを使用する前に、プロジェクトの公式Releasesページからダウンロードしたことを確認してください。アシスタントに接続できない場合は、選択したエンジン、サインイン状態、APIキーまたはアカウント認証情報を確認してください。

機能の要望や問題については、リポジトリのIssueトラッカーを利用してください。プロジェクトのロードマップには、macOS版とLinux版、プラグインシステム、モバイルコンパニオン、コミュニティによるサイバーパンクテーマギャラリーが含まれています。

まとめ

Capriは、Windowsデスクトップインターフェースと、普段使っているAIアシスタントを組み合わせます。インストーラーまたはポータブル版をダウンロードしたら、エンジンを接続し、タスクを説明して、Capriによるファイル、プロジェクト、アプリケーションへの操作を許可する前に、提案されたアクションを確認してください。制限した権限と簡単なリクエストから始め、慎重に確認したコーディングワークフローや自動化へ段階的に広げていきましょう。