01. 環境構築とセットアップ

この資料は 2025 年 11 月時点での田中正吾の雑感として書いたものです。あくまでもハッカソンでザっと AI の連携を作れるようにするために、動かして進められるような説明用の資料とサンプル群を用意した次第です。

この教材をはじめる前に、開発環境を整えましょう。

おすすめ：Codespace で試す（すぐはじめられます）

この教材のサンプルコードは、GitHub Codespace で簡単に試せます。

Codespace とは？

GitHub が提供するクラウド開発環境です。ブラウザだけで開発できます。

  • Node.js がすでにインストール済み
  • エディタ（VS Code）も使える
  • 無料枠あり（月 60 時間）

Codespace の使い方

1. サンプルコードリポジトリにアクセス

https://github.com/1ft-seabass/hackathon-ai-and-mcp-sample-202511-codespace

2. Codespace を起動

「Code」ボタン → 「Codespaces」タブ → 「Create codespace on main」をクリック。

数分待つと、ブラウザ上で VS Code が起動します。

3. サンプルを実行

各サンプルディレクトリに移動して実行します。

cd 02_api-basics
npm install
node simple.js

4. API キーを設定

各サンプルファイルの先頭にある API キー設定箇所を、お使いの OpenAI API キーに書き換えます。

// OpenAI API キー
// お使いになる OpenAI API キーに差し替えましょう
const OPENAI_API_KEY = "OPENAI_API_KEY";

ここにあなたの OpenAI API キーを入力します。

OpenAI API キーの取得

ChatGPT API を使うために必要です。

知っておくと良いこと:

  • API キーは一度しか表示されません。後から確認できないので、コピーしたらどこかに保存しておきましょう
  • API キーは課金対象です。使用した分だけ料金が発生します
  • 無料枠もありますが、上限があります

ローカル環境で試す場合（任意）

自分の PC で直接開発したい場合は、以下の手順で環境を構築します。

準備するもの

  • Node.js (v18 以上)
  • OpenAI API キー
  • テキストエディタ（VS Code など）

Node.js のインストール

すでにインストール済みか確認

ターミナルで以下のコマンドを実行します。

node --version

v18.0.0 以上が表示されれば OK です。

まだインストールしていない場合

Node.js 公式サイトからダウンロードしてインストールします。

LTS（Long Term Support）版をおすすめします。

サンプルコードのクローン

git clone https://github.com/1ft-seabass/hackathon-ai-and-mcp-sample-202511-codespace.git
cd hackathon-ai-and-mcp-sample-202511-codespace

各サンプルディレクトリに移動して、依存関係をインストール:

cd 02_api-basics
npm install

API キーの設定

各サンプルファイルの先頭に、API キー設定箇所があります。

// OpenAI API キー
// お使いになる OpenAI API キーに差し替えましょう
const OPENAI_API_KEY = "OPENAI_API_KEY";

このように、直接ファイルに記述する形式になっています。

知っておくと良いこと:

  • API キーをファイルに直接書く場合、Git にコミットしないよう気をつけましょう
  • .gitignore でファイルを除外するか、環境変数を使う方法もあります

環境変数を使う場合（上級者向け）:

export OPENAI_API_KEY="your-api-key-here"

コード内では process.env.OPENAI_API_KEY で取得できます。

サンプルコードの実行

各サンプルは、以下のように実行します。

cd 02_api-basics
node simple.js

実行すると、結果がターミナルに表示されます。

トラブルシューティング

node: command not found

Node.js がまだインストールされていないようです。前述の手順でインストールしてみてください。

Error: Cannot find module 'openai'

依存関係がインストールされていないようです。サンプルディレクトリで npm install を実行してみてください。

Error: Incorrect API key provided

API キーが間違っているか、設定されていないようです。API キーを確認してみてください。

Error: You exceeded your current quota

API の使用量が上限に達しているようです。OpenAI のダッシュボードで使用状況を確認してみてください。

次のステップ

環境構築ができましたね。次は ChatGPT API の基本的な使い方を学んでいきましょう。