ドキュメントの全ページを検索するには、2文字以上入力してください。

↑ ↓ で移動 ↵ で開く esc で閉じる

rdev の使い方

AIエージェント

rdev には設定済みの AI エージェントプロファイルが付属しているため、エージェントは初日から環境の仕組みを理解しています。

対応エージェント

エージェント サポート
Claude Code フル
Codex フル
opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI フル
Cursor CLI, Antigravity CLI 標準
AGENTS.md を読み取り MCP に対応するその他のエージェント 標準(ご自身でインストール)

フルサポートとは、インストーラー、プロファイル、管理設定、通知、セッションステータス、アップデートがそのエージェントを対象としていることを意味します。標準サポートとは、エージェント固有の機能はなく、共通ルールと MCP アクセスが提供されることを意味します。パネルの エージェント タブには、各エージェントの横にサポートレベルが表示されます。

エージェントのインストール

サイドバーの サーバー からサーバーを開き、エージェント を選択します。AI エージェント カードには、rdev が認識しているすべてのエージェントについて、インストール済みかどうか、バージョン、起動コマンド(横のボタンでコピーできます)が一覧表示されます。インストール でエージェントを追加し、⋯ メニューから更新や削除ができます。Codex は環境のイメージに含まれているため削除できません。変更はサーバー上で実行され、数秒から1分ほどかかります。完了するとカードに結果が表示されます。

エージェントは環境ごとに設定されます。Team プランでは各メンバーが自分の環境のエージェントを選択し、ここでインストールしても、ほかの人には影響しません。この機能には rdev 0.2.0-beta.36 以降が必要です。サーバーがそのバージョンになるまでは、カードに更新を促す表示が出ます。

エージェントの更新

エージェントがサーバー上で自分自身を更新することはなく、エージェント内に「更新をインストールしました。再起動してください」という通知が出ることもありません。⋯ メニューまたは rdev agents update(1 つだけなら rdev agents update claude)で更新します。バージョンが変わると、rdev はそのエージェントのアイドル状態のセッションを新しいバージョンで開き直します。同じターミナルウィンドウ、同じ会話で、履歴もそのままです。エージェントが作業中またはあなたの返答を待っているセッションは中断されず、あなたが起動し直すまで古いバージョンのままです。Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI、Gemini CLI のセッションは開き直されます。Cursor CLI と Antigravity CLI のセッションは、あなたが再起動するまで古いバージョンで動き続けます。rdev 1.1.5 以降が必要です。

ほかのモデル:プロバイダーキーとショートカット

