Claude Codeが動かない時の完全チェックリスト — 環境構築から接続問題まで

# Claude Code がインストールされているか確認
claude --version
 
# 出力例（このようなバージョン番号が表示されたらOK）
# Claude 0.4.0

# macOS (Homebrew)
brew install anthropic/claude/claude
 
# または npm で
npm install -g @anthropic-ai/sdk

# Node.js バージョン確認
node --version  # v18.0.0 以上が必要
 
# npm バージョンも確認
npm --version   # 8.0.0 以上

# 現在のディレクトリを確認
pwd
 
# ホームディレクトリか、プロジェクトディレクトリか確認
ls -la | head -10

# 認証状態を確認
claude auth status
 
# 出力例：
# ✓ Authenticated as: your-email@example.com
# Token expires: 2026-06-29

# ログインする
claude auth login
 
# ブラウザが自動的に開き、Anthropic のログインページが表示されます。
# アカウントでログインして、アクセスを許可してください。
 
# ログイン後、ターミナルに戻ります

# API キーを環境変数に設定
export ANTHROPIC_API_KEY="sk-ant-..."
 
# 確認
echo $ANTHROPIC_API_KEY
 
# 以降、このターミナルセッション内での Claude Code 実行時に
# 自動的にこのキーが使用されます

# 対話モードを開始
claude
 
# プロンプトが表示されます：
# You>
 
# ここで、簡単な質問を入力
# You> Pythonで"Hello World"を出力するコードを書いて

# -p フラグで単発実行
claude -p "Pythonで素数判定関数を書いて"
 
# ターミナルに結果が表示されれば OK

# テスト用フォルダ作成
mkdir ~/test-claude-code
cd ~/test-claude-code
 
# 簡単なプロジェクトを作成
claude -p "package.jsonを作成してください。名前は test-app"

ls -la
 
# 出力例：
# total 8
# -rw-r--r--  1 user  group  125 Mar 29 12:00 package.json

# package.json の内容を確認
cat package.json
 
# 内容が表示されれば、ファイル生成は正常に動作しています

# Claude Code のログを確認
# （権限不足、ディスク不足、パス問題の可能性）
 
# ディスク空き容量を確認
df -h
 
# ディレクトリの書き込み権限を確認
touch test.txt  # テストファイル作成
ls -la test.txt
rm test.txt     # 削除

# JSON形式が正しいか確認
cat package.json | python3 -m json.tool
 
# 構文エラーがあれば、以下のような警告が表示されます：
# json.decoder.JSONDecodeError: ...

{
  "name": "my-app",
  "version": "1.0.0",
  "description": "A test app",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {}
}

# package.json がある場合
npm install
 
# または
yarn install
 
# Pythonプロジェクト
pip install -r requirements.txt
 
# インストール完了後、確認
npm list  # Node.js
pip freeze  # Python

# 基本的な接続テスト
ping google.com
 
# レスポンスが返ってくれば接続OK
# ping: Timeout... が出たら接続不安定

# Anthropic API エンドポイントへの接続テスト
curl -I https://api.anthropic.com
 
# HTTP/2 200 が返ってくれば接続OK

# プロキシ設定を確認
echo $HTTP_PROXY
echo $HTTPS_PROXY
 
# 必要があれば、プロキシを指定
export HTTP_PROXY="http://proxy.company.com:8080"
export HTTPS_PROXY="http://proxy.company.com:8080"
export NO_PROXY="localhost,127.0.0.1"
 
# その後、Claude Code を実行
claude -p "テストプロンプト"

# インストール確認
which claude
 
# 出力がない場合はインストール
npm install -g @anthropic-ai/sdk
 
# または Homebrew で
brew install anthropic/claude/claude

# 認証をリセット
claude auth logout
claude auth login
 
# または API キーを直接設定
export ANTHROPIC_API_KEY="sk-ant-..."

# 接続テスト
ping -c 3 api.anthropic.com
 
# DNSが解決できるか確認
nslookup api.anthropic.com
 
# ファイアウォール設定を確認
# → ポート 443 (HTTPS) が開いているか確認

# 現在のディレクトリの権限を確認
ls -la
 
# 書き込み権限がない場合
chmod 755 .
 
# または、別の場所に移動
cd ~/Projects  # ホームディレクトリ配下に移動

# 現在のディレクトリを確認
pwd
 
# ファイルが存在するか確認
ls -la
 
# 絶対パスでファイルを指定
claude -p "このファイルを読んで" --file "/full/path/to/file.txt"

# デバッグモードで実行
DEBUG=* claude -p "テストプロンプト"
 
# または
DEBUG=claude:* claude -p "テストプロンプト"

# 環境情報をまとめて確認
echo "=== Node.js ==="
node --version
npm --version
 
echo "=== Claude Code ==="
claude --version
 
echo "=== OS ==="
uname -a
 
echo "=== Path ==="
echo $PATH
 
echo "=== API Key ==="
echo $ANTHROPIC_API_KEY | head -c 20  # 先頭20文字のみ表示（セキュリティ）

# ログをファイルに保存
claude -p "テストプロンプト" 2>&1 | tee claude-debug.log
 
# ログをコピー（問題報告時に必要）
cat claude-debug.log | head -50

# 登録済み MCP サーバーと接続状態を一覧表示
claude mcp list
 
# 特定サーバーの設定（コマンド・引数）を確認
claude mcp get <server-name>

# プロジェクト設定を直接確認
cat .mcp.json
 
# ユーザー設定側の MCP 定義を確認
cat ~/.claude.json | grep -A5 mcpServers

# 初回接続のタイムアウトを延長して起動（ミリ秒）
MCP_TIMEOUT=30000 claude

# 置換対象が何回現れるか先に数える
grep -c "置換したい文字列" path/to/file.ts

# 許可ルールを対話的に編集
/permissions