Cline を CodeNodex に接続する：OpenAI Compatible 設定ガイド

Cline をインストールして開いたら、CodeNodex の OpenAI グループに属する API キーを準備します。Cline の provider 設定はエディターの拡張機能ストレージに保存され、CLI が安全に統合できる通常の設定ファイルではありません。

codenodex setup --client cline は選択したキーを検証し、手動コピーする手順を表示します。Cline を変更済みであるかのような表示は行いません。

Cline 設定の API Provider で OpenAI Compatible を選択します。Base URL に https://token.codenodex.com/v1、API Key に自分の CodeNodex キー、Model ID にそのキーで利用できる実際のモデルを入力します。

Base URL にはプロトコルのルートパスだけを指定します。Cline はリクエスト時に個別の API パスを連結するため、手動で /chat/completions を追加するとパスが重複します。

Cline に Model not found と表示された場合、画面上の項目を何度も切り替えないでください。同じキーで /v1/models を取得し、返されたモデル ID をコピーしてから Cline に戻ります。

モデル一覧のリクエスト自体が失敗する場合、問題はキー、残高、ゲートウェイのエンドポイントにあり、Cline ではありません。

初回検証は、小さなファイル 1 つか読み取り専用の説明タスクに限定します。対話、ツール実行の承認、レスポンス出力が正常であることを確認してから、編集やコマンド実行へ段階的に広げます。

Cline には独立したツール権限と自動承認設定があります。API 接続が成功しても、すべての自動承認を有効にすべきとは限りません。リポジトリへの書き込みとターミナルコマンドは、引き続きリスクに応じて管理します。

401 ではキーが完全か、無効化されていないかを先に確認します。404 では Base URL と Model ID、429 では残高、同時実行数、レート制限を確認します。タイムアウトが続く場合は、短いタスクと curl リクエストを比較します。

モデルを変更して復旧した場合は、失敗したモデル、発生時刻、マスク済みのリクエスト情報を記録してから報告します。完全な API キー、プロジェクトコード、認証情報を含む Cline ログを公開しないでください。