環境構築:SDK・認証・開発環境

AI Navigate Original / 2026/5/16

共有:

要点

  • Node.js/Python で LLM API の最小環境を整える
  • ランタイム導入・プロジェクト作成・.env+dotenv・初回コード
  • キーは環境変数、Vercel AI SDK でプロバイダ抽象化
  • デバッグツールを使い 401/429/400/500 の頻出エラーを知る

LLM の API を呼ぶだけなら、必要なものは驚くほど少なめです。ランタイム(Node.js か Python)公式 SDKAPI キーの 3 つがそろえば、最初の 1 行は数分で動きます。本ガイドは「どこに何を置き、キーをどう安全に渡すか」を、初めての人がそのまま真似できる手順で整理します。

ランタイム SDK 公式ライブラリ API キー LLM クラウド API 応答

FIG.1 ランタイム → SDK →(API キーで認証)→ クラウド上のモデル → 応答、という一方向の流れ

ポイントは、モデル本体は手元に置かないこと。あなたのコードはインターネット越しにベンダーの API を呼び、結果を受け取るだけです。だから GPU も大量メモリも不要で、ノート PC でそのまま始められます。

01まず決める:Node.js か Python か

どちらでも LLM API は問題なく使えます。迷ったら、すでに慣れている言語で構いません。傾向としての向き不向きは次の通りです。

Node.js / TypeScriptPython
Web アプリ・API サーバーに組み込む用途が得意データ処理・機械学習・検証スクリプトが得意
フロントエンドと同じ言語で完結できるJupyter で対話的に試しやすい
型(TypeScript)で補完が効きやすいライブラリが豊富で書き味が軽い

本ガイドでは両方の最小セットアップを並べます。読みたい方だけ読めば大丈夫です。

02Node.js 環境を整える

3 つのステップ(インストール → プロジェクト作成 → 鍵の設定)で動く状態まで持っていきます。

01

Node.js を入れる

nodejs.org から LTS(長期サポート)版を入れます。2026 年 6 月時点の Active LTS は Node.js 24 です。複数バージョンを切り替えたいなら、nvm / fnm / volta などのバージョン管理ツールを使うと後で楽になります。

02

プロジェクトを作る

空のフォルダを作り、必要なパッケージを入れます。TypeScript と tsx(TS をそのまま実行できるツール)を入れておくと、コンパイル手順を省けます。

03

キーを .env に置く

API キーはコードに直接書かず、環境変数として .env に分離します。.env は必ず .gitignore に入れ、リポジトリに含めないこと。

実際のコマンドはこうなります(Anthropic・OpenAI・Google の 3 社をまとめて入れる例)。

mkdir my-ai-app && cd my-ai-app
npm init -y

# 公式 SDK(必要なものだけでよい)
npm install @anthropic-ai/sdk openai @google/genai

# TypeScript で書くための開発用ツール
npm install -D typescript tsx @types/node
npx tsc --init

続いて鍵を .env に書きます。値は各社のダッシュボードで発行したものに置き換えてください。

# .env  (← このファイルは .gitignore に必ず追加)
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=AIza...

# .gitignore
.env
node_modules

Node.js は v20.6 以降、--env-file オプションで .env を直接読めるため、追加ライブラリなしでも動きます。古い書き方に慣れているなら dotenv パッケージでも構いません。

03最初の 1 行を動かす(Node.js)

下のコードを index.ts に保存し、実行すると、モデルからの返事がターミナルに出ます。モデル名は時期によって変わるので、実行前に各社の公式ドキュメントで現行の識別子を確認してください(ここでは 2026 年 6 月時点の例を使っています)。

続きを読むには無料登録が必要です

アカウントを作成すると、オリジナル記事の全文をお読みいただけます。