プロバイダー

プロバイダーとは、実際にモデルターンを実行するネイティブのコーディングエージェント CLI です。ThreadCells はその CLI をアダプターで包み、起動、ターミナル状態、キャンセル、機能レポート、利用可能な使用量テレメトリーを共通の形にします。

3つの異なる事実

プロバイダー画面では、混同しやすい次の3つの事実を意図的に分けています。

設定 → プロバイダーには、外部コマンドが存在しないものも含めてアダプターが表示されます。エージェントの起動では同じ正規プリフライトを使い、利用不可と確認されたプロバイダーを無効にします。

たとえば、組み込みアダプター · CLI 未インストール は矛盾ではありません。これは、ThreadCells はそのプロバイダーの操作方法を知っているものの、ホストには現在そのプロバイダーのプログラムがないことを意味します。

組み込みプロバイダー

現在のビルドでは、次のアダプターを登録しています。

登録は事実に基づく製品サポートであり、すべての CLI をインストールする指示ではありません。使用するプロバイダーだけを、その公式手順と認証ワークフローに従ってインストールしてください。

互換性マトリックス

このマトリックスは、このリリースにおけるアダプター契約を示すもので、特定のホスト上ですべての外部 CLI バージョンやアカウントが準備完了であることを約束するものではありません。サポート はアダプターが機能を直接実装すること、条件付き は動作がプロバイダー CLI またはセッションモードに依存すること、報告なし は ThreadCells がデータを作り出さないことを意味します。

Codex は参照およびリリース受け入れプロバイダーです。他の組み込みアダプターも、公開プリフライトで起動可能なら使用できますが、プロバイダーネイティブの動作と認証は異なることがあります。インストール済みビルドでは、ライブの設定機能ビューが権威を持ちます。

可用性ラベル

ThreadCells はプリフライトを、オペレーター向けの5つの状態に正規化します。

• 準備完了 (INSTALLED_AND_READY): インストール済みで互換性があり、認証を確認できる場合は認証済みです。
• 認証が必要 (INSTALLED_NOT_AUTHENTICATED): コマンドは存在しますが、プロバイダーはログインが必要だと報告しています。
• インストール済みだが正常でない (INSTALLED_BUT_UNHEALTHY): インストール済みですが、互換性がないか、健全性/バージョン確認に失敗しています。
• CLI 未インストール (NOT_INSTALLED): ThreadCells のランタイムユーザーから正規実行ファイルが見つかりません。
• 準備状況未検証 (UNKNOWN): インストール済みで利用不可とは確認されていませんが、プロバイダーは認証または準備状況を非対話的に安全に検証できません。

コマンドがインストール済みで互換性があり、認証状態だけが不明な場合、未検証のプロバイダーは起動可能のままにできます。起動時にプロバイダーネイティブのログインプロンプトが出て失敗することがあるため、そのターミナルを確認し、ThreadCells の外でプロバイダー認証を完了してください。

ランタイムユーザーの視点を確認する

プロバイダーの可用性は対話シェルではなく、ThreadCells を実行するアカウントに依存します。まず ThreadCells から確認してください。

threadcells providers list
threadcells doctor

次に、ランタイムユーザーとして期待するバイナリーとそのバージョンを確認します。Codex の場合は次のとおりです。

command -v codex
codex --version
codex login status

利用可能な場合は、プロバイダー自身の状態コマンドを使ってください。個人のプロバイダー資格情報ディレクトリーをサービスアカウントへコピーしてはいけません。そのアカウントを、プロバイダーがサポートするワークフローで認証してください。

設定とエージェントの起動

設定 → プロバイダーは、インベントリーと診断のビューです。アダプターの識別情報、設定、機能、コマンドの存在、バージョン、認証状態、公開しても安全なプリフライトメッセージを表示します。

エージェントの起動は起動用のビューです。有効/無効の状態は同じプリフライト結果から導かれます。更新後に2つのビューが一致しない場合は、どちらのラベルが正しいか推測せず、製品の不具合として扱ってください。

機能はプロバイダー固有

アダプターは、再開、構造化完了、モデル選択、推論制御、セッション永続化、使用量がサポート、条件付き、未サポートのいずれかを宣言します。ThreadCells は未サポートの機能を模倣しません。

Codex は参照アダプターであり、サポート対象トークンフィールドの正確な累積使用量テレメトリーを提供します。Claude Code は一部の使用量および完了機能を条件付きでサポートします。他のアダプターは使用量を報告しない場合があり、その場合 Statistics のフィールドは推定されず利用不可のままです。

設定とシークレット

プロバイダー設定は宣言的です。インストール済みアダプターとアダプター所有の設定を選択できますが、バイナリーパス、シェルコマンド、引数、環境変数、パスワード、トークン、未加工の資格情報をインポートすることはできません。

不透明な secret_refs は、信頼されたアダプターコードによって解決されるシークレットを指定できます。公開の一覧およびエクスポート応答では、その値は省略またはマスクされます。プロバイダーアダプターパッケージは実行可能な信頼済みコードであり、ホストオペレーターがインストールおよびレビューする必要があります。

トラブルシューティング

プロバイダーに CLI 未インストールと表示される

サービスアカウントとして command -v を実行し、その PATH を自分のシェルと比較してください。使用する場合に限り正規プロバイダーコマンドをインストールし、その後プリフライトを再起動または更新します。

インストール済みだが認証が必要

ランタイムユーザーとして、プロバイダーの公式ログインフローを実行してください。ThreadCells のプリフライトが代理で認証したり、権限バイパス設定を有効にしたりすることはありません。

準備状況未検証

コマンドは存在しますが、安全な非対話型の準備状況プローブがありません。バージョンを確認し、プロバイダーネイティブの小さなテストを実行してください。ThreadCells の起動が最初の決定的な準備状況確認になることがあります。

インストール済みだが正常でない

安全なプリフライト理由を確認してください。一般的な原因は、バージョンコマンドの失敗、既知の非互換バージョン、予期せず終了する実行ファイルです。外部 CLI をアップグレードまたは修復してください。準備完了と見なすためにアダプターレジストリーを編集してはいけません。

準備完了でも起動に失敗する

ターミナル出力を開いてください。プリフライト後に資格情報が期限切れになった、選択したモデルが利用できない、プロバイダーのサービス健全性が変化した可能性があります。

高度な統合の詳細は、プロバイダーアダプターの作成 を参照してください。起動プロファイルが制御する内容については、プロファイル を参照してください。