AIコーディングツールから返答があっても、変更した接続先が使われたとは限りません。以前の設定やセッションが残っている可能性があるためです。複数のクライアントを使う場合も、まず1つだけ設定し、返答とリクエスト記録を照合すると、問題の切り分けがしやすくなります。
この記事はOfox運営チームによる、公式資料に基づく確認手順です。Ofox Desktopを例に説明しますが、全クライアントの実機検証やモデル互換性の評価ではありません。API呼び出しの実測結果も含みません。
設定前に確認すること
利用中のクライアントとそのバージョン、現在の接続設定を記録します。CLI版とデスクトップ版では設定方法が異なる場合があるため、両者の手順を混ぜないでください。Desktopの現在のインストール要件とクライアント別の資料を確認し、設定変更前にバックアップの場所も確かめます。
業務用リポジトリではなく、空のテスト用フォルダーを使います。Desktopでアカウントを接続し、インストール済みのクライアントと用途に合うモデルを1つ選んで設定を適用します。確認中はモデルを固定します。複数の設定を同時に変えると、どの変更が原因か判断しにくくなるためです。
返答と記録を照合する
クライアントで新しいセッションを開き、「ファイルを読まず、ツールを使わず、OFOX_CONNECTION_CHECKとだけ返答してください」のように短い応答を求めます。これはテスト用の指示例であり、実際に取得した出力ではありません。
送信したおおよその時刻と選択モデルを記録し、同じOfoxアカウントのリクエスト履歴で対応する記録を探します。時刻、モデル、ステータス、表示される場合はクライアント別のキー情報を照合し、記録された料金も確認します。アプリをインストールしたことと、モデル利用が無料であることは別です。
| 確認できた状態 | 次に調べること |
|---|---|
| 返答はあるが対応する記録が見つからない | 履歴を見ているアカウント、送信時刻、クライアントの有効な接続設定 |
| リクエスト記録はあるが返答が得られない | 記録のステータスとクライアント側のエラー |
| 短い返答は得られるがコード作業で失敗する | 必要なツール機能、作業時のエラー、ファイル変更の結果 |
対応する記録が特定できなければ、接続確認は未完了として扱います。エラーを保存して原因を調べ、同じ操作を何度も繰り返す前に状況を整理してください。
何を確認できたかを分けて残す
短い文章の応答で確認できるのは、基本的なテキスト通信です。リポジトリの読み取り、ファイル編集、ツール呼び出し、開発作業全体の成功を証明するものではありません。その後、機密情報を含まない小さなコード課題に進み、変更差分と、その課題に必要なテストを確認します。
クライアント名とバージョン、モデル、送信時刻、対応する履歴、結果を1セットで記録します。最初のクライアントを確認してから次のクライアントを追加すれば、設定の問題と作業実行の問題を混同しにくくなります。問い合わせ時はAPIキーや非公開プロンプトを公開せず、必要な情報だけを伏せ字にして共有してください。
原文のOfox Desktopセットアップガイドには、インストール条件と各クライアントの資料への案内があります。本稿の下書きと確認にはAIを使用しました。