UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK は、Vercel が 2026 年 11 月 12 日に公開した Agent 向けの振る舞い(behaviors)ライブラリで、バージョンは 0.1.0-beta.1 です。振る舞いはフレームワーク非依存の @ui-sdk/core にあり、React、Vue、Svelte、Solid、Web Components のアダプターが描画します。公式ドキュメントに沿って「何か」「どう入れるか」「Claude Code / Codex / Cursor に skill をどう渡すか」を整理し、テスト機で実際に走ったコマンド、所要時間、出力を記録します。

12 分钟阅读
UI SDK とは何か、どう使うか?Vercel と shadcn が Agent 向けに出した振る舞いライブラリを、Claude Code / Codex / Cursor でインストールして実測する(0.1.0-beta.1)

UI SDK は、コーディング Agent 向けの振る舞い(behaviors)ライブラリです。公式リポジトリの README と ドキュメント によれば、キーボード操作、フォーカス、選択、閉じる/dismiss、ポップアップ、ドラッグ&ドロップ、そしてそれらに必要な ARIA は、フレームワーク非依存の TypeScript コアパッケージ @ui-sdk/core にあります。アダプターが @ui-sdk/react、@ui-sdk/vue、@ui-sdk/svelte、@ui-sdk/solid、@ui-sdk/web として各フレームワークに描画します。モデル API ではなく、見た目も決めません。同梱コンポーネントも、definePrimitive で組み立てる部品もスタイルなしで、provider もポータルもありません。

@vercel は 2026 年 11 月 12 日 18:41 UTC(Asia/Shanghai では 11 月 13 日 02:41)に「Introducing the UI SDK.」と発表しました。同じ時間帯に @shadcn が設計方針を説明し、@rauchg は「the x86 instruction set for agents」になぞらえました。ドキュメントは ui-sdk.dev、ソースは vercel-labs/ui です。npm 上の @ui-sdk/core、@ui-sdk/react、その他のフレームワーク用パッケージの最新は現在 0.1.0-beta.1 で、ライセンスは Apache-2.0 です。

2026 年 11 月 13 日(Asia/Shanghai、UTC+8)、Debian 13 x86_64 のマシンで Node.js v24.22.2、npm 11.19.1、React 19.3.1 を使って実測しました。npm install @ui-sdk/react @ui-sdk/core で入ったのは 0.1.0-beta.1 です。公式 README の search-field 例を最小の Vite + React プロジェクトに書き込み、npm run build(tsc -b && vite build)は成功しました。続けて npx skills add vercel-labs/ui --skill ui-sdk を実行し、Claude Code 2.1.319 と Codex CLI 0.167.0 に、本サイトの API と skill を使ってそれぞれ五段階評価コンポーネントを生成させました。今回、Cursor の Agent タスクは実行していません。以下のバージョン、コマンド、所要時間、出力は、この実行から取っています。

Create API Key →

先に結論

問い答え
UI SDK とは?Agent 向けの振る舞いライブラリです。インタラクションと ARIA は @ui-sdk/core にあり、各フレームワークのアダプターが描画します。
現在のバージョンnpm 0.1.0-beta.1(2026 年 11 月 12 日公開、Apache-2.0)。React アダプターの peer 依存は React 19+ です。
どう入れるかReact では npm install @ui-sdk/react @ui-sdk/core。他のフレームワークでは @ui-sdk/react を対応パッケージに差し替えます。
Agent にどう渡すかnpx skills add vercel-labs/ui --skill ui-sdk を実行し、公式の説明どおり AGENTS.md を更新して、node_modules/@ui-sdk/react/docs/llms.txt などの同梱ドキュメントを指します。
自分でコンポーネントを書くにはdefinePrimitive で behaviors を組み合わせ、createParts で各フレームワークに描画します。公式の案内例には search-field、ミュートボタン、reactions bar があります。
既製コンポーネントは?@ui-sdk/react は Select、Dialog、Tabs、Rating なども提供します。スタイルなしで、provider もポータルも不要です。
今回の実行インストールは約 0.8 秒。公式 search-field のビルドは約 0.9 秒で成功。skill の追加は約 6.7 秒。Claude Code は約 65 秒、Codex は約 71 秒で評価コンポーネントを生成し、どちらもビルドは成功、Codex のテスト 2 件も成功しました。
注意点現在は beta で、Vercel の public beta 条項の対象です。公式ドキュメントは API がまだ変わる可能性があると書いています。

