Skip to main content
はじめに

サインインと認証

概要

Qoder を使用する前に、認証を完了する必要があります。初めてコマンドを実行する際、Qoder CLI は自動的にサインインを促します。 Qoder CLI は Qoder 独自の認証システムを使用しており、主に以下の2つの認証方法を提供します。
  • インタラクティブ サインイン（推奨）：ターミナルでブラウザ経由またはトークンを貼り付けてサインインを完了します。日常的なローカル環境での使用に適しています。
  • 環境変数：Personal Access Token を使用して認証します。CI/CD パイプラインやブラウザのない自動化環境に適しています。

インタラクティブ サインイン

ターミナルで Qoder CLI を起動し、インタラクティブプロンプトに /login と入力します。 
# ターミナルで Qoder CLI を起動します
qoder

# 対話型プロンプトで /login を入力します
/login
その後、必要なサインイン方法を選択します。
  • Login with Qoder Platform (Browser)：ブラウザウィンドウを開き、Qoder アカウントを使用して認証を完了します。
  • Use Qoder Personal Access Token (QODER_PERSONAL_ACCESS_TOKEN)：Qoder の設定で生成したトークンを使用して、QODER_PERSONAL_ACCESS_TOKEN 環境変数を設定します。
選択後、Qoder CLI が残りの手順を案内します。
/login の代わりにエイリアス /signin を使用することもできます。

ブラウザを自動的に開けない場合

グラフィカルインターフェースのない環境では、Qoder CLI はブラウザの起動を自動的にスキップし、サインイン画面にサインイン URL が直接出力されます。その URL を手動でコピーしてブラウザで開けば認証を完了できます。以下のいずれかの条件を満たす場合、グラフィカルインターフェースのない環境と見なされます。
  • CI が設定されている
  • BROWSER=www-browser
  • DEBIAN_FRONTEND=noninteractive
  • SSH セッション内である（SSH_CONNECTION）
  • Linux で DISPLAY、WAYLAND_DISPLAY、MIR_SOCKET のいずれも設定されていない
そのため、リモートサーバー、コンテナ、CI 環境では追加の設定は不要です。ブラウザの起動に失敗した場合も、同様に画面に出力された URL を手動でコピーできます。

トークンの自動更新

ブラウザでのサインインが完了すると、Qoder CLI はバックグラウンドでトークンを自動的に更新するため、日常的な使用において手動で再サインインする必要はありません。

Personal Access Token の使用

非対話セッションや自動化環境（CI/CD パイプラインなど）では、Personal Access Token（PAT）を使用して認証できます。

トークンの取得

以下のページで Personal Access Token を作成および管理します。
https://qoder.com/account/integrations

環境変数による認証

トークンを QODER_PERSONAL_ACCESS_TOKEN 環境変数に設定します。 
# Linux / macOS の例
export QODER_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

# Windowsの例（コマンドプロンプト）。引用符で囲まないでください。CMDが引用符を変数値に含めてしまうためです。
set QODER_PERSONAL_ACCESS_TOKEN=your_personal_access_token_here

# Windowsの例（PowerShell）
$env:QODER_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"
設定後、Qoder CLI は PAT を使用して自動的に認証を完了します。
QODER_PERSONAL_ACCESS_TOKEN 環境変数の設定と /login でのサインインの両方を行っている場合、認証は環境変数の PAT を優先的に使用します。/login で保存された資格情報を使用するには、先にこの環境変数をクリアする必要があります。

認証関連の環境変数

環境変数説明
QODER_PERSONAL_ACCESS_TOKENPersonal Access Token。設定すると PAT 認証が自動的に使用されます
QODER_CONFIG_DIRカスタム構成ディレクトリ。デフォルトは ~/.qoder です

認証ステータスの確認

インタラクティブセッションで /status と入力すると、Usage と Status の2つのタブを含むステータスパネルが開きます。Usage は現在のセッションの API クォータとトークン使用量（プランタイプ、クォータ使用量、セッション時間、コード変更総量など）を表示し、Status は現在の CLI のステータス情報を表示します。認証に問題があると思われる場合、これが最も直接的なトラブルシューティングの入口となります。

サインアウト

Qoder からサインアウトする必要がある場合は、インタラクティブプロンプトに /logout と入力します。 
# 対話型プロンプトで /logout と入力します
/logout
/logout の代わりにエイリアス /signout を使用することもできます。サインアウト時には確認が求められます。
QODER_PERSONAL_ACCESS_TOKEN 環境変数を使用して認証を完了した場合、/logout を実行する前に必ずその環境変数をクリアしてください。そうしないと、次回の起動時にそのトークンを使用して自動的にサインインされます。

よくある質問

  • ブラウザが自動的に開かない：グラフィカルインターフェースのない環境では CLI がブラウザの起動を自動的にスキップします。サインイン画面に出力された URL を手動でコピーしてブラウザで開いてください。
  • サインインのコールバックが失敗するか、長時間応答がない：ローカルネットワークから Qoder サービスにアクセスできることを確認し、必要に応じてプロキシ設定を確認してください。ネットワーク、プロキシ、VPCを参照してください。
  • PAT が無効または期限切れ：アカウント統合ページに移動してトークンを再生成し、QODER_PERSONAL_ACCESS_TOKEN を更新してください。
その他のトラブルシューティング手順については、サインインと認証の問題を参照してください。
はじめに
コアコンセプト
Qoder CLI を使用する
Qoder CLI の拡張
リモートと統合
設定とセキュリティ
リファレンス
トラブルシューティング