製品ページ FAQ お問い合わせ
Sanary Build InterfaceSBI · VS Code Extension for macOS

SUPPORT

Sanary Build Interface Support

SBIの使い方や、よくある質問をご案内します。

GETTING STARTED

はじめに

SBIは、VS CodeでClaude CodeやCodexを実行し、結果を表示する無料の拡張機能です。実行するCLIは、あなたがインストールしたものです。

  1. 拡張機能をインストール
  2. ワークスペースのフォルダを開く
  3. コマンドパレットで「SBI: Run Agent」を実行(Chatなら「@sbi /claude」「@sbi /codex」)
  4. Agent(Claude CodeまたはCodex)を選び、指示を入力
  5. 結果を「SBI」の出力パネルと通知で確認

SBIは、Sanaryにデータを送りません。

アカウント不要、テレメトリなし。通信はMac内の127.0.0.1に限られます。

FAQ

よくある質問

SBIは無料ですか?

はい。SBIは無料で、アカウントも不要です。

動作環境を教えてください。

macOS 13以降のApple Silicon(arm64)と、VS Code 1.100以降です。IntelのMac、Windows、Linuxでは動作しません。Claude Code CLIまたはCodex CLI(使うほう)が必要です。

「Claude Code / Codexが見つからない」と表示されます。

SBIが、実行に使うCLIを見つけられていません。VS Codeの設定 sbi.claudeCodeExecutablePath / sbi.codexExecutablePath にフルパスを指定するか、環境変数 CLAUDE_CODE_EXECUTABLE_PATH / CODEX_EXECUTABLE_PATH、またはPATHをご確認ください。SBIがCLIを自動でインストールすることはありません。

SBBがなくても使えますか?

はい。SBB(Sanary Build Bridge)は任意です。なくてもAgentは通常どおり動作し、評価は「利用不可」と表示されます(承認としては扱いません)。

「:8788 が使用中」と表示されます。

別のプログラムがポート8788を使っています。SBI同梱のRuntimeは 127.0.0.1:8788 を使います。そのプログラムを終了して、VS Codeのウィンドウを再読み込みしてください。

「Runtimeが古い」または「localRequestGuard」という警告が出ます。

すでに動いているRuntime(たとえば古いSBBが内蔵しているもの)が、新しい安全確認(ブラウザ上のWebページからのリクエストを拒否する仕組み)に対応していない場合に表示されます。動作は続きますが、SBIはそのRuntimeを止めたり置き換えたりしません。同梱の新しいRuntimeを使うには、その古いRuntimeを終了して、ウィンドウを再読み込みしてください。

SBIは何を書き換えますか? 無効化・アンインストールすると?

Claude Code / Codexのhook登録のため、~/.claude/settings.json、~/.codex/hooks.json(と ~/.codex/config.toml のSBI管理ブロック)、~/.sbi/hooks を書き換えます。ほかの設定は保持します。無効化・VS Codeの終了では、何も書き戻しません。アンインストールすると、SBIが追加したものだけを取り除きます(VS Codeの次回起動時に一度だけ実行)。

VS Codeのウィンドウを複数開いても大丈夫ですか?

はい。すべてのウィンドウが1つのRuntimeを共有します。Runtimeを起動したウィンドウを閉じても、残りのウィンドウが約20秒で新しいRuntimeを起動します。そのとき、閉じたウィンドウのRuntime経由で実行中だったAgentは中断されます。

Xcodeとの関係は?

SBIの拡張機能は、Xcodeの設定を書き換えません。SBIのRuntimeは、同じMac上のXcode内蔵のコーディングエージェントを読み取り専用で観察できます。

PRIVACY

プライバシーについて

SBIは、アカウント・サーバー保存・解析ツールを使わず、Sanaryへデータを送りません。Sanaryプライバシーポリシーでは、このようなアプリは個人情報を収集しないものとされています。SBIがMacの中で行うことは、次のとおりです。

  • 書き込む:~/.claude/settings.json と ~/.codex/hooks.json のSBIのhook項目、~/.codex/config.toml のSBI管理ブロック、~/.sbi/hooks/(hook用の小さなヘルパー)。
  • 読み取る:Claude Codeのセッションファイル(~/.claude/sessions)、Codexのセッション記録(~/.codex/sessions)、開いているワークスペースのファイル変更・デバッグ・ターミナルの動き(「作業中」の判定用。ターミナルに入力した内容は読みません)。
  • hookが渡す:hookが動くと、プロンプト、作業ディレクトリ、Agentの最後の返答が、Mac内のSBI Runtimeへ渡され、SBBが起動していれば評価のためSBBへ送られます。

SBB・SBG・SBRを使う場合

SBB(SBGを内蔵)が起動していると、SBIのRuntimeはMac内のSBG(127.0.0.1:8790)へ、次の内容だけを渡します。

  • ワークスペースのフォルダ名と、パスの一方向ハッシュ、そのワークスペースが開かれていて作業中かどうか、Claude Code / Codexが動いているかどうか。
  • SBBやSBRから送られた指示でAgentが動いた場合の作業状況:指示の冒頭(最大100文字)と、結果またはSBBの指摘を示す短い行(それぞれ最大160文字)。
  • Claude Code / Codexのhook:プロンプトの最初の1行(最大40文字)と、SBBの判断の短い理由。

プロンプトや返答の全文は、SBGへは送られません(SBBにだけ、Mac内で評価のために渡されます)。SBGはこれらをメモリに保持し、保存するのはペアリング情報とRemote Accessの設定だけです。SBR(iPhone)とペアリングすると、SBGがペアリング時に発行した端末の資格情報で認証したうえで、同じローカルネットワークを通じて、あなたのiPhoneにだけ提供します。SBIもSBGも、これらをSanaryのサーバーへは送りません。

Sanaryプライバシーポリシー ・ 利用規約

CONTACT

解決しない場合

FAQで解決しない場合はお問い合わせください。以下の情報があると、状況を確認しやすくなります。

  • SBI version(拡張機能のバージョン)
  • VS Code version
  • macOS versionとMacのモデル
  • 「SBI」出力パネルのログ(機密情報は除いてください)
  • Claude Code / Codexのバージョン、発生している操作

パスワード、APIキー、Apple ID、購入情報などの機密情報は送らないでください。ログや画面の画像を添える場合も、機密情報が含まれていないことをご確認ください。

SBI製品ページFAQお問い合わせ