01. 環境構築¶

前提¶

macOS（Darwin 25.x）
Python 3.11+（uv で管理）
Anthropic API キー or OpenAI API キー（1Password から取り出す）

プロジェクト作成¶

mkdir -p ~/langgraph-playground && cd ~/langgraph-playground
uv init --python 3.12
uv add langgraph langchain langchain-anthropic langchain-openai
uv add langgraph-checkpoint-sqlite
uv add python-dotenv

uv を使う理由: pip より速く、pyproject.toml で依存が固まる。ユーザーの他プロジェクト（~/jaist-master-thesis, ~/temporal-workflows）と運用を揃えるため。

API キー設定¶

# 1Password CLI で取り出してから .env に書く
op item get "Anthropic API" --fields credential > /dev/null  # 確認
echo "ANTHROPIC_API_KEY=$(op item get 'Anthropic API' --fields credential)" >> .env

.env は 必ず .gitignore に追加。

echo ".env" >> .gitignore
echo ".venv/" >> .gitignore
echo "*.sqlite" >> .gitignore

動作確認¶

hello.py:

from langchain_anthropic import ChatAnthropic
from dotenv import load_dotenv

load_dotenv()

llm = ChatAnthropic(model="claude-sonnet-4-5", temperature=0)
print(llm.invoke("LangGraph を一言で説明してください").content)

uv run python hello.py

応答が返ってくれば OK。

LangGraph Studio（任意だが推奨）¶

グラフを可視化しながらデバッグできる公式UI。

# macOS
brew install --cask langgraph-studio

または公式 DL ページ: https://studio.langchain.com/

起動して langgraph.json がある作業ディレクトリを指定すると、グラフ・state・time travel デバッグが使える。

langgraph CLI（dev server 用）¶

uv add "langgraph-cli[inmem]"

langgraph.json:

{
  "dependencies": ["."],
  "graphs": {
    "agent": "./src/agent.py:graph"
  },
  "env": ".env"
}

起動:

uv run langgraph dev

ブラウザで http://localhost:2024 を開けば Studio UI（ローカル版）にアクセスできる。

チェックポイント¶

[ ] uv run python hello.py で Claude から応答が返る
[ ] .env が .gitignore に入っている
[ ] （任意）langgraph dev でローカル Studio が立ち上がる

トラブルシュート¶

症状	原因 / 対処
`anthropic.AuthenticationError`	`.env` 読み込み忘れ。`load_dotenv()` の前に `os.getenv` してないか確認
`ModuleNotFoundError: langgraph`	`uv pip install` ではなく `uv add` を使う。venv が正しいか `uv run which python` で確認
Studio が graph を認識しない	`langgraph.json` の `graphs` のパス・export 名（`:graph`）を確認

作成: 2026-05-16 ／最終更新: 2026-05-16