1DesignTool の問題のほとんどは、一握りの原因に集約されます。見つからない・サインアウトしたエージェント、止まる実行、レンダリングしないプレビュー、ゲート FAIL、使い切ったキャップ。このページは、それぞれについてまず見るべき場所です。
ピッカーにエージェントがいない
アプリはターミナルと同じ方法で、PATH 上の対応 CLI を見つけます。
- インストールされているか? ターミナルで CLI を名前で実行(
claude、codexなど)。シェルが見つけるなら、アプリも見つけるはずです。 - サインインしているか? ピッカーはサインイン状態を表示します。サインインがないのはアプリではなく CLI 自身の認証の問題です。CLI 側でサインインして開き直してください。
- ロスターにあるか? 16 の対応 CLI は対応コーディングエージェントに一覧があります。リストにない CLI は接続できません。
実行が止まる・失敗する
- エージェントのクォータを確認 — ターンはあなたの CLI アカウントに課金されます。使い切った・失効したアカウントは、トランスクリプトで実行を可視的に失敗させます。
- トランスクリプトを読む — エージェント自身の出力がそこにあります。CLI 側のエラーは、汎用的な失敗ではなく、それ自身として表示されます。
- 一度リトライ — 一過性の CLI 障害はリトライで着地することがあります。持続する失敗には、トランスクリプトが名指す原因があります。
プレビューがレンダリングしない
- プレビューはデフォルト拒否 — 分類器が配信しないファイルタイプは、危険になる代わりに何もレンダリングしません。これはバグではなく安全の床です。
- 古い worktree — コードベースプロジェクトでは、プレビューは
1design/<slug>worktree を読みます。ブランチ状態がおかしそうなら、レンダリングを疑う前にブランチバーの diff をレビューしてください。 - パネルをリフレッシュ — プレビューレールのリロードボタンはフォルダを再読み込みします。書きかけのファイルはたいてい次の描画で解消します。
ゲート FAIL が消えない
- この幅で修正 — FAIL の所見の修正ボタンは、まさにその問題を一行ブリーフとしてエージェントに送り返します。所見は幅と要素を名指すので、修正はたいてい機械的です。
- その幅で確認 — 所見はどのビューポートが壊れたかを言います。ルールが間違っていると決めつける前に、その幅で結果を見てください。
- 意図的な所見もある — 既知のトレードオフは受け入れられます。ゲートは助言するのであって、ブロックしません。design kit ゲートを参照。
キャップが実行を拒否する
1design:limit: による拒否は、使い切ったキャップを名指します。Free ティアのターン、レンダリング、バージョン、バリアント、デザインシステムです。Settings → Usage にメーター全体が表示され、バージョンをアーカイブするとライセンスなしでスロットが解放されます。キャップは生涯カウンターで、Pro はそれらを解除します。Free と Pro の違いを参照。
Windows の場合: EISDIR エラー(既知の問題)
Windows の 1.7.0 では、design kit スクリプトが EISDIR で失敗することがあり、Knowledge、ターン後のチェック、ビデオエクスポート、Build モードが壊れます。既知のバグで、次のリリースで修正済みです。macOS では同じフローに影響はありません。
MCP クライアントが接続できない
- アクセスパネルを確認 — Settings → MCP access にエンドポイント、トークン、許可クライアントの一覧が表示されます。拒否されるクライアントはたいてい一覧にありません。
- トークンを確認 — クライアントが送るのはパネルのトークンです。古い・間違ったトークンは接続を拒否します。
- アクティビティログを確認 — ログはサーバーに届いたものと届かなかったものを表示します。
まず見るべき場所
- トランスクリプトパネル — エージェントの出力をそのまま
- ブランチバー — コードベースプロジェクトで、ターンが実際に何を変えたか
- Settings → Usage — どのメーターが使い切られたか
- アクティビティログ — MCP クライアントが実際に何をしたか
ヒント: トランスクリプトは常に最初に読むものです。エージェント自身の出力が起きたことの正直な版で、「アプリが壊れた」ケースのほとんどは、本当は「CLI が、UI が柔らかく翻訳しすぎた何かを言った」です。