クイックスタート
クイックスタート

ゼロから自分だけのアプリを作りましょう

コードを書いたことがない人のための、ステップバイステップガイド。

普通の言葉でタスクを説明するだけで、AIがアプリを組み立て、保護されたサーバーに自分でデプロイします。

バイブコーディングとは

タスクを言葉でAIに説明することでソフトウェアを作る方法です——手作業でコードを書く代わりに。プログラムを書くのはAIです。あなたは方向性を示し、結果を確認して調整します。

プログラミングの知識は不要

コードを書くのはAIです。あなたに必要なのは、新しい同僚に説明するような、わかりやすいタスクの説明だけです。

わかりやすい言葉で説明する

何をすべきか、誰のためか、どんなデータを使うか、何が成果とみなされるか。具体的であるほど良い結果になります。

AIがすべて展開してくれます

AIがコードを書き、サーバーを作成し、アプリを公開します。あなたは確認して調整するだけです。

バイブコーディングとは

ドキュメントとヘルプ

2種類のドキュメントがあります:1つは自分で理解するため、もう1つはAIモデルに渡すためのものです。

人間向けガイド

各ステップの例付きの、詳細なガイドと完全なAPIリファレンスです。

AIモデル向けドキュメント

APIの完全なドキュメントです。モデルにそのリンクを渡すか、あるいは単に/v1/meをプロンプトに入れるだけで、AIが自分の権限と機能を学習します。

ステップ1. ツールを選ぶ

アプリはバイブコーディング向けのツール——ファイルを書いてコマンドを実行できるAI——の中で組み立てられます。通常のチャット(Web版ChatGPTなど)では対応できません。

Claude CodeCodex
バイブコーディング用ツール

Claude Code、Codex、Antigravity、Cursor——開発者向けのツールです。自分のアカウントとインストールが必要です。以下の手順はこの方法向けです。

ステップ2. 最初のアプリを組み立てる

詳しい手順です——順を追って、そのまま進めてください。

  1. 1
    自分のBitrix24でサインインする

    プラットフォームを開き、「Bitrix24でサインイン」をクリックしてください。認証(QRコードでも可)を行い、リストから該当するアカウントを選んでください。

  2. 2
    キー作成画面を開く

    キーとは、アプリがあなたのBitrix24を操作するための通行証です。作成方法は2通りあります:

    • ダッシュボードの「APIキーを作成」ボタンから。
    • または「APIキー」セクション(左のサイドバー)の「キーを作成」ボタンから。
  3. 3
    キーの設定項目を入力する

    「APIキーを作成」ダイアログで、以下を設定します:

    • キー名——後で他のキーと区別できるように(例:「商談ダイジェスト」)。
    • アクセスモード——アプリがデータを表示するだけなら「読み取り専用」、それ以外は「読み取りと書き込み」。
    • 権限——デフォルトではすべて選択されています。アプリに必要なものだけ残してください。
    • 有効期限——「無制限」、30日/90日/180日、または1年。
    • 必要に応じて「詳細設定」:許可するIPアドレスと1分あたりのリクエスト上限。
  4. 4
    キーを作成してプロンプトをコピーする

    「作成」をクリックします。キーは一度だけ表示されます——すぐに「プロンプトをコピー」(すでにキーが入った定型文)または「キーをコピー」をクリックしてください。

  5. 5
    プロンプトをAIに貼り付ける

    Claude CodeまたはCodexを開き、コピーしたプロンプトを貼り付けて、必要なアプリの内容を普通の言葉で書き足してください。プロンプトの例は以下をご覧ください。

  6. 6
    AIに組み立てと公開を任せる

    AIがコードを書き、Black Holeサーバーを作成し、アプリをデプロイします。権限が足りない場合は、何を追加すべきか教えてくれます——キーの編集画面に戻ってください。

  7. 7
    完成したアプリを開く

    「Black Holeサーバー」セクションに移動し、自分のサーバーを見つけて「開く」をクリックしてください。埋め込みが設定されていれば、アプリはBitrix24の中に直接表示されます——メニュー、CRMのカード、タスク、チャットなど。

プロンプトはこのようになります
Vibecodeプラットフォーム用の私のAPIキー: vibe_api_xxxxxxxxxxxx

ドキュメント: https://vibecode.bitrix24.com/v1/me

[アプリの説明]というアプリを作ってサーバーにデプロイして
APIキー
vibe_api_

自分専用、アプリ1つ用です。あなたの代わりに動作し、誰もが同じデータを見ます。「APIキー」セクションで作成します。

認証キー
vibe_app_

チームでアプリを使う場合や、Bitrix24内に埋め込む必要がある場合に使います。従業員ごとに個別の権限があります。「認証キー」セクションです。

キーは一度だけ表示されます。 もう一度見ることはできません——すぐにコピーしてください。紛失した、またはうっかりウィンドウを閉じてしまった場合は、新しいキーを作成して古いキーを失効させてください。

理想の結果を得るために、AIに何をしてほしいかをどう伝えるか

AIを新しい同僚のように扱いましょう:背景を伝え、アイデアを話し合い、できあがったものを確認する。わかりやすく説明するほど、最初の結果が理想に近づきます。

具体的に伝える

何をすべきか、誰のためか、どんなデータを使うか、何が成果とみなされるか。「週別のダッシュボード」のように、単に「ダッシュボード」ではなく。

まずアイデアを話し合う

コードを依頼する前に、プログラマーとしてではなくプロダクトマネージャーとして、普通の言葉でAIとアイデアを話し合いましょう。そしてモデルに質問をするよう促してください——1つの質問が将来のバグを1つ防ぎます。

分割して確認する

