{"meta":{"title":"GitHub Copilot CLI を設定して使用する","intro":"GitHub Enterprise Server インスタンスのモデルプロバイダーを構成し、Copilot CLIクライアントをインスタンスに接続します。","product":"エンタープライズ管理者","breadcrumbs":[{"href":"/ja/enterprise-server@3.22/admin","title":"エンタープライズ管理者"},{"href":"/ja/enterprise-server@3.22/admin/github-copilot","title":"GitHub Copilot"},{"href":"/ja/enterprise-server@3.22/admin/github-copilot/copilot-cli","title":"Copilot CLI"},{"href":"/ja/enterprise-server@3.22/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli","title":"セットアップと使用 Copilot CLI"}],"documentType":"article"},"body":"# GitHub Copilot CLI を設定して使用する\n\nGitHub Enterprise Server インスタンスのモデルプロバイダーを構成し、Copilot CLIクライアントをインスタンスに接続します。\n\n> \\[!NOTE]\n> この機能はテクニカルプレビューであり、変更される可能性があります。\n\nCopilot CLI Cloud に接続できない、または接続しない分離環境やエアギャップ環境でも、GitHub を GitHub Enterprise Server と連携して動作するように構成できます。管理者はインスタンスのモデルプロバイダーを構成し、ユーザーはGitHub Enterprise Server資格情報を使用してCopilot CLIに接続します。\n\nこの機能の設定には、次の 2 つのロールが含まれます。\n\n* **管理者**: `ghe-config`を使用して、GitHub Enterprise Server インスタンスでモデルプロバイダーを構成します。これは、管理 SSH アクセスが必要な 1 回限りのセットアップです。\n* **エンドユーザー**: Copilot CLI をインスタンスに接続するように、ローカルコンピューター上の環境変数を設定します。\n\n## 前提条件\n\n* GitHub Enterprise Server インスタンスへの管理 SSH アクセス権があります。\n* サポートされている LLM プロバイダーの API キーがあります。\n* Copilot CLI はクライアントコンピューターにインストールされます。「[GitHub Copilot CLI のインストール](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli)」を参照してください。\n* GitHub CLI (`gh`) がクライアントコンピューターにインストールされます。\n [\n ](https://cli.github.com/manual/)ドキュメント内のGitHub CLIを参照してください。\n\nサポートされているプロバイダーとモデルの要件については、 [GitHub Copilot CLI での独自の LLM モデルの使用](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models) を参照してください。\n\n## GitHub Enterprise Server インスタンスの構成\n\nこの手順は、 GitHub Enterprise Server インスタンスのオペレーターまたは管理者を対象とします。\n\nGitHub Enterprise Server インスタンスへの管理 SSH アクセスを使用して、次の`ghe-config`値を使用してモデルプロバイダーを構成します。構成後、 `ghe-config-apply` を実行して変更を適用します。\n\n| 変数名 | 必須 | オプション | Description |\n| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------- |\n| `app.copilot-proxy.enabled` | はい | | |\n| `true`、`false` | この機能を有効または無効にします。 | | |\n| `app.copilot-proxy.endpoint-url` | はい | URI | 任意のバージョンプレフィックス (たとえば、 `https://api.openai.com/v1`) を含む完全なアップストリームベース URL。 |\n| `secrets.copilot-proxy.endpoint-key` | はい | String | アップストリームプロバイダーの API キー。 |\n| `app.copilot-proxy.provider-model-id` | はい | String | |\n| Copilot CLIが内部的にモデルを検索するために使用するプロバイダーモデル ID。 | | | |\n| `app.copilot-proxy.provider-type` | はい | | |\n| `openai`、`azure`、`anthropic` | プロバイダーの種類。 OpenAI には、OpenAI、Ollama、vLLM、Foundry Local、およびその他の OpenAI Chat Completions API 互換エンドポイントが含まれます。 | | |\n| `app.copilot-proxy.upstream-timeout` | いいえ | 整数 (秒単位) | アップストリーム要求の読み取り/送信タイムアウト (秒単位)。設定されていない場合は、既定のタイムアウトにフォールバックします。 |\n| `app.copilot-proxy.provider-wire-api` | いいえ | | |\n| `completions`、`responses` | プロバイダーのワイヤ API 形式。 | | |\n| `app.copilot-proxy.provider-wire-model` | いいえ | String | 内部モデル ID と異なる場合、アップストリームプロバイダーに送信されるモデル識別子をオーバーライドします。 |\n| `app.copilot-proxy.enable-upstream-probe` | いいえ | | |\n| `true`、`false` | スタートアップアップストリームプローブを有効または無効にします。デフォルトでは有効になっています。無効にすると、スタートアッププローブはスキップされます。 | | |\n\nたとえば、次のコマンドは OpenAI プロバイダーを構成します。\n\n```shell\nghe-config app.copilot-proxy.enabled true\nghe-config app.copilot-proxy.endpoint-url 'https://api.openai.com/v1'\nghe-config secrets.copilot-proxy.endpoint-key 'YOUR-API-KEY'\nghe-config app.copilot-proxy.provider-model-id 'gpt-5.5'\nghe-config app.copilot-proxy.provider-wire-model 'gpt-5.5'\nghe-config app.copilot-proxy.provider-type openai\nghe-config app.copilot-proxy.upstream-timeout 300\nghe-config app.copilot-proxy.enable-upstream-probe false\nghe-config-apply\n```\n\n構成を適用する前に、 `YOUR-API-KEY` を実際の API キーに置き換えます。\n\n## Copilot CLI クライアント (エンドユーザー) の構成\n\nCopilot CLIを開始する前に、次の環境変数を設定して、GitHub Enterprise Server インスタンスに接続するようにCopilot CLIを構成します。\n\n| 環境変数 | 必須 | Description |\n| ------------------------------------------------------------------------------------ | -- | ----------------- |\n| `COPILOT_PROVIDER_GHES_HOST` | はい | |\n| GitHub Enterprise Server インスタンスのホスト名。 | | |\n| `COPILOT_PROVIDER_GHES_TOKEN` | はい | |\n| personal access token インスタンス用の GitHub Enterprise Server。このトークンは、インスタンスに対する要求を認証します。 | | |\n| `COPILOT_OFFLINE` | はい | オフラインモードを有効にします。 |\n| GitHub Enterprise Server プロバイダーは、オフラインモードが有効になっている場合にのみアクティブです。 | | |\n\n## クライアント (エンドユーザー) トークンについて\n\nCopilot CLI は LLM 推論にアクセスする必要があるため、 `COPILOT_PROVIDER_GHES_TOKEN` は常に必要です。また、GitHub で Issue の作成、プルリクエスト、リポジトリの検索などの Copilot CLI 操作を実行する必要が生じる可能性も高いでしょう。このような操作は、 GitHub CLIを介して実行できます。\n\n`gh auth login --hostname YOUR-GHES-HOSTNAME`を実行することをお勧めします。成功したら、次の手順では、`gh auth login --hostname YOUR-GHES-HOSTNAME`で生成されたトークンに`COPILOT_PROVIDER_GHES_TOKEN`を設定します。トークンを `~/.config/gh/hosts.yml`からコピーするのではなく、動的に取得する方が安全です。これを行うには、 `COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`を使用します。\n\nまたは、GitHub Enterprise Server インスタンスでpersonal access tokenを生成し、そのトークンを`COPILOT_PROVIDER_GHES_TOKEN`として設定し、`gh auth login --hostname YOUR-GHES-HOSTNAME`の実行時に同じトークンを使用することもできます。\n\n上記のアプローチは、 Copilot CLI を対話形式で使用する場合に機能します。自動化のためには、いくつかの操作を異なる方法で行う必要があります。\n\n* `GH_ENTERPRISE_TOKEN` (または`GITHUB_ENTERPRISE_TOKEN`) をpersonal access tokenに設定します。\n* `GH_HOST`をサーバーのホスト名に設定します。\n* 同じホストに対して `GH_ENTERPRISE_TOKEN` 資格情報と `gh auth login` 資格情報の両方が存在する場合は、環境変数が優先されます。\n\n## 推奨されるエンドユーザーのセットアップ\n\n1. GitHub CLIを認証します。\n\n ```shell\n gh auth login --hostname YOUR-GHES-HOSTNAME\n ```\n\n2. Copilot CLIに必要な環境変数を設定します。\n\n ```shell\n export COPILOT_PROVIDER_GHES_HOST=YOUR-GHES-HOSTNAME\n export COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n export COPILOT_OFFLINE=true\n ```\n\n`gh auth login`で複数のアカウントに認証されている場合は、サーバーのホスト名に`GH_HOST`を設定し、`GH_ENTERPRISE_TOKEN` (または`GITHUB_ENTERPRISE_TOKEN`) を`\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`に設定できます。これにより、GitHub Enterprise Server はお使いの GitHub CLI インスタンスをターゲットにします。\n\n```shell\nexport GH_HOST=YOUR-GHES-HOSTNAME\nexport GH_ENTERPRISE_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n```\n\n1. Copilot CLI を起動します。\n\n```bash\ncopilot\n```\n\nこのセットアップ全体をスクリプトとして実行できます。\n\n## 例示\n\nGitHub Enterprise ServerとCopilot CLIの両方の構成が正しい場合は、Copilot CLI セッションに次のような応答が表示されます。\n\n```shell\n • fabric-core-mcp — disabled\n • powerbi-mcp — disabled\n • slack — connected\n\n ● Current model: gpt-5.5\n\n ❯ Hello 13:31\n\n ● Hello!\n\n ❯ what is going on in github/codeql-action repo? 13:33\n\n ● I’ll check recent repository activity on the GHES host: repo metadata, open \n PRs/issues, and latest commits.\n\n $ Shell Fetch repo metadata 2 lines… 5s\n gh api --hostname \"$GH_HOST\" repos/github/codeql-action --jq '{name_with_own…\n```\n\n## でサポートされている機能 GitHub Enterprise Server\n\nCopilot CLI 機能に関する最新情報については、信頼できる第一の情報源として [GitHub Copilot CLI](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli) を参照してください。一般に、 GitHub クラウドサービスへの接続に依存する機能は、 GitHub Enterprise Server オフライン構成では使用できません。\n\n次の表は、GitHub Enterprise Server の提供内容の大まかな概要を示しています。\n\n| 能力 | GitHub / GitHub Enterprise Cloud | GitHub Enterprise Server |\n| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| AI 支援コーディング (プロンプト、コード生成、デバッグ) | | |\n| シェルコマンドとファイル操作 | | |\n| GitHub | | |\n| `gh` CLI による操作（Issue、PR、リポジトリ） | | |\n| （そのインスタンスに対して認証済みの `gh` CLI が必要です） | | |\n| GitHub MCP サーバーツール | | |\n| Web 検索と Web フェッチ | | |\n| Copilot モデルの選択 (GitHub ホスト型モデル) | | |\n| テレメトリと使用状況レポート | | |\n| 自動更新 | | |"}