コンテンツにスキップ
Keelson
コンソール →
公式サイト →
AI に聞くなら、この URL を貼る https://keelson.dev/ja/llms.txt

クイックスタート

小さなサンプルアプリを Keelson にデプロイし、ブラウザで開き、ログインしていない人には開けないことを確認します。

  • できること: 自分のワークスペースに最初のアプリが作成され、専用 URL とログイン保護が付く
  • 所要時間: 15 分ほど。ビルドの待ち時間が大半です
  • 必要なもの: Keelson のアカウント、ターミナル、Claude Code / Codex / Cursor のいずれか。外部サービスの API キーは要りません
  • 完了条件: 発行された URL を自分のブラウザで開くと挨拶の画面が出て、シークレットウィンドウで開くとログイン画面になる

Keelson のアカウントがまだ無い方は、console.keelson.dev からサインアップしてください。

1. CLI を入れてログインする

Section titled “1. CLI を入れてログインする”

Keelson CLI は、ターミナルからログインやデプロイを行うためのツールです。使っている OS のタブを選び、次のコマンドでインストールしてください。

Terminal window
curl -fsSL https://keelson.dev/install.sh | sh
keelson コマンドが見つからない場合

インストーラーは、コマンドを探す場所（PATH）を変更しません。次の行を ~/.zshrc や ~/.bashrc に追加し、ターミナルを開き直してください。

Terminal window
export PATH="$HOME/.keelson/bin:$PATH"

続けてログインします。ブラウザが開くので、Keelson のアカウントでログインしてください。

Terminal window
keelson login

2. サンプルアプリをダウンロードする

Section titled “2. サンプルアプリをダウンロードする”
  1. サンプルアプリをダウンロード（ZIP）します。
  2. ZIP を展開します。
  3. 展開した keelson-hello フォルダを Claude Code / Codex / Cursor で開きます。
サンプルの中身を見る
main.py
from html import escape


from fastapi import FastAPI, Request
from fastapi.responses import HTMLResponse


app = FastAPI()


@app.get("/", response_class=HTMLResponse)
def index(request: Request):
    email = escape(request.headers.get("X-Keelson-User-Email") or "ゲスト")
    return f"""
    <!doctype html>
    <html lang="ja"><body style="font-family: sans-serif; padding: 2rem">
      <h1>こんにちは、{email} さん</h1>
      <p>このアプリは Keelson で動いています。</p>
    </body></html>
    """
requirements.txt
fastapi
uvicorn
keelson.yaml
slug: hello
runtime: python-slim
command: "uvicorn main:app --host 0.0.0.0 --port $PORT"
db:
  mode: none

このアプリは、Keelson が付けるヘッダーからログイン中のユーザーのメールアドレスを読んで表示します。認証のコードは 1 行もありません。

3. AI エージェントに Skill を入れる

Section titled “3. AI エージェントに Skill を入れる”

Skill は、AI エージェントに Keelson のデプロイ手順を教えるものです。Keelson CLI に同梱されています。展開した keelson-hello フォルダでターミナルを開き、使っているエージェントに合わせて 1 回実行します。

Terminal window
keelson install-agent claude-code --global

--global を付けない場合、いま開いているプロジェクトにだけ入ります。

配置先や更新方法は CLI コマンドを参照してください。

4. デプロイを依頼する

Section titled “4. デプロイを依頼する”

エージェントのチャットに次のように依頼します。

このアプリを Keelson にデプロイして

エージェントがデプロイを実行し、完了まで待ちます。初回は数分かかります。完了すると、次のようなアプリの URL が表示されます。

https://<ワークスペース>--hello.keelson.run

エージェントを使わない場合は、フォルダで keelson deploy --new を実行しても同じです。

公開 URL はアプリの作成時に発行されるため、URL が表示されただけではデプロイ成功の証拠にはなりません。画面のない環境では、デプロイの完了前にコマンドが終了し、その後デプロイが失敗することもあります。URL を開く前に、デプロイ時に表示された ID で状態を確認してください。

Terminal window
keelson status <deploy-id>

失敗している場合は、このコマンドで理由と次に必要な操作を確認できます。

5. 確認する

Section titled “5. 確認する”
  1. URL を自分のブラウザで開きます。「こんにちは、… さん」と本文が表示されれば成功です。「ゲスト」と表示されても、未ログインという意味ではありません。ログイン方法によってメールアドレスを取得できない場合に表示されます
  2. 同じ URL をシークレットウィンドウで開きます。Keelson のログイン画面になり、アプリは表示されません

これで、専用 URL とログイン保護が付いたアプリを利用できます。デプロイしたアプリは Keelson コンソールにも表示されます。

次のステップ

Section titled “次のステップ”