목차8개 섹션
2026年9月時点の資料に基づくガイドです。料金、モデル、画面の名称は変更される場合があります。リアルタイムの製品情報ではありません。
インストール、ログイン、モデル、拡張機能、MCPの実用的な切り分け手順。
インストール・起動の失敗
公式センターでOSとアーキテクチャを合わせ、再試行前にエラーを記録します。Linuxは配布形態に合うパッケージを選びます。macOSの古いIntelインストーラーが現在も対応するとは限りません。
ログイン・ネットワークのエラー
公式サイトでログインできるか確認します。時刻とエラーコードを記録し、プロキシ、VPN、組織のポリシーを調べます。アカウントとローカルの問題を切り分けるまで、再インストールを繰り返さないでください。
モデルが使えない・トークン上限に達した
プラン、残量、モデル選択を確認し、短い新規会話を試します。利用枠切れは再インストールでは直りません。追加支出を有効にする前に料金と利用制御を確認してください。
MCPサーバーが起動しない
JSON、IDEからの実行ファイル参照、サーバーログを確認します。npxが動くシェルとデスクトップアプリではPATHが違う場合があります。MCPガイドの手順で調べてください。
拡張機能・インデックスの問題
小さなプロジェクトで疑わしい拡張機能を一時停止し、原因を調べます。作業領域の大きさと生成物の除外を確認してください。リセット前に設定を保存し、サポート向けに最小再現例を用意します。
サポートへの報告内容
クライアント版、OS、アーキテクチャ、地域、プラン、最小再現例、機密情報を除いたログを添えます。確認せずにトークン、環境ファイル、非公開コードを共有しないでください。
最初の実作業：変更、検証、レビュー
-
すでにビルドできる小さなリポジトリを選び、Gitで作業前の状態を保存します。現在成功する検証コマンドを記録して基準にします。
-
既存フォームへの必須項目追加など、観察可能な結果を一つ指定します。対象ファイル、既存の検証処理、維持すべき動作も伝えます。
-
編集前に短い計画を確認し、影響するコンポーネント、データの流れ、検証方法を確かめます。不足する文脈を埋めてから実装に進みます。
-
差分を少しずつ確認し、依存関係、生成ファイル、環境変数、例外処理も点検します。正常系と異常系の両方を試します。
-
完了後に利用量とレビュー時間を記録します。別の代表的タスクでも試してから、有料プランやチーム移行を判断します。
調整して使えるタスク説明
目標：利用者から見える変更。
文脈：対象ファイルと既存実装。
制約：公開APIと既存依存関係を維持。
検証：プロジェクトのチェックと異常系。
完了条件：変更ファイル、実行した検証、残る制限を報告。結果が使えない場合の切り分け
応答の成功とコードの正しさは別です。違うファイルを変更したら範囲と入口を明示します。コマンドが失敗したら同じ端末環境で再現します。MCPは起動、認証、クライアント設定を分けて調べます。利用上限に達したら残量とモデルを確認します。無関係な変更を失わず戻せる大きさに差分を保ちます。
移行前によくある質問
有料プランならエージェントを無制限に使えますか？
いいえ。月額、含まれる利用量、モデル権限、追加利用料は別です。補完が無制限でもモデル要求が無制限とは限りません。
MCPを最初から全部接続しますか？
現在のタスクに必要な一つから始め、起動、ツール、渡す文脈を確認して順に追加します。
エディタを公平に比較するには？
同じリポジトリ、タスク、検証基準で、正しい変更、レビュー負担、設定の手間、実際の利用量を比べます。
TRAEの関連記事
계속 읽기
같은 주제와 도구에 연결된 글입니다.
