Claude Code 初心者向けマニュアル

ターミナルでClaudeと協働開発を始めよう

🚀 基本概要

Claude Codeは、ターミナルから直接Claudeと協働してコードを書けるツールです。Dev Container環境で動作し、プロジェクトごとに独立した環境を構築できます。

📋 事前準備(初回のみ)

以下がインストール済みであることを確認:

  • Docker Desktop
  • Visual Studio Code
  • Dev Containers拡張機能

🛠️ 新プロジェクト開始手順

1. 基本環境の起動

  • Windows立ち上げ後、Docker Desktopを起動
  • VSCodeを起動

2. プロジェクトフォルダの作成

  • 新しいフォルダを作成(例:my-new-project
  • VSCodeで「ファイル」→「フォルダーを開く」でそのフォルダを開く

3. Dev Container環境の設定

  1. Ctrl+Shift+Pでコマンドパレットを開く
  2. 「Dev Containers: 開発コンテナー構成ファイルの追加」を選択
  3. 「Node.js」→「20(既定)」→機能は何も選ばず「OK」

4. devcontainer.jsonの編集

.devcontainer/devcontainer.jsonを以下の内容に変更:

{ "name": "Claude Code Environment", "build": { "dockerfile": "Dockerfile" }, "postCreateCommand": "sudo npm install -g @anthropic-ai/claude-code", "remoteUser": "node" }
重要ポイント: sudo npm install -gsudoが権限エラー回避のカギ!

5. コンテナで起動

  1. Ctrl+Shift+Pでコマンドパレットを開く
  2. 「Dev Containers: コンテナーで再度開く」を選択
  3. 初回は時間がかかるが、Claude Codeが自動インストールされる

6. Claude Codeの開始

ターミナルで以下を実行:

# インストール確認 claude --version # Claude Code開始 claude # 初期設定(プロジェクト内でCLAUDE.mdファイル作成) /init

🔧 トラブルシューティング

権限エラーが出る場合

エラー例: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@anthropic-ai'

解決策: devcontainer.jsonのpostCreateCommandsudoを追加

"postCreateCommand": "sudo npm install -g @anthropic-ai/claude-code"

コンテナを再ビルドしたい場合

  1. Ctrl+Shift+P
  2. 「Dev Containers: Rebuild Container」を選択

それでもダメな場合の代替設定

{ "name": "Claude Code Environment", "build": { "dockerfile": "Dockerfile" }, "postCreateCommand": "npm config set prefix ~/.npm-global && npm install -g @anthropic-ai/claude-code && echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc", "remoteUser": "node" }

⚡ 時短のコツ

  • Docker Desktopを自動起動に設定
  • devcontainer.jsonの設定をテンプレートとして保存
  • よく使うプロジェクト構成は.devcontainerフォルダごとコピー

🎯 基本的なClaude Codeコマンド

  • claude - Claude Code開始
  • /init - CLAUDE.mdファイル作成
  • /help - ヘルプ表示
  • /exit - 終了

📈 次のステップ

  • CLAUDE.mdファイルの書き方を学ぶ
  • プロジェクトの目標や要件をClaude.mdに記述
  • Claudeとの協働でコード開発を進める