SDK のセットアップと拡張機能の管理

sima-cli sdk setup の実行時に、任意の SDK サービス、ブラウザー版 VS Code の拡張機能、Model Compiler のインストール元を選択します。

コマンドリファレンス: sima-cli sdk setup

コンテナイメージのビルドと共有

DevKit とともに SDK 3.0 以降をセットアップすると、sima-cli は小規模なローカルコンテナレジストリの作成を提案します。レジストリはホストにイメージを保存するため、SDK コンテナを置き換えてもイメージを引き続き利用できます。

レジストリはポート 5050 で起動します。そのポートが使用中の場合、sima-cli は次の空きポートを自動的に選択し、選択したアドレスを表示します。

セットアップでは、SDK シェル内で使える次の 2 つのアドレスも提供します。

• SIMA_CONTAINER_REGISTRY は SDK がイメージをプッシュするためのアドレスです。
• SIMA_DEVKIT_CONTAINER_REGISTRY は DevKit が同じイメージをプルするためのアドレスです。

Dockerfile でアプリケーションを定義し、SDK 内で ARM64 イメージをビルドしてプッシュします。

docker buildx build \
  --platform linux/arm64 \
  --tag "${SIMA_CONTAINER_REGISTRY}/hello-neat:develop" \
  --push \
  .

dk container deploy を使って同じレジストリからイメージをダウンロードし、接続した DevKit 上で実行します。

dk container deploy hello-neat:develop \
  --detach \
  --name hello-neat \
  --network host

短いイメージ名だけで十分です。dk は sima-cli が設定した DevKit 用のレジストリアドレスを使います。先に明示的にイメージを更新せずに起動するには、dk container run hello-neat:develop ... を使います。

レジストリはローカル開発ネットワークで HTTP を使います。レジストリは SDK 用のループバックと DevKit 側のネットワーク経路にのみ公開され、ホストのすべてのインターフェースには公開されません。

macOS では、セットアップは物理 LAN 経路と Cloudex などのルーティングされたトンネルを区別します。物理経路では Colima のブリッジアドレスを使います。utun、WireGuard などのトンネルは Ethernet ブリッジを運べないため、セットアップは Colima を共有モードのままにして、代わりに network.hostAddresses を有効にします。これにより、SDK コンテナーは Mac のトンネル経路をたどりながら、DevKit が使用する Mac のトンネルアドレスでレジストリを公開できます。Colima は通常トンネルのサブネットプレフィックスもコピーするため、セットアップは VM のローカルルーティングテーブルから広いサブネット経路を削除し、Mac のアドレスだけを /32 のローカル経路として残します。これを行わないと、VM が DevKit ピアをローカルアドレスと誤認する可能性があります。この修復設定は Colima の再起動後も保持されます。アクティブなプロファイルが物理接続用のブリッジモードで構成済みの場合、セットアップは保護されたプロファイル再作成手順を使い、検証済みの独立した Docker データディスクを保持したまま共有モードへ切り替えます。Kubernetes が有効なプロファイルなど、安全に再作成できないプロファイルは変更しません。トンネルのホストアドレスが変わった場合は、トンネルへ再接続してセットアップを再実行してください。

SDK セットアップは DevKit に Docker をインストールも設定もしません。最初の dk container コマンドが、必要な Docker のインストールを処理し、ローカルレジストリを使用するよう Docker を設定します。Docker は、レジストリ設定が変更された場合にのみ再起動されます。これにより、コンテナーのデプロイを使用しないユーザーにとって Docker は完全に任意のままです。Docker のインストールには、明示的な承認と Docker の Debian リポジトリへのインターネットアクセスが必要です。パスワードなしの sudo は前提条件ではありません。sima-cli がセットアップ中に DevKit ユーザー用に設定します。

この手順を省略するには --no-container-registry を使います。既存のレジストリを停止したり削除したりはしません。別のポートを選ぶには、--container-registry-port <port> を指定してセットアップを再実行します。ポートを変更しても保存済みのイメージは保持されます。

Edgematic Studio

Neat SDK イメージでは、セットアップは確認なしで Edgematic Studio をインストールし、ポートを公開して起動します。-y と --noninteractive でも同様です。サマリーの Edgematic Studio パネルに Studio の URL が表示されます。Studio はホストのポート 8088 を使い、8088 が使用中の場合は別の空きポートを使います。

最初のチャットの前に、Studio の設定からコーディングエージェントにサインインしてください。Studio はコンテナーと一緒には再起動しません。URL が開かなくなった場合は、SDK コンテナーのシェルで activate-edgematic-studio を実行してください。

Studio をスキップしてポートを公開しない場合は --no-edgematic-studio を使います。後で手動インストールするためにポートだけを公開するには --edgematic-studio-port を使います。--minimal と --no-insight も Studio をスキップします。Docker のポートマッピングは後から変更できないため、これらの選択はコンテナーの作成時に適用されます。

Studio のインストールに失敗してもセットアップは続行し、後で SDK コンテナーのシェルからインストールするためのコマンドを表示します。

ブラウザー版 VS Code の拡張機能の選択

