Qodoをコーディングエージェント（プログラム開発を支援するAI）内にセットアップする — 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 つの読み取り専用ツールを呼び出します。カタログが見えるからといって、読み取りアクセス権があるとは限りません。実行前に isError をチェックし、その後 structuredContent を確認してください。実行エラーはセットアップが完了していない状態です。読み取りは書き込み権限を証明しません。書き込みについては、ユーザーが許可するまで検証未了として報告してください。テスト書き込みは絶対に行わないでください。ホストと QAR が MCP の認証を管理します。
ツール欠落、MT-AUTH-FORBIDDEN、接続エラーは MCP アクセスの問題として報告し、API キーの提供を求めないでください。MCP のみのセットアップの場合は、確認済みのアクセス範囲を報告してここで終了します。以下の CLI の手順はすべてスキップしてください。CLI アクセスが要求されたか、ローカル収集に必要な場合だけ、同じデプロイメント環境で続行してください。
このインストール済み SKILL.md ディレクトリを基準として references/... のリンクを解決してください。実行時またはログイン設定だけでは、エンタープライズインストールやメンテナンスの権限は与えられません。エンタープライズインストールが要求された場合は、承認前にパッケージとメンテナンス内容を明示し、ユーザーの取り消し権、編集権、所有者、オプションパッケージの選択を保持してください。
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 による自動翻訳です。