コンテンツにスキップ

はじめに(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_TOKENCOPILOT_CLI_PATHCOPILOT_CLI_URL)を使用します。Go 固有の 環境変数は追加しません。


次のステップ

環境が整ったので、チュートリアルを進めましょう。

  1. CLI チャットボット — 最初の Copilot 搭載 Go プログラムを構築する