セットアップ · Claude Code(ターミナル)

Day 1午後向け · macOS、Linux、Windows(WSL)で動作

前提条件

Node.js 20以降 — node --version で確認
Vertex AI APIが有効化された GCPプロジェクト
Vertex AI Model Gardenでの Anthropicモデルアクセス権限(承認まで1〜2営業日を見込んでください)
gcloud CLI がインストール・認証済み — gcloud auth list で確認

インストール

npm install -g @anthropic-ai/claude-code

認証

Application Default Credentialsを使用します(ワークショップでは最も簡便な方法です)。

gcloud auth application-default login

Vertex向けの設定

シェルプロファイル(~/.zshrc、~/.bashrc、または同等のファイル)に以下を追記します。

export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_PROJECT_ID=<your-gcp-project-id>
export CLOUD_ML_REGION=asia-northeast1
export ANTHROPIC_MODEL=claude-sonnet-4-6@20250514

シェルを再読み込みするか、新しいターミナルを開いてください。

動作確認

インストール・認証・ルーティングを確認するための1行の往復処理です。

claude --print "Reply with the single word: ready"

期待される出力: ready。これが表示されればインストールは正常です。

Hello Worldエージェントの構築

mkdir agent-workshop && cd agent-workshop
mkdir -p .claude/agents

cat > .claude/agents/file-reader.md <<'EOF'
---
agent_id: file-reader
model: claude-sonnet-4-6
---

# Identity
I am a file-reader. I read files in the working directory and summarise them.

# Workflow
When invoked:
1. List files in the current directory
2. Read the most recent .md or .txt file
3. Print a 3-line summary
4. Exit
EOF

echo "# Hello World" > sample.md
echo "This is my first file." >> sample.md

claude --agent file-reader

期待される動作: エージェントがファイルを一覧表示し、sample.md を読み、3行の要約を出力します。

トラブルシューティング

claude: command not found — npmのグローバルbinがPATHに含まれていません。npm config get prefix を実行し、<that-path>/bin をPATHに追加してください。

Vertexからの 401 Unauthorized — gcloud auth application-default login を再実行してください。ANTHROPIC_VERTEX_PROJECT_ID がアクティブなGCPプロジェクト(gcloud config get-value project)と一致していることを確認してください。

Model not available in region — asia-northeast1 リージョンでVertex AI Model GardenのAnthropic Claudeモデルアクセスが付与されているか確認してください。承認には1〜2営業日かかる場合があります。

社内プロキシによるAPIブロック — asia-northeast1-aiplatform.googleapis.com への外向きHTTPSが許可されていることを確認してください。