Cline

Cline は、IDE で実行されるコーディングエージェントで、プロジェクトファイルの読み取り、コマンドの実行、および権限のあるコードの変更を行うことができます。 OpenAI 互換 Providerを構成すると、Cline は AGTCloud の Chat Completions 互換エンドポイントを使用できます。

このチュートリアルでは、Cline IDE 拡張機能を紹介します。モデルが異なれば、ツール呼び出し、画像入力、Computer Use、およびコンテキストの長さのサポート範囲が異なる場合があります。現在のAPI Keyで利用可能で、Chat Completions およびツール呼び出しをサポートしているモデルを選択してください。

事前準備

開始前に、次の項目を確認してください。

サポートされている VS Code 互換エディターまたは JetBrains IDE をインストールします。
AGTCloudに登録してログインします。
API Keys ページでトークンを作成します。
現在のトークンが利用可能であり、モデルマーケットプレイスから Chat Completions をサポートしているモデルIDをコピーします。
機密コードが含まれていないテストプロジェクトを準備します。

Clineをインストールする

使用している IDE に対応するインストール方法を選択してください。 Cline は、CLI、SDK、カンバンも提供します。このチュートリアルでは、これらのUsageについては詳しく説明しません。

初めて開いたときに Cline 認証または初期化プロンプトが表示された場合は、現在のバージョンのインターフェイスに従って完了してください。他のインストール方法については、Cline公式インストールドキュメントを参照してください。

AGTCloudを設定する

API設定を開く

Cline パネルを開き、設定アイコンをクリックして、API Configuration と開きます。設定項目の場所は、IDE と Cline のバージョン間で若干異なる場合があります。

互換性を選択 Provider

API Provider 内の OpenAI Compatible を選択します。組み込みの OpenAI Providerは選択しないでください。

接続情報を入力します

Cline フィールド	内容を入力してください
`API Provider`	`OpenAI Compatible`
`Base URL`	`https://api.agtcloud.cn/v1`
`OpenAI Compatible API Key`	`your-api-key`
`Model ID` または `Model`	`MODEL_ID`
`Custom Headers`	デフォルトでは空欄にする

your-api-key と MODEL_ID を独自のトークンとモデルID に置き換えてください。

確認して保存する

現在のバージョンに Verify ボタンがある場合は、最初に接続を確認してください。検証に合格したら、Done または現在のインターフェイスの [保存] ボタンをクリックして設定を完了します。

Base URL には /v1 が含まれている必要があります

Cline の OpenAI と互換性のある Provider には、完全な Base URL が必要です。 API Origin だけを入力したり、/v1/v1 を形成するために追加の /v1 を追加したりしないで、https://api.agtcloud.cn/v1 を使用してください。

モデルを選択して設定する

MODEL_ID は、実際のモデル名ではなく、置き換える必要があるプレースホルダーです。現在のAPI Keyで利用可能で、Chat Completions とツール呼び出しをサポートしているモデルIDをモデルマーケットプレイスからコピーしてください。

Cline のモデル設定では、コンテキストウィンドウ、最大出力トークン、イメージサポート、コンピューターの使用、入力価格、出力価格などの詳細オプションを提供する場合があります。初めて接続するときはデフォルト値を保持することをお勧めします。対象モデルの本当の制限と機能を理解している場合にのみ調整してください。

詳細設定はモデル機能のソースではありません

Cline での画像またはコンピュータ使用のサポートをチェックすると、その機能をまだ備えていないモデルが新しい機能を取得することはできません。価格フィールドは主に Cline のローカル使用量の見積もりに使用され、AGTCloud の最終的な請求結果を表すものではありません。

起動して接続を確認する

テストプロジェクトを開く

機密コードが含まれていないプロジェクトを使用し、安全に読み取れる README.md があることを確認してください。

自動承認はオフのままにしてください

初回確認ではAuto Approveを有効にしないでください。Clineがファイルの読み取り、コマンドの実行、コードの変更を行う前に、操作内容を確認して許可するか判断します。

読み取り専用タスクを開始する

Cline 入力ボックスに次のように送信します。

README.mdを読み、プロジェクトの目的を3点で要約してください。ファイルは変更しないでください。

チェック結果

Cline がファイルを読み取り、要約を正常に返し、許可していない変更を行っていなければ、基本的な接続を確認できます。この手順では通常の API 利用量が発生します。

よくある質問

現象	優先して確認する項目	対処方法
Cline拡張機能が見つからない	インストールソース、IDE の互換性、および再起動ステータス	Cline 公式拡張機能がインストールされていることを確認し、IDE をリロードまたは再起動します。
`Verify` 接続に失敗しました	ネットワークと Base URL	AGTCloud がローカルでアクセス可能であることを確認し、完全な `https://api.agtcloud.cn/v1` を使用します
`401` を返す	API Keyの内容とAPI Keyの状態	有効なAPI Keyを再度コピーします。入力された内容に余分なスペースが含まれていないことを確認してください。
`403` を返す	トークンの権限、モデルの権限、およびアカウントのステータス	コンソールで現在のアカウントのAPI Keyの状態とモデルの利用可能な範囲を確認します
`404` を返す	Base URL、重複した `/v1` とモデルID	`/v1/v1` が形成されていないことを確認し、完全なモデルIDを再コピーします。
対象モデルが見つからない	現在のAPI Keyで利用可能なモデルとプロトコルのサポート	現在のAPI Keyで利用可能で、Chat Completions をサポートするモデルを選択してください
会話は機能するがツールが失敗する	ツール呼び出し機能と詳細設定	ツール呼び出しをサポートするモデルに切り替えて、コンテキストと最大出力トークンの設定を確認します。
画像またはComputer Useに失敗しました	モデルが実際に対応している機能	Cline オプションだけに依存しないでください。対象モデルの実際の対応範囲によって異なります。
異常な結果または接続の中断	ネットワークプロキシ、モデルパラメーター、およびコンテキスト制約	まずデフォルトの詳細構成を復元してから、プロキシ、ファイアウォール、およびモデルコンテキストの制限を確認します。

特定できない問題が発生した場合は、リクエスト時間、モデルID、HTTP ステータス、および機密情報を除いたエラー情報を記録し、エラーとトラブルシューティングを確認してください。完全なAPI Keyを送信しないでください。

セキュリティ上の推奨事項

API Keyをプロジェクトファイル、Git リポジトリ、スクリーンショット、ログ、または共有設定に書き込まないでください。
本番環境の認証情報、プライベートデータ、または未公開のソースコードが含まれるプロジェクトに対して最初の検証を実行しないでください。
初回の確認では自動承認を無効のままにし、実行を許可する前に各操作を確認してください。
複数人でデバイスを共有する場合は、使用後にClineに保存されているAPI Keyをクリアしてください。