はじめに(Go)
このガイドでは、Go 固有 のセットアップ—CLI のビルドとチュートリアルサブコマンドの 実行—を説明します。Copilot CLI のインストールと GitHub 認証—すべての言語版で共通—に ついては、まず共通の はじめに ガイドに従ってください。
前提条件
| 要件 | 最小バージョン | 用途 |
|---|---|---|
| Go | 1.26+ | ランタイムとビルドツールチェーン |
| GNU Make | 最新 | ビルドターゲット |
Node.js (npm) または GitHub CLI (gh) |
最新 | Copilot CLI のインストール |
| GitHub Copilot サブスクリプション | — | API アクセスに必須 |
Go ツールチェーンを確認します。
go version # go1.26 以降
CLI をビルドする
チュートリアルサブコマンドは Go CLI の一部です。プロジェクトの Makefile でビルドします。
cd src/go
# CLI を ./dist/ にビルド
make build
# 利用可能なチュートリアルサブコマンドを表示
./dist/template-github-copilot-go tutorial --help
これらのサブコマンドは別途起動した Copilot CLI サーバーを必要としません — SDK が stdio 経由でオンデマンドに起動します。すでに TCP モードで稼働中の Copilot CLI がある場合のみ --cli-url host:port を使用します(CLI サーバーモード を参照)。
最初のサブコマンドを実行する
cd src/go
./dist/template-github-copilot-go tutorial chat-bot --prompt "What is GitHub Copilot?"
期待される出力(ストリーミング):
GitHub Copilot is an AI-powered coding assistant developed by GitHub and OpenAI...
グローバルフラグ
ルートコマンドはグローバルな --verbose/-v フラグ(すべてのサブコマンドが継承)を公開します。これはログレベルを DEBUG に下げ、Copilot クライアントの接続モードやセッションのライフサイクルといった診断ログを表示します。
./dist/template-github-copilot-go tutorial chat-bot --verbose --prompt "Hello!"
プロジェクト構成
src/go/cmd/tutorial/
├── README.md # サブコマンド一覧(このドキュメントへのポインタ)
├── tutorial.go # `tutorial` 親コマンドグループ
└── chatbot.go # チュートリアル 1: CLI チャットボット(chat-bot サブコマンド)
環境変数
Go CLI は、共通の はじめに で説明している共通の Copilot 変数
(COPILOT_GITHUB_TOKEN、COPILOT_CLI_PATH、COPILOT_CLI_URL)を使用します。Go 固有の
環境変数は追加しません。
次のステップ
環境が整ったので、チュートリアルを進めましょう。
- CLI チャットボット — 最初の Copilot 搭載 Go プログラムを構築する