Neat は現在の SDK ユーザー向けに、確認なしで自動インストールされます。新しい SDK イメージには拡張機能が同梱され、セットアップ時にローカルコピーされます。古いイメージでは既存のダウンロード方式を使います。--minimal は拡張機能のセットアップをスキップします。

対話型セットアップでは任意の Codex と Claude 拡張機能を選べます。Space で選択し、Enter で確定します。最初は両方とも未選択です。何も選ばなければコーディングエージェントのインストールをスキップし、選択しなかった既存の拡張機能は残ります。

自動化する場合は、チェックリストを表示せずコーディングエージェントをインストールします:

sima-cli sdk setup --noninteractive --all-extensions

--all-extensions は拡張機能の選択だけを省略します。他の質問を省略するには --noninteractive を使います。既存の SDK コンテナーを再利用する場合も拡張機能をインストールします。このオプションがなければ、従来の SIMA_CLI_INSTALL_CODEX_EXTENSION 設定で要求されない限り、-y と --noninteractive は任意の拡張機能をスキップします。--all-extensions は --minimal と併用できず、Edgematic Studio や Model Compiler の選択を変えません。

ブラウザー版 VS Code の拡張機能のバージョン

code-server（SDK 3.0 以降）では、Codex は既定で利用可能な最新リリースをインストールし、バージョンを固定しません。明示的にバージョンを指定した場合は、そのバージョンに固定します。古い OpenVSCode イメージでは Codex の互換用固定バージョンを維持します。Claude は引き続き厳密なバージョンに固定します。固定バージョンの選択では、セットアップを再実行すると異なるバージョンを置き換え、一致するバージョンは再ダウンロードせず保持して固定します。SDK イメージは /etc/sima-neat/vscode-extensions.json で検証済みバージョンを宣言できます:

{
  "schema_version": 1,
  "extensions": {
    "openai.chatgpt": "26.5825.51511",
    "anthropic.claude-code": "2.1.266"
  }
}

マニフェスト自体はインストールへの同意を意味しません。スキーマバージョン 1 では両方の ID に厳密なバージョンが必要です。マニフェストのない古いイメージは互換用の代替として Codex 26.5825.51511 と Claude 2.1.266 を使います。読み取れない、または無効なマニフェストはエラーを報告してコーディングエージェントのインストールをスキップしますが、残りのセットアップは続行します。Codex または Claude のインストールコマンドが失敗した場合、選択したターゲットと通常の TLS 検証で最大 3 回試行します。

環境変数による上書きが優先されます:

変数	動作
SDK_SKIP_CODING_AGENT_INSTALL	1、true、yes、on に設定すると、確認や --all-extensions を含め Codex と Claude の拡張機能インストールをスキップします。Neat のセットアップは実行され、既存のエージェントは削除されません。
SIMA_CLI_CODEX_EXTENSION_ID	publisher.extension@exact-version で Codex を上書きします。空なら --all-extensions を使わない限り無効にします。
SIMA_CLI_CLAUDE_EXTENSION_ID	publisher.extension@exact-version で Claude を上書きします。空なら --all-extensions を使わない限り無効にします。
SIMA_CLI_INSTALL_CODEX_EXTENSION	チェックリストなしで拡張機能のインストールを自動選択します。

code-server では、バージョンなしの Codex ID（または openai.chatgpt@latest）は最新リリースを使います。他のバージョンなしの組み込み ID は SDK/既定の固定バージョンを使い、その他の ID には明示的なバージョンが必要です。--minimal は任意の拡張機能のインストールをスキップします。セットアップはインストール済みバージョンを検証し、選択した各拡張機能の metadata.pinned フラグ（最新 Codex では false）を書き込み、ブラウザー版 VS Code を再起動します。その後、開いているブラウザータブを再読み込みしてください。

Model Compiler のインストール元

セットアップは SDK コンテナーのアーキテクチャに応じて、現在の作業ディレクトリだけで model-compiler-arm64.zip または model-compiler-amd64.zip を探します。展開済みフォルダー、親ディレクトリ、ワークスペースの ZIP、別のアーキテクチャは検索しません。

有効なローカル ZIP があれば、ローカル、オンライン、スキップを選べます。なければオンラインまたはスキップを選べ、Enter の既定値はスキップです。

フラグ	ローカル ZIP あり	有効なローカル ZIP なし
--noninteractive	ローカルからインストール	スキップ
--noninteractive -y	ローカルからインストール	オンラインでインストール
-y	ローカルからインストール	オンラインでインストール

無人でのオンラインインストールには -y が必要です。従来の SDK ソースでは、ホストで sima-cli login を使って認証します。--minimal、--no-model-compiler、--no-model-sdk は常にインストールをスキップします。

公式 ZIP はルートに install_modelsdk_wheels.sh、source.json、manifest.txt、パッケージのペイロードを含み、SDK 用に選択されたコンパイラーバージョンと一致する必要があります。アーカイブをホストの一時ストレージに展開し、Linux コンテナーの一時ストレージへコピーするため、両方のコピーに必要な空き容量を確保してください。成功または失敗後に一時データを削除し、元の ZIP は保持します。ローカルインストールの失敗時にオンラインへフォールバックしません。システムパッケージや Python の前提条件にはネットワーク接続が必要な場合があります。