エージェントは、ほかのプロバイダーのモデルでも実行できます。同じタブの モデルプロバイダーのキー で キーを追加 を選ぶと、Anthropic、OpenAI、Google Gemini、DeepSeek、Kimi(Moonshot)、GLM(Z.ai)、MiniMax、Qwen(Alibaba)、OpenRouter、Groq、xAI、Mistral の API キーを保存できます。Ollama の場合は、キーの代わりに Ollama サーバーのアドレス(http://… または https://…)を入力します。キーはこのサーバー用にブラウザー内で暗号化されます。パネルがキーを見ることはなく、再表示もできず、どのプロバイダーにキーがあるかだけを把握しています。すでにキーがあるプロバイダーにキーを追加すると、置き換えられます。

キーを設定すると、設定済みのショートカットで、プロジェクト内でそのプロバイダーのモデルを使ってエージェントを起動できます。

ショートカット プロバイダー
claude-deepseek, claude-kimi, claude-glm, claude-minimax, claude-qwen DeepSeek、Kimi、GLM、MiniMax、Qwen モデルで動く Claude Code
codex-deepseek, codex-openrouter, codex-groq, codex-xai, codex-ollama DeepSeek、OpenRouter、Groq、xAI、Ollama モデルで動く Codex
qwen-<provider>(例:qwen-openrouter) ほかのプロバイダーのモデルで動く Qwen Code

カードには、お客様のキーで利用可能になったショートカットが表示されます。Claude 以外のモデルでの Claude Code は Anthropic が公式にサポートしていません。ほとんどのタスクで動作しますが、一部の機能は異なる動作をする場合があります。

共通ルール

すべてのエージェントが従うルールは、AGENTS.md の1か所にまとまっています。Codex、Gemini CLI、opencode はこれを直接読み取り、Claude Code は自身の CLAUDE.md から取り込みます。Claude Code のスキルやフックなど、エージェント固有の部分は、この共通ルールの上に重ねられます。

プロファイルのどこまで使えるかは、プランによって異なります。

  • Single: 基本ルール。
  • Pro: スキル、エージェント、モデルルーティングを含むフルプロファイル。
  • Team: フルプロファイルとチーム共通ルール。

フルプロファイルでは、この環境での Laravel、WordPress、デバッグ、デプロイ用の Claude Code スキルに加え、ビジュアル作業をより高速で低コストなモデルで行いメインセッションは難しい部分を担当する frontend サブエージェント(これがモデルルーティングです)と、変更を終える前に独立したレビューを行う reviewer サブエージェントが追加されます。チームルールは チーム ページで記述します。Single に変更すると、変更していない限り、フルプロファイルのファイルは削除されます。

rdev コマンドガイド

どのプランでも、使用しているコーディングエージェントごとに rdev スキルがインストールされます。これは、どの rdev コマンドまたは rdev MCP ツールがどの作業を担当するかをエージェントに伝える短いガイドです。対象は、プロジェクトの追加と実行、言語・PHP・Node のバージョンのインストール、データベースとサービス、ワーカーと定期タスクの稼働維持、プレビュー、チェックポイント、Git アクセス、バックアップ、デプロイ、エラー追跡、通知、ライセンスです。エージェントは作業に必要になると自分で読み込むので、たとえば「shop に Postgres データベースを追加して」や「blog のキューワーカーを起動して」と頼むだけで済みます。

~/.claude/skills/rdev(Claude Code)と ~/.agents/skills/rdev(Codex、opencode、Qwen Code、GitHub Copilot CLI、Gemini CLI、Cursor)にインストールされ、Antigravity がインストールされている場合は ~/.gemini/config/skills/rdev にもインストールされます。rdev はこれらのファイルを最新に保ちます。ご自身のスキルは別のフォルダーに置いてください。

MCP アクセス

エージェントは、お客様のサイトとデータベースに MCP でアクセスできます。これにより、エージェントは自分でサイトを作成したり、プロジェクトに Redis、データベース、検索、S3 ストレージを追加したり、composer が求めたときに mongodb などの PHP 拡張機能をインストールしたり、データベースを調べたり、キャプチャされたメールを読んだりできます。お客様に依頼する必要はありません。

rdev 0.2.0-beta.34 以降では、エージェントが各プロジェクトの プロセスとスケジュールタスク も管理します。キュージョブを書いた後は、エージェント自身がキューワーカーや Laravel のスケジューラーを設定し、実行コードを変更した後にワーカーを再起動し、プロセスの出力を読み取ります。リクエストが失敗したときは Laravel ログの末尾や最後のエラーを読み取り、チェックポイント(後述)の一覧表示、作成、復元を行い、依頼があれば プレビュー としてサイトを共有し、夜間バックアップが実行されたかをお知らせします。Claude Code は、ほかの MCP ツールと同様に、ツールを初めて使う前に確認を求めます。

ご自身のアカウント

Anthropic または OpenAI のアカウント、あるいは上記のプロバイダーキーをご自身で接続します。エージェントの利用料はそれらのプロバイダーから請求され、rdev のサブスクリプションには含まれません。当社がプロンプトや利用状況を見ることはありません。

24時間稼働するエージェント

プロンプトをエージェントに渡して、サーバーで動かしておきましょう。あなたはノートPCを閉じて、一日を楽しんでください。エージェントはノートPCではなくサーバー上で動くため、何時間もかかる作業も、あなたが離れた後も続きます。

サーバーに SSH でログインするたびに、main という名前の同じ永続セッションが開きます。ノートPCアプリの Terminal on the server、ssh rdev、またはスマートフォンやタブレットの SSH アプリからです。自分で起動する必要はありません(rdev 1.0.1 以降)。

ラップトップアプリでプロジェクトの Open in Terminal を使うか rdev open <プロジェクト> を実行すると、代わりにそのプロジェクト専用の永続セッションが開きます。セッションはプロジェクト名で、そのフォルダーで開始されます。そのため各プロジェクトが自分のウィンドウとエージェントを持ち、別々のプロジェクトを開いている 2 台のデバイスが互いの表示を切り替えることはありません(rdev 1.3.1 以降)。

  1. そのターミナルでエージェントを起動し、タスクを渡します。
  2. 蓋を閉じる、アプリを閉じる、接続が切れるなどしても、エージェントはサーバー上で動き続けます。意図的に離れるには、Ctrl-b を押してから d を押します。
  3. どのデバイスからでも戻れます。再度ログインすれば、中断したところの同じセッションに入れます。パネルの エージェントセッション と通知が、作業の完了やあなたの対応待ちを知らせます。

いくつかのキーが役立ちます。Ctrl-b c で新しいウィンドウを開き(2つ目のエージェント用)、Ctrl-b n と Ctrl-b p でウィンドウを移動でき、マウスやトラックパッドでスクロールもできます。永続セッションをオフにするには、サーバーで rdev session persist off を実行します(on で再びオンになります。rdev 1.0.5 以降)。エディターのリモートターミナル(VS Code、Cursor)とファイル同期は永続セッションを使いません。

セッションが終了したら、claude --continue(選ぶ場合は claude --resume)や codex resume など、エージェント自身のコマンドで同じ会話を続けられます。会話はサーバーのホームフォルダーに保存され、アップデートや再起動後も残ります。

rdev host update は環境を再起動するため、すべてのエージェントと永続セッションが停止します。エージェントが作業中またはあなたの対応待ちの間は待機し、その旨を表示します。rdev host update --force を使うと、それでも更新します。

パネルでのエージェントセッション

パネルの エージェントセッション には、サーバー上の Claude Code と Codex のセッションと、それぞれの状態が一覧表示されます。状態は 作業中、あなたの対応待ち(許可の確認や質問)、完了、エラーで停止 のいずれかです。数秒ごとに更新され、スマートフォンでも使えるので、長いタスクをどこからでも確認できます。対応待ちのセッションが先頭に表示されます。

パネルに届くのは、エージェント、セッション、プロジェクトフォルダーの名前、状態だけです。プロンプト、エージェントの回答、コードが送信されることはありません。セッションは1週間保持されます。Codex は 作業中 と 完了 を報告し、承認の確認はまだ表示されません。

セッションの ⋯ メニューから、実行中のセッションを停止できます。サーバーは数秒以内にエージェントのプロセスを終了します(すでに変更されたファイルは残り、セッション開始時のチェックポイントで元に戻せます。この機能には rdev 0.2.0-beta.36 以降が必要です)。永続ターミナルで動いているセッションには 永続 バッジが表示され、そのメニューの ターミナルウィンドウを閉じる は、エージェントがまだ動作中なら停止し、サーバー上のターミナルウィンドウを閉じます。エージェントが終了した後でも使えます(rdev 1.0.1 以降)。一覧から削除 は1つのセッションを非表示にし、完了分をクリア は完了、失敗、非アクティブのセッションをすべて一度に削除します。再び報告したセッションは戻ってきます。 Webターミナルで開く は、tailnet 上のデバイスからサーバーのWebターミナルでそのターミナルウィンドウを開きます(自分のサーバーのみ、rdev 1.4.5 以降)。ウィンドウがもうない場合は、いつもの永続セッションが開きます。

チェックポイント:エージェントの作業を元に戻す

git プロジェクトでエージェントのターンが始まると、rdev はまずプロジェクトのファイルのチェックポイントを保存します。対象は追跡対象ファイルと新しいファイルで、無視されるファイルは含まれません。これはブランチの外にあるコミットなので、git status、履歴、stash は変わりません。各プロジェクトは直近20個のチェックポイントを保持し、何も変更しなかったターンでは追加されません。

各ターン前の自動チェックポイントはエージェントのフックから作られるため、Claude Code、Codex、opencode、Qwen Code、GitHub Copilot CLI、Gemini CLI では自動で保存されます。Cursor CLI と Antigravity CLI にはこのフックがないため、rdev 経由で起動したときに保存されます。この場合、セッションもパネルに表示され、終了時に通知が届きます。

rdev agents run cursor

Antigravity CLI では rdev agents run antigravity を使います。

元に戻すには、パネルでサーバーを開いて 元に戻して復元 からチェックポイントを選ぶか、サーバー上で操作します。プロジェクトのチェックポイントを一覧表示します。

rdev checkpoint list

次に、ID を指定して復元します。

rdev checkpoint restore 1793603600

復元するとファイルが元の状態に戻り、それ以降に追加されたファイルは削除されます。現在の状態は先に新しいチェックポイントとして保存される(最新のものと同じ場合を除く)ため、復元も元に戻せます。rdev checkpoint create で手動で保存することもできます。チェックポイントには rdev 0.2.0-beta.16 以降が必要です。