コマンドライン用の Amazon Q をインストールする - Amazon Q Developer
macOSLinux AppImageUbuntuアンインストールデバッグ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

コマンドライン用の Amazon Q をインストールする

Amazon Q アプリケーションのファイルダウンロードを開始することで、macOS のコマンドラインに Amazon Q をインストールできます。詳細については、「サポートされているコマンドライン環境」を参照してください。

コマンドラインに Amazon Q をインストールするときに考慮すべき 2 つのモダリティがあります。最小インストールでは、Linux for Amazon Q チャットおよびオートコンプリート機能が SSH (q および ) 経由で機能するために必要なバイナリのみが分散されますqterm。フルディストリビューションにはデスクトップアプリケーションが含まれており、オートコンプリート機能を使用する必要があります。Amazon Q チャットのみを使用する場合は、最小ディストリビューションもシェルqtermに出荷およびインストールされることを考慮してください。qterm for zsh を使用してインライン補完をサポートでき、フルバージョンは必要ありません。詳細については、「zip ファイルを使用した のインストール」を参照してください。

注記

Windows で Amazon Q CLI を使用する方法については、dev.to のブログ記事を参照してください。

macOS

Amazon Q for macOS は、アプリケーションをダウンロードするか、Homebrew を使用してインストールできます。

macOS のコマンドラインに Amazon Q をインストールした後、SSH 統合を有効にして、500 を超えるコマンドラインツールでオートコンプリートを使用できます。詳細については、「ローカル macOS 統合」を参照してください。

macOS のコマンドラインに Amazon Q をインストールするには

  1. macOS のコマンドライン用に Amazon Q をダウンロードします。

  2. （オプション) macOS のコマンドライン用に Amazon Q 用にダウンロードしたファイルを確認します。詳細については、「ダウンロードを検証するには (オプション）」を参照してください。

  3. ダウンロードした .dmg ファイルをダブルクリックし、アプリケーションをアプリケーションフォルダにドラッグします。

  4. アプリケーションフォルダで、Amazon Q をダブルクリックします。GUI が開きます。

  5. シェル統合を有効にします。これにより、シェルから Amazon Q を実行でき、Amazon Q はシェルコマンドの自動補完に役立ちます。

  6. Builder ID または IAM アイデンティティセンターで、アカウント管理者から提供された開始 URL を使用して認証を行います。

  7. 手順に従ってシェル統合をインストールし、macOS アクセシビリティアクセス許可を付与します。

    Interface showing automated checks with Shell integrations enabled and accessibility disabled.

Linux AppImage

警告

このインストール方法には GUI が必要です。GUI を使用せずに Linux にインストールする場合は、zip ファイルを使用した のインストール「」を参照してください。

Amazon Q for Linux のコマンドラインは、AppImage 形式を使用してインストールできます。AppImage 形式は、インストールを必要とせずにほとんどの Linux ディストリビューションで動作するポータブル形式です。

AppImage を使用して Linux のコマンドラインに Amazon Q をインストールするには

  1. Linux AppImage のコマンドライン用に Amazon Q をダウンロードします。

  2. AppImage を実行可能にします。

    chmod +x amazon-q.appimage

  3. AppImage を実行します。

    ./amazon-q.appimage

  4. Builder ID または IAM アイデンティティセンターで、アカウント管理者から提供された開始 URL を使用して認証を行います。

Ubuntu

警告

このインストール方法には GUI が必要です。GUI を使用せずに Linux にインストールする場合は、zip ファイルを使用した のインストール「」を参照してください。

.deb パッケージを使用して、Ubuntu のコマンドラインに Amazon Q をインストールできます。

Ubuntu のコマンドラインに Amazon Q をインストールするには

  1. Ubuntu のコマンドライン用に Amazon Q をダウンロードします。

    wget https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb

  2. パッケージをインストールします。

    sudo apt-get install -f
sudo dpkg -i amazon-q.deb

  3. コマンドライン用に Amazon Q を起動します。

    q

  4. Builder ID または IAM アイデンティティセンターで、アカウント管理者から提供された開始 URL を使用して認証を行います。

コマンドライン用の Amazon Q をアンインストールする

不要になった場合は、Amazon Q for コマンドラインをアンインストールできます。

macOS で Amazon Q for コマンドラインをアンインストールするには

  1. Finder で Applications フォルダを開きます。

  2. Amazon Q アプリケーションを見つけます。

  3. アプリケーションをゴミ箱にドラッグするか、右クリックして「ゴミ箱に移動」を選択します。

  4. ゴミ箱を空にしてアンインストールを完了します。

Ubuntu で Amazon Q for コマンドラインをアンインストールするには

  1. apt パッケージマネージャーを使用してパッケージを削除します。

    sudo apt-get remove amazon-q

  2. 残りの設定ファイルをすべて削除します。

    sudo apt-get purge amazon-q

コマンドライン用の Amazon Q Developer のデバッグ

コマンドラインで Amazon Q Developer に問題がある場合は、 q doctorを実行して一般的な問題を特定して修正します。

正常な出力

$ q doctor

✔ Everything looks good!

Amazon Q still not working? Run q issue to let us know!

出力が期待どおりの出力に見えない場合は、プロンプトに従って問題を解決します。それでも機能しない場合は、 を使用してバグq issueを報告します。

一般的な問題

コマンドラインに Amazon Q を使用する場合に発生する可能性がある一般的な問題は次のとおりです。

認証の失敗

認証に問題がある場合は、 q login を実行して再認証してみてください。

オートコンプリートが機能しない

を実行して、シェル統合が正しくインストールされていることを確認しますq doctor。

SSH 統合の問題

必要な環境変数を受け入れるように SSH サーバーが正しく設定されていることを確認します。

トラブルシューティングのステップ

コマンドラインで Amazon Q に関する問題をトラブルシューティングするには、次の手順に従います。

  1. を実行してq doctor、一般的な問題を特定して修正します。

  2. インターネット接続を確認してください。

  3. サポートされている環境を使用していることを確認します。詳細については、「サポートされているコマンドライン環境」を参照してください。

  4. コマンドラインに Amazon Q を再インストールしてみてください。

  5. 問題が解決しない場合は、 を使用して報告しますq issue。