AI開発 · 2026.11.20

Onlookで何が変わる?実コードをAIで直す5項目デザインチェック

Onlookで何が変わる?実コードをAIで直す5項目デザインチェック

Onlookは、デザイナーが実際のGitリポジトリをキャンバス上で見ながら、Claude CodeやChatGPT/Codexなど自社で契約済みのエージェントにコード編集を任せられるオープンソースのAIデザインツールです。Figma風の見た目だけで完結せず、ローカルのdev serverで動く本物のアプリを対象にするため、AI導入担当者は「デザイン案を作る」よりも「実装とレビューをどう安全に短縮するか」を見るべきです。まずは5項目で、対象リポジトリ、権限、レビュー、export、分析データの扱いを確認しましょう。

Onlookとは?実コードをAIで直すデザインキャンバス

OnlookはGitHubで公開されているApache 2.0のオープンソースプロジェクトで、公式READMEでは「open-source developer tool for designers」「AI-first design tool」と説明されています。特徴は、静的なモックを作るのではなく、手元のGit repositoryを開き、そのプロジェクトのdev serverを起動して、実際に動く画面をキャンバス上に並べられる点です。

この設計は、デザイナー、フロントエンドエンジニア、AIエージェント担当者の間にある「Figmaでは良いが実装で崩れる」というズレを減らします。Onlook上で画面サイズや状態を見比べ、要素を選んでinline chatから変更を依頼し、Git差分として確認する流れに寄せられるためです。

5項目チェック:導入前に見るべきポイント

1つ目は対象リポジトリです。Onlookは任意のGit repositoryを開き、既存のdev serverで表示できるWeb frameworkなら基本的に扱えます。2つ目はAIアカウントです。公式説明では自前のClaude CodeまたはChatGPT/Codexアカウントを接続し、Onlook自体が独自モデルを提供する構成ではありません。

3つ目は変更の安全性です。公式READMEにはsafe worktree copyが挙げられており、作業フォルダを直接壊さずに試せる設計が示されています。4つ目は成果物の受け渡しです。HTML、PDF、PNG、JPEGとしてexportできるため、Slackやレビュー資料への共有に向きます。5つ目は利用データです。公式downloadではusage analyticsが既定で有効、source buildでは最初に確認され、STUDIO_TELEMETRY=0で無効化できるとされています。

AI導入チームで効く理由:モックからPRまでを近づける

AI導入の現場では、プロンプトでUI案を作れても、最終的に既存コードへ統合するところで手戻りが起きます。Onlookは「実アプリを見ながら、エージェントが実ファイルを編集する」ため、生成物をもう一度作り直す工程を短くできます。特にLP、管理画面、入力フォーム、料金ページのように視覚確認と細かな文言調整が多い画面で効果が出やすいです。

ただし、これはレビュー不要という意味ではありません。AIが編集したCSS、状態管理、アクセシビリティ、レスポンシブ崩れ、不要な依存追加は、人間がGit diffと画面確認で見る必要があります。Onlookを導入するなら、最初から「AIが作る場所」と「人間が承認する場所」を分けておくのが安全です。

30日PoCの進め方:1リポジトリ、3画面、10変更から始める

最初の30日は、1つのWebリポジトリに限定し、3画面だけを対象にするのが現実的です。例として、トップページ、問い合わせ導線、ダッシュボードの空状態を選び、各画面で10件以内の小さな変更をOnlook経由で依頼します。評価軸は、初稿までの時間、レビューで差し戻した件数、最終PRまでに人間が直した行数、デザイナーと開発者の往復回数です。

PoCではmacOS環境を前提に始めるのが無難です。公式READMEではmacOS向けdesktop appが推奨され、Windowsはwaitlist、Linuxはartifact未公開とされています。全社展開を急がず、まずはmacOS利用者の小さなチームで運用手順とレビュー基準を固めるほうが失敗しにくいです。

リスクと管理:ローカルファーストでも権限設計は必要

Onlookはdesktop appでlocal-firstと説明され、source buildではOnlookアカウント、cloud keys、.envなしで動かせるとされています。この点は、機密コードを外部SaaSに全面アップロードしたくないチームにとって魅力です。一方で、接続するClaude CodeやChatGPT/Codex、MCP connector、ローカルシェル、GitHub操作の権限は別問題です。

導入時は、対象リポジトリを限定し、秘密情報を含む.envを読み込ませない、PR作成前に必ず差分レビューを挟む、agentに許可するコマンドを記録する、analytics設定を明文化する、という5点を最低ラインにしてください。ローカルで動くから安全、と短絡しないことが重要です。

FAQ:OnlookはFigmaやv0の代替になる?

完全な置き換えというより、実装に近いデザイン検証ツールとして見るのが自然です。公式READMEでもFigma、v0、Replit Agent、Webflowなどのopen-source alternativeと表現されていますが、強みは「本物のリポジトリ」「本物のdev server」「自社のAI agent」を同じキャンバスに寄せる点です。

非エンジニアだけで本番反映まで完了できるかというと、現時点では慎重に見るべきです。Git、dev server、依存関係、PRレビューの理解が必要になるため、デザイナー単独よりも、フロントエンド担当とAI導入担当が一緒に運用ルールを作るほうが向いています。

まとめ:Onlookは誰が試すべきか

Onlookを試す価値が高いのは、AIでUI案は出せているのに、既存コードへ戻す工程で遅くなっているチームです。特に、デザイナーがコードに近づきたい、フロントエンドの小変更が詰まっている、AIエージェントのPR品質を画面で確認したい、という組織に合います。

HelloCraftAIでは、AIエージェント導入、UI改善PoC、社内AIツールのレビュー設計までまとめて相談できます。Onlookのような実コード編集型ツールを安全に試したい場合は、導入範囲と30日PoCの設計から一緒に整理します。