「一気に全部」ではなく、小さなステップで「プロンプト→確認→調整」のループを回しましょう。プロジェクト全体を書き直すのではなく、ピンポイントで修正してください。

避けたほうがいいこと

  • 曖昧すぎるリクエスト——AIが見当違いの方向に進んでしまいます。
  • 1回のプロンプトで完璧な結果を期待すること——これは反復的なプロセスです。
  • サンプルデータで検証せずにコードを受け入れること。
  • ピンポイントの修正ではなく、プロジェクト全体を一度に書き直すこと。
  • 実際の顧客データをプロンプトの文章やスクリーンショットに貼り付けること。

良いプロンプトの例

アプリに必要なことをすべて盛り込んだ1つの段落

「営業チーム向けの商談ダイジェストアプリを作って。毎朝9時に、昨日分のサマリーをチャットで責任者に送って:新規商談の合計金額、売上トップ5の営業担当者、タスクのない商談、7日以上停滞している商談。データはCRMの『Sales』パイプラインから取得して。金額は前日比の差分付きで。新規商談がなかった場合は『昨日は商談がありませんでした』と短く送って。『今すぐ更新』ボタンを追加して。サーバーにデプロイしてリンクを送って。」

ここにはすべてが揃っています:どんなアプリか、誰のためか、いつ動くか、どんなデータをどんな形で使うか、例外ケース、そして最後の仕上げ——デプロイ。この段落が具体的であるほど、最初の結果が理想に近づきます。

公開後

最初のアプリはゴールではありません。改善も、Bitrix24への埋め込みも、修正がうまくいかなかった場合のロールバックも簡単です。

対話しながら改善する

AIのところに戻り、普通の言葉で修正内容を説明してください——コードを変更し、アプリを再公開します。

Bitrix24に埋め込む

使いやすい場所にアプリを表示しましょう:メニュー、CRMのカード、タスク、チャット——埋め込み位置を選べます。

バージョンに戻す

プラットフォームは公開のたびにコードのバージョンを保存します(「アプリのソース」セクション)。修正で何かが壊れたら、以前のバージョンを再公開できます。

管理画面にあるその他の機能

最初のアプリに慣れてきたら、管理画面にはまだまだ役立つ機能があります。各セクションは「使用する」ボタンでAIにすぐ使えるコードを渡します。

ダッシュボード

サインイン後の起点となる画面:残高、本日のリクエスト数、成功率、各セクションへのクイックアクセス。

分析

アプリの呼び出し状況:リクエスト数、成功率、エラーの発生箇所。実際の呼び出しが発生してから表示されます——デプロイ直後は空でも正常です。

請求

残高、チャージ、課金履歴。サーバーと高性能AIモデルはクレジットを消費し、残高がゼロになると停止します。

ボット

Bitrix24メッセンジャー向けのチャットボット——メッセージに返信し、アカウントのイベントに反応します。

AIエージェント

Bitrix24内で動作する、すぐ使えるAI社員ボット(「エージェント」セクション)。アクセスはリクエストに応じて付与されます。

ストレージ

アプリ用のファイルストレージ——従量課金、キーごとに分離。「ストレージ」セクション。

Connect

外部サービスとの接続:プラットフォームが通常の失効可能なキーを発行します。自分が開始したサインインだけを承認してください。

バックアップ

サーバーバックアップ:ディスク全体のスナップショットを取得し、新しいサーバーへ復元できます。設定から有効化します。

Galaxy

高密度ホスティング——1台のサーバーに複数のアプリ。ソリューションをスケールさせたい方向けです。

チームでの作業とアクセス権限

Bitrix24アカウントの管理者であれば、プラットフォーム上で誰が何をできるかを設定できます。

誰がサインインし、誰が作成するか

これは2つの別々の設定です:管理画面へのアクセス(サインイン)と、キー・サーバー・ボットを作成する権限。それぞれ個別に設定します。

ユーザーごとの上限

1人の従業員が作成できるキー、サーバー、ボットの数——アカウント管理者が設定します。

監査と申請

操作ログ(誰が、いつ、どこから)と、従業員からのアクセス申請の処理——管理者用セクションにあります。

何かの操作に「権限がない」場合、おそらく管理者がそう設定しています。管理者に連絡するか、管理画面から直接アクセス申請を送ってください。

セキュリティ

いくつかのシンプルなルールが、あなたと顧客のデータを守ります。ここでは主な3つを紹介します——詳しい内容はセキュリティのページをご覧ください。

二要素認証でのサインイン

この1つのステップで、アカウント乗っ取りの試みの99%を防げます。1分で有効にできます。

単一のキー——金庫の鍵のようなもの

これはあなたがアクセスできるすべてを開いてしまいます。コードに書いたり、チャットで転送したりしないでください。

公開モード——理解した上で使う

これはサインインなしでインターネットからのフルアクセスを許可するものです。影響を理解していない場合は有効にしないでください。

AIにアプリのレビューを依頼する

アプリが完成したら、生成されたコードに脆弱性がないかAIに確認してもらいましょう(できれば新しいセッションで「まっさらな視点」から)。デプロイ後にもう一度確認してください——開発時にはなかったリスクが本番環境で表面化することがあります。

セキュリティ

これはまだ最重要ポイントに過ぎません

セキュリティは真剣に扱うべき問題です。実際のデータで本番運用を始める前に、必ずセキュリティの全ページを読んでください:外部のAIが何を見るか、キーやサーバーの仕組み、そして独立したAI監査でコードを確認する方法について解説しています。

最初のアプリを作る準備はできましたか?

自分のBitrix24でサインインして、普通の言葉でAIにタスクを説明しましょう。