https://shogakusei.com/series/convex/Convex（コンベックス）は、クエリがデータベースの中で動く TypeScript のコードである、オープンソースのリアクティブなデータベース。倉庫の中に作業場まで入っていて、注文の処理まで倉庫の中で済ませる「作業場まで中に入っている倉庫」です。SQLは書きません。データが変わると向こうから教えに来て、書きこみの関数はまるごとが1つのトランザクション。AIに書かせても壊れにくい土台です。パソコンとつないで2つの画面を同時に動かす回、AIエージェントに書かせる回、4つの命令、表の設計、ログイン、ファイルと検索、時間で動かす仕組み、アプリにAIを入れる回、本番とお金までを1話ずつやっていきます。13歳未満は使えません。そして、無料には止まるほうと止まりにくいほうがあります。ja https://shogakusei.com/series/convex/ep09/https://shogakusei.com/series/convex/ep09/Sun, 11 Oct 2026 14:34:04 GMT自分のアプリに AI の返事を入れたくて、公式の説明書の例をそのまま写した。それなのに、無料の Free プランのままでは英語のエラーで断られて、先へ進めない。Convex で、会話の履歴が自動で残る仕組みを、まず鍵もお金も使わずに動かします。そのあと、自分の鍵で本物の AI（Claude）につなぎ、AI が前の発言を読んで答えるのを確かめます。 AI を呼ぶ道は、有料プランからの AI Gateway と、Free でも通れる自分の鍵の2つ。Agent の部品を入れ、鍵の要らないにせのモデルで、会話の箱を作る・続ける・履歴が保存されるまでを動かしました。そのあと自分の鍵で Claude を端末から呼ぶと、2通目に1通目を読んだ答えが返り、入力は42から97に増えています。制作の9回は計算で約0.0003ドル。お金がかかる所と止め方を「AIの鍵とお金の線」にまとめます。 https://shogakusei.com/series/convex/ep08/https://shogakusei.com/series/convex/ep08/Sun, 11 Oct 2026 12:17:36 GMT毎朝7時に動くように書いたつもりの処理が、なぜか夕方の4時に動いている。決まった時刻にアプリを動かそうとすると、起こりやすいずれです。Convex の「5秒後に1回だけ動く予約」と「決まった時刻のくり返し」を、自分のパソコンで動かします。日本の朝7時台にするには数字をどう書くのか、予約は失敗したらやり直されるのか、止めたいときはどこを消すのかを確かめます。 外の API を呼ぶ命令と、5秒後に自分から消えるメッセージをチャットに足し、1分ごとのくり返しで動きを見てから、日本の朝7時台に毎日動く形を書きました。時刻は UTC なので、朝7時台は hourUTC: 22（前の日）。公式が「ちょうど1回」と約束するのは予約された書く命令だけで、外に出る命令は失敗したままやり直されませんでした。練習の1分ごとは消し、にせの鍵を環境変数に入れて読み、「時刻の早見」を1枚作ります。 https://shogakusei.com/series/convex/ep07/https://shogakusei.com/series/convex/ep07/Sun, 11 Oct 2026 10:25:46 GMTメモのアプリに検索の窓を付けて、「柴犬」と打つ。「今日は柴犬と公園を散歩しました」と書いたメモがあるのに、結果は空のまま。エラーは1行も出ていない。日本語でアプリを作る人が、検索を付けた日に出会いやすい場面です。Convex に画像を置く手順と、言葉で探す検索の作り方を、実際に動かした結果と一緒にまとめます。 画像を3段（URLをもらう、送る、番号を表に書く）で置くと、もう片方の画面にリロードなしで出ました。URL を知っている人はだれでも開け、ファイルと行は別々なので、消すときは両方。言葉で探す検索（全文検索）は、文を空白と句読点で語に切る作りで、空白のない日本語の文は途中の言葉では当たらず、11文字以上つながった部分はエラーなしで検索の対象から外れました。区切った言葉を探す欄に入れる対処と、ベクトル検索の入口も見ています。 https://shogakusei.com/series/convex/ep06/https://shogakusei.com/series/convex/ep06/Sun, 11 Oct 2026 08:32:13 GMTログインした人にだけ見せたいページを作り、ログインしていない人には、一覧もボタンも出ないようにした。これで守れた、と思っていないでしょうか。自分で書いたアプリでも、AIに書かせたアプリでも、画面で隠しただけのデータは、画面を通さずに読めることがあります。Convex の公式のひな形でログインを動かします。 練習用の新しいフォルダに公式のひな形を取り、Windows の2か所（package.json の dev の行と、空ぶりした準備のコマンド）を直して、Convex Auth（beta）のメールアドレスとパスワードでログインを動かしました。ログインなしのまま外から命令を呼ぶと、数字が読めて書けます。命令の先頭に5行足すと Not authenticated で断られました。auth.config.ts のつまずき、方法の選び方、人に使ってもらう前に足りないものも確かめています。 https://shogakusei.com/series/convex/ep05/https://shogakusei.com/series/convex/ep05/Sun, 11 Oct 2026 06:59:36 GMT数が入るはずの欄に、「three」という文字が1件だけまざっていた。合計を出そうとして初めて気づき、いつ、どこから入ったのかもわからない。自分で書いたアプリでも、AIに書かせたアプリでも、表の形を決めていなければ起こることです。Convex の表に「設計図」を書いて、形の合わないデータを入口で断らせます。 convex/schema.ts に設計図を書くと、冊数の欄に「three」が入った1件で押し上げが止まりました。Path と Value を読んでデータを直すと通り、そのあとは設計図に無い欄の書きこみが、実行のときにも型の検査でも断られます。索引は、書いて withIndex で名指しして、はじめて使われるもの。欄をあとから足すときは、任意で足す、埋める、必須にする、の3段です。書き出しと取りこみ（beta）も試し、「表の設計メモ」にまとめます。 https://shogakusei.com/series/convex/ep04/https://shogakusei.com/series/convex/ep04/Sun, 11 Oct 2026 03:13:56 GMTAI に書いてもらったアプリが、手元では問題なく動いている。けれど、最後の1個の在庫に2人が同時に注文したらどうなるのかは、一度も試したことがない。そんな人に向けた回です。Convex の4つの命令を1つずつ書いて動かし、在庫1個の商品に16本の注文を同時に流します。 読む・書く・外に出る・窓口の4つの命令を1つずつ書いて動かし、在庫1個に16本の注文を同時に流しました。読んで、確かめて、書く所までを1つの書く命令にまとめた形は、10回とも売上1件。外に出る命令で読んでから別の書く命令で減らす、分けた形は、7回とも売れすぎでした。やり直しは console.log の行数で見え、同じ1件に何百本も書くと一部ははっきり断られます。結果は「同時16本の記録」に書きとめます。 https://shogakusei.com/series/convex/ep03/https://shogakusei.com/series/convex/ep03/Sun, 11 Oct 2026 01:29:00 GMTAI にコードを頼んだら、もっともらしいものが返ってきた。けれど、それが今の正しい書き方なのか、自分では見分けがつかない。しかも、AI にどこまで触らせてよいのかを決めないまま、許可のボタンを押している。Convex の公式が配っている「AI 向けのファイル」を、自分のフォルダに入れます。 コマンド1つで AI 向けのファイル（guidelines.md・AGENTS.md・CLAUDE.md とスキル33個）を入れ、外し方も確かめました。MCP サーバーの道具は12個。書く命令を動かすことも、環境変数を値まで読むことも通り、クラウドでは入口の道具を1回呼んだあとに本番の置き場が1つ増えていました。AI が自分で打つコマンドはログインの全部の権限で動くと知ったうえで、触らせる範囲と頼み方を「AIへの約束メモ」にまとめます。 https://shogakusei.com/series/convex/ep02/https://shogakusei.com/series/convex/ep02/Sat, 10 Oct 2026 23:25:16 GMT説明のとおりにコマンドを打ったのに、英語のエラーが1行出て、そこで手が止まった。黒い画面（ターミナル）を初めて開く人が、いちばん出会いやすい場面です。Convex の公式の練習用チャットを、自分のパソコンで動かします。Windows で実際に出たエラーと直し方、2つの画面が同時に変わるのを確かめる方法をまとめました。 Node.js と Git を確かめ、公式の練習用チャットを自分のパソコンに取ってきました。Windows では package.json の1行を直してから npm run dev。アカウントなしの手元だけの置き場で起動し、命令を2つ書いて画面とつなぐと、片方の窓で送った文が、リロードなしでもう片方に出ました。止め方と残るもの、ログインしてクラウドにつなぐ道、紐づけはデータの引っ越しではなさそうなことも確かめています。 https://shogakusei.com/series/convex/ep01/https://shogakusei.com/series/convex/ep01/Tue, 29 Sep 2026 10:23:28 GMTAIに書かせたアプリは動いたのに、入れたデータがリロードするたびに消えてしまう。そんな人に向けた記事です。パソコンに何も入れず、ブラウザだけで、インターネット上に自分のデータ置き場を1つ作ります。SQLは書きません。無料の範囲で止まるところと、あとから変えられない設定も、始める前に確かめます。 Convex は、作業場まで中に入っている倉庫のようなデータベースです。できることを5フロア21部屋の地図にし、ブラウザだけでプロジェクトと置き場を作り、表1つにデータを入れて、Add filter で取り出しました。無料には止まるほう（Free）と止まりにくいほう（Starter）があり、使った量はチーム単位で合計。リージョンは後から変えられず、日本はありません。