UI SDK とは何か

公式ドキュメント と README によれば、UI SDK は見た目付きのコンポーネント集ではありません。「インターフェースがどう動くか」を組み合わせ可能な振る舞いとして書き、人または Agent がそれを使ってコンポーネントを組み立てます。同じ primitive を React、Vue、Svelte、Solid、Web Components に描画できます。

@shadcn によれば、Agent はインターフェースの作り手と使い手の両方になりつつあるため、抽象は振る舞いの層に置くべきです。たとえば Select にはポップアップ、選択ロジック、キーボード操作、フォーカス管理があり、同じ部品は他のコンポーネントにも繰り返し現れます。それらを切り出し、テストし、再利用できるようにした結果、振る舞いはフレームワークやレンダラー、harness が変わっても同じです。目標は、必要なインターフェースを、まだ思い至っていないものも含めて、Agent が生成できるようにすることだと書かれています(原文は「we haven't thought of yet」)。

@rauchg の比喩では、UI SDK は新しい UI コンポーネントをその場で組み立てるための「the x86 instruction set for agents」です。

公式ドキュメントは次の二つの道を並行して示しています。

  • 自分で振る舞いを組む:definePrimitive で部品、状態、アクションを定義し、createParts で描画します。リポジトリの案内例は search-field です。ドキュメントにはミュートボタンと、Build a Component の reactions bar もあります。
  • 既製コンポーネントを使う:@ui-sdk/react はコンポーネントごとにエントリを分けてエクスポートします。例は @ui-sdk/react/button、@ui-sdk/react/dialog、@ui-sdk/react/tabs、@ui-sdk/react/rating です。公式は @ui-sdk/react のルートからの一括 import はないと明記しています。コンポーネントはスタイルなし、依存なし、provider なし、ポータルなしで、CSS や Tailwind は自分で足します。

すでに描画されたページを Agent に操作させるには、createAgent() でコンポーネントの状態を読み、actions を呼び出せます。API は Agents にあります。公式 Agents ドキュメントには project-settings の比較実験もあります(各手法 3 回の中央値、どちらも Sonnet を Claude Code 経由で使用、すべて完了)。ブラウザツールはツール呼び出し 16 回、所要 41 秒。ui-sdk の agent bridge はツール呼び出し 5 回、所要 16 秒です。これは公式実験の数字であり、私たちが再測定したものではありません。

UI SDK は現在 beta です。ドキュメントサイトには「UI SDK is in beta, so some APIs may still change.」とあります。利用は Vercel Public Beta Agreement の対象です。正式な GA の前に、API、ドキュメント、振る舞いはまだ変わる可能性があります。

公開時刻と議論

公式の発表時刻は @vercel の投稿 に合わせます。2026-11-12 18:41:04 UTC、Asia/Shanghai では 2026-11-13 02:41:04 です。npm では @ui-sdk/react@0.1.0-beta.1 が 2026-11-12 17:09:05 UTC(Asia/Shanghai 01:09)、@ui-sdk/core@0.1.0-beta.1 が 17:12:06 UTC(01:12)に公開されています。

X の公開データによれば、2026 年 11 月 13 日 04:23 Asia/Shanghai 時点で次のとおりです。

すでに Vercel の他の Agent 製品を追っている場合は、Vercel agent-desktop の使い方 と Cursor Live Apps の使い方 も対照できます。

React 19 のプロジェクトに 0.1.0-beta.1 を入れる

公式の React インストール手順 は、React 19 と React DOM 19 以上を要求します。私たちは create-vite@9.3.4 の react-ts テンプレートで最小アプリを作りました。テンプレートに含まれていたのは react@19.3.1 / react-dom@19.3.1 と @types/react@19.3.0 です(公式は TypeScript 利用時に @types/react 19.2.10 以上も求めています)。

bash
npm install @ui-sdk/react @ui-sdk/core

このコマンドは 2026 年 11 月 13 日 04:20 Asia/Shanghai に実行しました。npm の出力は added 2 packages, and audited 31 packages in 797ms で、実時間は約 0.86 秒、終了コードは 0 です。npm ls の結果は次のとおりです。

text
@ui-sdk/core@0.1.0-beta.1
@ui-sdk/react@0.1.0-beta.1
react@19.3.1
react-dom@19.3.1

両方の SDK パッケージのライセンスは Apache-2.0 です。@ui-sdk/react の peer 依存は react / react-dom >=19 と @ui-sdk/core ^0.1.0-beta.1 です。他のフレームワークでは、公式 README のとおり @ui-sdk/react を @ui-sdk/vue、@ui-sdk/svelte、@ui-sdk/solid、@ui-sdk/web のいずれかに差し替え、同じく @ui-sdk/core を入れてください。

公式の search-field 例を書いてビルドする

公式 README の案内例は、Clear ボタン付きの search-field です。入力に文字があるときだけ Clear が表示され、押すと空にしてフォーカスを入力へ戻します。私たちは primitive と React の描画を src/lib/search-field.ts と src/components/Search.tsx に書き、App.tsx では公式 First Component 案内の Toggle も描画しました。

ts
import { createFocusRecovery, definePrimitive } from "@ui-sdk/core"

const searchField = definePrimitive({
  name: "search-field",
  state: () => ({ value: "" }),
  api: (context) => ({
    set: (value: string) => context.store.set({ value }),
    recovery: createFocusRecovery({ fallback: () => context.element("input") }),
  }),
  slots: (slot) => ({
    input: slot({
      attrs: (state) => ({ value: state.value }),
      on: {
        input: (event, { api }) =>
          api.set((event.target as HTMLInputElement).value),
      },
    }),
    clear: slot({
      present: (state) => state.value !== "",
      attrs: () => ({ type: "button" }),
      press: ({ api }) => api.set(""),
      bind: (el, part) => part.api.recovery.bind(el, part),
    }),
  }),
})

export { searchField }
tsx
import { createParts } from "@ui-sdk/react/primitive"
import { searchField } from "../lib/search-field"

const parts = createParts(searchField, { input: "input", clear: "button" })

const SearchField = parts.Root
const SearchFieldInput = parts.Input
const SearchFieldClear = parts.Clear

function Search() {
  return (
    <SearchField>
      <SearchFieldInput placeholder="Search" />
      <SearchFieldClear>Clear</SearchFieldClear>
    </SearchField>
  )
}

export { Search }

そのあとプロジェクトで npm run build(スクリプトは tsc -b && vite build)を実行しました。ビルドは 2026 年 11 月 13 日 04:20 Asia/Shanghai に終わり、Vite 8.3.8 は 189 modules transformed と built in 175ms を出力しました。コマンド全体の実時間は約 0.88 秒、終了コードは 0 です。ブラウザを開いて検索欄をクリックしてはいません。この段階の結果は、ビルドが通ったことです。

Claude Code / Codex / Cursor 向けに UI SDK skill を入れる

Agent が公式の流れ(振る舞いを選び、primitive を定義し、描画し、テストする)に沿うために、ドキュメントが示しているインストールコマンドは次です。

bash
npx skills add vercel-labs/ui --skill ui-sdk

同じ React プロジェクトのルートで実行し、実時間は約 6.71 秒、終了コードは 0 でした。インストーラーは環境を検出したうえで、skill をプロジェクト内の ./.agents/skills/ui-sdk にコピーしました。出力には Cursor、Codex、その他の一連の Agent が対象として書かれていました。公式は、同じ skill が @ui-sdk/core に同梱され、パスは node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md で、インストールしたパッケージ版と常に一致するとも説明しています。Agent が skills に対応していない場合は、このファイルを指してください。

公式の React クイックスタート は、AGENTS.md に注記を足すこと(なければ新規作成)も求めています。私たちは同梱ドキュメントを指す次の内容を書きました。

text
Before using ui-sdk, follow the ui-sdk skill if it is installed, and read
node_modules/@ui-sdk/react/docs/llms.txt. To build a new component, also search
node_modules/@ui-sdk/react/docs/core.md by heading, and read rendering.md next
to it.

他のフレームワークでは、このパスの @ui-sdk/react を対応パッケージ名に差し替えます。Skill のインストール場所と、各クライアントでの発火の仕方は、Agent Skills の使い方 と tstack の入れ方・使い方 も参照できます。ツール呼び出しの前後にフックを足す場合は、Claude Code / Codex / Cursor の Agent Hooks の設定 を見てください。

公式が Agent に渡す例のプロンプトは次のとおりです(フレームワークとインタラクションは自分のアプリに合わせて変えてください)。

text
Use ui-sdk to build a five-star rating in React.
Arrow keys should move between stars and choose a rating.
Use our existing styles and test the keyboard behavior.

実測:Claude Code と Codex がそれぞれ五段階評価を生成した

SDK を入れ、AGENTS.md を書き、ui-sdk skill を追加済みのプロジェクトを、Claude Code と Codex に渡しました。プロンプトは上の公式例に加え、既存の search-field を残すこと、評価コンポーネントを App.tsx につなぐこと、最後に npm run build を走らせることを指示しました。どちらも本サイトの API(設定は次節)と隔離した HOME を使い、終わったら Key を含む設定を削除しました。Claude Code 向けには、標準で読む .claude/skills/ui-sdk にも skill をコピーしました。

Claude Code 2.1.319、モデル claude-opus-5-5 は、2026 年 11 月 13 日 04:22:01 に開始し、04:23:06 に終了しました(Asia/Shanghai)。実時間は 65.02 秒です。JSON 結果の duration_ms は 64442、num_turns は 20、subtype は success でした。既製の Rating コンポーネントは使わず、@ui-sdk/core の definePrimitive、createChange、createRovingFocus で src/lib/rating.ts を書き、createParts で src/components/Rating.tsx を描画しました。五つの星は role="radio" のボタンで、矢印キーがフォーカスを移し値を更新します。自身が走らせた npm run build の終了コードは 0、約 0.9 秒、191 モジュールでした。同じディレクトリで私たちが再ビルドした結果も終了コード 0、約 0.79 秒です。

Codex CLI 0.167.0、モデル gpt-6.1-sol は同時刻に開始し、04:23:12 に終了、実時間は 70.92 秒でした。こちらはもう一つの公式経路で、既製の @ui-sdk/react/rating から Rating と RatingItem を import して src/components/Rating.tsx を書き、createAgent() を使うテストも追加しました。報告ではテスト 2 件成功、終了コード 0、ビルドも終了コード 0 で 0.68 秒(196 モジュール、Vite は built in 147ms)でした。その後私たちが npx vitest run --environment jsdom(Vitest 5.1.0)を再実行した結果は Test Files 1 passed、Tests 2 passed、802ms です。再ビルドも終了コード 0、built in 157ms でした。二つのテストは、矢印キーでの選択とタブストップが一つであること、および agent が snapshot / act({ action: "setValue", args: [4] }) で評価を 4 にすることです。Codex は、ブラウザでの見た目確認はしていないと書いています。

Cursor でも同じ skill を入れられます(今回のインストーラーも対象に挙げていました)。ただし Cursor 内で生成タスクは実行していません。うまく発火するかどうかは、お手元の Cursor のバージョンに依ります。

ページ上のコンポーネントを Agent に読み書きさせる

コンポーネントが描画されたあと、公式の agent bridge を通じて状態を読み、actions を呼ぶこともできます。React での書き方は Agents ドキュメント によれば次です。

ts
import { createAgent } from "@ui-sdk/react/agent"

const agent = createAgent()

agent.snapshot() は、ページ上の ui-sdk コンポーネント、その状態、利用可能な actions を返します。アクセス可能な名前を持つ入力欄なら、setValue や clear が含まれることがあります。続けて次のように呼びます。

ts
await agent.act({
  steps: [{ ref: "Project name", action: "setValue", args: ["Atlas"] }],
})

他のフレームワークでは @ui-sdk/vue/agent、@ui-sdk/svelte/agent、@ui-sdk/solid/agent、@ui-sdk/web/agent から import します。上の Codex の二つ目のテストがこの API を使っており、評価コンポーネントに対して setValue(4) を実行し、テストは成功しました。createAgent に allow コールバックを渡し、許可する動作を制御することもできます。

Claude Code / Codex / Cursor を本サイトの API Key に接続する

UI SDK 自体はモデル API ではないので、モデル料金を設定する必要はありません。Claude Code、Codex、Cursor が本サイトのモデルを使って skill に沿ってコンポーネントを書くようにするには、クライアントを本サイトに向け、本サイトの API Key を入れてください。三つのクライアントは並列に扱います。普段使っているものを選んでください。

Claude Code では ~/.claude/settings.json を書きます。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "あなたの AICodeWith API Key"
  }
}

