Qodo を開発支援エージェント（コードを書く際の補助機能）にセットアップする — CLI（コマンドラインツール）のインストール、サインイン、ツールの確認を行います。 次のような場合に使用: プラグインのインストール後、セットアップのリクエストがあった時、または Qodo スキルが CLI やログイン情報の不足を検出した場合。
Set up Qodo in a coding agent — install the CLI, sign in, and verify tools. Use after plugin installation, on setup requests, or when a Qodo skill finds a missing CLI or login.
利用可能な Qodo パスを確認します。スキルをインストールしたからといって、アカウントやツールへのアクセスが保証されるわけではありません。
CLI（コマンドライン）セットアップ用のシェル、またはホスト接続型の QAR MCP サーバーが必要です。認証情報は絶対に取り扱いません。
接続済みの QAR ツールスキーマと注釈を確認します。無害な入力で読み取り専用ツールを1つ呼び出し、ツール一覧の表示有無で読み取りアクセスを判定しません。structuredContent の前に isError を確認してください。実行エラーは準備ができていることを示しません。読み取りは書き込み権限を証明できないため、ユーザー認可アクション まで書き込みは未検証として報告してください。テスト書き込みは絶対に行わないでください。MCP 認証はホストと QAR が所有しています。ツール不足、MT-AUTH-FORBIDDEN、接続エラーは MCP アクセス問題として報告し、API キーを求めてはいけません。MCP のみのセットアップの場合は、確認済みのアクセス範囲を報告してここで終了します。以下の CLI ステップをすべてスキップしてください。CLI アクセスが要求された場合、または同じデプロイメントを使用してローカル収集が必要な場合のみ続行します。
references/... リンクは、このインストール済み SKILL.md ディレクトリを基準に解決してください。実行時・ログインセットアップは、エンタープライズインストールまたはメンテナンスの権限を与えません。エンタープライズインストール要求の場合は、承認前にパッケージとメンテナンスを明示し、外すオプション、編集、所有者、オプションパッケージの選択肢を保持してください。
PowerShell では、runtime.md で検証済みのネイティブ・Node 呼び出しを先に解決してください。以下の qodo はその呼び出しを表します。POSIX では PATH を直接プローブします：
qodo --version
POSIX で見つからない場合は "${QODO_HOME:-$HOME/.qodo}/bin/qodo" --version を試してください。ランタイムが見つからない、古い、または解析不可の場合は、リファレンスに従います。セットアップリクエストはホスト承認の対象となるインストールをカバーしており、プラグインインストール単独では対象になりません。選択したデプロイメントを保持します。
実行ファイルを <qodo> として保持します。認証前に Qodo CLI バージョン 1.6.0 以上が必要です。
以下を実行します：
<qodo> read whoami --json --skill qodo-setup --skill-version 1.0.10 --distribution marketplace --host claude-code
成功した本人確認を再利用します。失敗した場合は、ログイン前に authentication.md を読んでください。
クラウドの場合、ログアウト時に <qodo> login を実行します。顧客デプロイメントでは、ドキュメント化されたログインエンドポイントを保持し、クラウドにフォールバックしないでください。ログイン完了を待ち、本人確認を再度実施します。
成功した実行コンテキストを再利用し、各必須のホスト承認をリクエストします。診断承認は包括的な権限ではありません。キャンセルまたは権限拒否で停止します。
本人確認に成功した後のみ、以下を実行します：
<qodo> tools --refresh --json --skill qodo-setup --skill-version 1.0.10 --distribution marketplace --host claude-code
使用可能なツール一覧と、タスクに必要な機能を要求します。関連のないツールはアクセス権を確立しません。リフレッシュに失敗した場合は、ログインは成功したがツールが利用不可であることを報告し、正確なエラーと <qodo> tools --refresh を再試行として提示します。ツール一覧の失敗でもう一度ログインしないでください。
CLI は認証情報、通信、ランタイム更新を管理し、パッケージのライフサイクル所有者がスキルを更新します。QODO_NOTICE 更新または繰り返される Kiro 読み取り承認については、host-recovery.md は発生時にのみ参照してください。
実際のエラーと次のアクション1つを提示してください。本人確認失敗、ログインキャンセル、またはツール一覧利用不可後に準備完了を報告しないでください。セットアップ完了のため、キーチェーン無効化、認証情報コピー、ホストアクセス権限ファイル変更、または無制限コマンド承認の提示をしないでください。
Qodo 接続と関連ツール準備を確認してから、認可されたタスクに戻ります。準備確認は後続のツール呼び出し成功を証明しません。オプションの Standards をインストールしないでください。
Verify the available Qodo path. Skill installation does not prove account or tool access.
A shell for CLI setup or a host-connected QAR MCP server. Never handle credentials.
Inspect connected QAR tool schemas and annotations. With harmless input, call one
read-only tool; catalog visibility does not prove read access. Check isError before
structuredContent; an execution error is not readiness. A read cannot prove write
authorization: report writes as unverified until a user-authorized action. Never make
a test write. The host and QAR own MCP auth. Report missing tools, MT-AUTH-FORBIDDEN,
and connection errors as MCP access issues; never ask for an API key. For MCP-only setup,
report the verified scope and hand off here. Skip every CLI step below. Continue only if CLI access was
requested or is needed for local collection, using the same deployment.
Resolve references/... links relative to this installed SKILL.md directory.
Runtime/login setup does not authorize enterprise installation or maintenance.
For requested enterprise installs, disclose packages and maintenance before approval;
preserve opt-outs, edits, owners and optional-package choices.
In PowerShell, resolve the verified native/Node invocation in runtime.md
first; qodo below represents that invocation. On POSIX, probe PATH directly:
qodo --version
If missing on POSIX, try "${QODO_HOME:-$HOME/.qodo}/bin/qodo" --version.
For a missing, old or unparseable runtime, follow the reference. Setup requests cover installation subject
to host approvals; plugin installation alone does not. Retain the selected deployment.
Keep the executable as <qodo>. Require Qodo CLI 1.6.0 or newer before authentication.
Run:
<qodo> read whoami --json --skill qodo-setup --skill-version 1.0.10 --distribution marketplace --host claude-code
Reuse a successful identity check. On failure, read authentication.md before choosing login.
For Cloud, run <qodo> login when signed out. For customer deployments, preserve the
documented login endpoint; never fall back to Cloud. Wait for login, then recheck identity.
Reuse the successful execution context, requesting each required host approval. A diagnostic approval is not blanket permission. Stop on cancellation or denied permission.
Only after identity succeeds, run:
<qodo> tools --refresh --json --skill qodo-setup --skill-version 1.0.10 --distribution marketplace --host claude-code
Require a usable catalog and the task's capability; unrelated tools do not establish access.
If refresh fails, report that sign-in succeeded but tools are unavailable, with the exact error
and <qodo> tools --refresh as the retry. Do not log in again for a catalog failure.
The CLI owns credentials, transport and runtime updates; the package's
lifecycle owner updates skills. For QODO_NOTICE updates or repeated Kiro read approvals,
read host-recovery.md only when encountered.
Give the actual error and one next action. Never report readiness after a failed identity, canceled login or unavailable catalog. Never disable the keychain, copy credentials, change host permission files, or offer unrestricted command approvals to make setup pass.
Confirm Qodo connection and relevant tool readiness, then return to the authorized task. Readiness does not prove a later tool call succeeds. Do not install optional Standards.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。