Codex では ~/.codex/config.toml を書きます。base_url は https://api.aicodewith.ai/chatgpt/v1 で、/v1 にしてはいけません。グローバルな experimental_bearer_token を使い、name は "aicodewith" にします。

toml
model_provider = "aicodewith"
model = "gpt-6.1-sol"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "あなたの AICodeWith API Key"

Cursor では、モデル設定にカスタム API とモデル名を入れられます。この経路は今回実行していないため、接続できるかどうかはお手元の Cursor のバージョンに依ります。

今回のような生成を本サイトの Key で行う場合は、次から作成できます。

Create API Key →

よくあるエラーと対処

エラー / 現象原因対処
インストールや型チェックで React の peer が満たされない@ui-sdk/react は React 19+ を要求するreact と react-dom を 19 以上にする。TypeScript 利用時は @types/react も 19.2.10 以上にする
@ui-sdk/react だけ入れて import や実行に失敗する@ui-sdk/core は peer 依存で、公式は両方を入れて core を一つに揃えるよう求めているnpm install @ui-sdk/core を追加する
Cannot find module '@ui-sdk/react' や、欲しいコンポーネント名が見つからない公式はルートの一括エクスポートはないとし、コンポーネントは個別エントリから import するimport { Dialog, DialogTrigger } from "@ui-sdk/react/dialog" のように書く
Agent が ui-sdk skill に沿わない、またはドキュメントを見つけられないskill がそのクライアントの読む場所にない、あるいは AGENTS.md が同梱の llms.txt を指していないnpx skills add vercel-labs/ui --skill ui-sdk を再実行し、公式どおり AGENTS.md を更新する。または node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md を直接指す
Codex がモデル不存在と出すが、書いたモデルは掲載済みbase_url が https://api.aicodewith.ai/v1 になっているhttps://api.aicodewith.ai/chatgpt/v1 に直す
ビルドは通るが、Clear が出ない、またはフォーカスが入力に戻らない公式例どおりに present / createFocusRecovery をつないでいない、または Clear が同じ primitive の Root に入っていない公式 search-field 例の present、press、bind と照合する
小さなバージョンアップのあと、覚えていたドキュメントと API が合わない現在は beta で、公式は API がまだ変わると書いているサイトだけではなく、入れた版の node_modules/@ui-sdk/*/docs/ の同梱ドキュメントを見る

FAQ

UI SDK は普通のコンポーネントライブラリと何が違うのか?

公式ドキュメントによれば、振る舞いはフレームワーク非依存の @ui-sdk/core にあり、アダプターは描画だけを担当します。Select、Dialog、Tabs、Rating などの既製コンポーネントも同じ振る舞いの上に乗っており、スタイルなしで、provider もポータルも不要です。既製コンポーネントを使わず、definePrimitive だけで画面を組むこともできます。

React 必須か?

必須ではありません。公式は Vue、Svelte、Solid、Web Components のアダプターも出しています。今回の実測は React 19.3.1 の経路です。他のフレームワークは公式ドキュメントどおりパッケージを差し替えてください。それらのフレームワークでは、今回ビルドを再実行していません。

Agent に skill は必須か?

必須ではありません。公式は、Agent が skills に対応していれば npx skills add vercel-labs/ui --skill ui-sdk を使い、対応していなければ node_modules/@ui-sdk/core/skills/ui-sdk/SKILL.md や同梱の llms.txt を指せばよいとしています。インストール後、どちらのファイルも存在することを確認しました。

beta を本番で使ってよいか?

公式ドキュメントは beta であること、API がまだ変わること、そして Vercel Public Beta Agreement を示しています。本番利用するかどうかは、この条項とご自身のリスク判断によります。本稿はインストール、ビルド、Agent によるコンポーネント生成で見た結果だけを記録しています。

今回 Cursor を実行しなかった理由は?

インストーラーは Cursor を skill の対象に含めていましたが、Cursor 内で生成タスクは開始していません。本文の Cursor 設定は本サイトの通常の書き方に沿ったもので、今回の実行では確認していません。

本サイトのモデルで Claude Code や Codex を走らせる場合は、先に API Key を作成できます。

Create API Key →

相关文章

AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator とは?インストール方法と、Claude Code / Codex でローカルに AWS アプリをテストする手順(1.0.322 で検証)

AWS Emulator は AWS 公式のローカル AWS エミュレーターで、2026 年 11 月 11 日(米国時間)に一般提供(GA)が始まりました。追加のサービス料金はかからず、ソースは公開されており、AWS アカウントも不要で、200 以上のサービスをカバーします。本記事では Debian 13 上で 1.0.322 を検証し、インストールコマンド、AWS CLI をローカル endpoint に向けて S3 バケットと DynamoDB テーブルを作る手順、遭遇したエラー、Claude Code・Codex・Cursor にエミュレーター相手でコードを書かせてテストさせる方法をまとめます。

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code とは?インストール方法、Claude Code・Codex との接続、サードパーティ API Key の設定とよくあるエラー(0.1.9 で検証)

T3 Code は pingdotgg が公開しているオープンソースのコーディングエージェント用コンソールです。モデルは内蔵しておらず、マシンにインストール済みの Claude Code、Codex、Cursor などの CLI を操作します。Linux 上で T3 Code 0.1.9 を検証し、インストールコマンド、Claude Code と Codex を AICodeWith API Key につないで T3 Code から操作する設定、t3 thread コマンドで両方を動かした結果、実際に出たエラーと対処法をまとめました。

Claude Code / Codex / Cursor Agent Hooks の設定方法:PreToolUse 比較、最小スクリプトと fail-open の実測

Claude Code / Codex / Cursor Agent Hooks の設定方法:PreToolUse 比較、最小スクリプトと fail-open の実測

Instructions、AGENTS.md、skills はモデルが無視できる提案にすぎない。hooks は harness が固定タイミングで実行する決定論的スクリプトだ。本記事では Claude Code、Codex、Cursor の PreToolUse(または同等イベント)について、設定パス・イベント名・exit 2 / deny・fail-open と fail-closed を比較し、Claude Code で実測済みの最小インターセプトスクリプトを示す。