Claude Code のインストール方法【完全ガイド】

Claude Code とは?

Claude Code は、Anthropic が開発した AI エンジニアリングツールです。ターミナル上で動作し、コードの作成・編集・デバッグ・テスト・Git 操作などをすべて自然言語で指示できます。単なるコード補完ではなく、プロジェクト全体のコンテキストを理解した上で、ファイルの読み書きやコマンド実行まで自律的にこなすエージェント型ツールです。

必要な環境

インストール前に以下の環境を準備してください。

  • Node.js 18 以上(推奨: 最新の LTS 版)
  • npm または npx(Node.js に同梱)
  • Anthropic API キーconsole.anthropic.com で取得)
  • macOS / Linux / Windows(WSL2 推奨)

インストール手順

Step 1: Node.js のバージョンを確認する

まずターミナルを開き、Node.js がインストールされているか確認します。

node --version
# v18.0.0 以上であればOK

インストールされていない場合は nodejs.org からインストールしてください。

Step 2: Claude Code をインストールする

npm を使ってグローバルインストールします。

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

または、インストールせずにそのまま実行することも可能です。

npx @anthropic-ai/claude-code

Step 3: インストールを確認する

claude --version

バージョン番号が表示されれば成功です。

Step 4: API キーを設定する

Anthropic のコンソールで API キーを取得し、環境変数に設定します。

# macOS / Linux の場合(~/.zshrc または ~/.bashrc に追記)
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxx"

# 設定を反映
source ~/.zshrc

または Claude Code の初回起動時に対話形式で設定することもできます。

初回起動と認証

プロジェクトのディレクトリに移動して claude コマンドを実行します。

cd /path/to/your/project
claude

初回起動時にブラウザが開き、Anthropic アカウントへのログインと API キーの紐付けが行われます。認証が完了するとターミナルに対話形式のプロンプトが表示されます。

基本的な使い方

起動後はチャット形式で指示を送るだけです。

# ファイルの内容を説明してもらう
> このファイルの処理を説明して

# バグ修正
> login.py の認証エラーを修正して

# 新機能の追加
> ユーザー一覧ページに検索機能を追加して

# Git コミット
> 変更内容をコミットして

VS Code との連携

Claude Code は VS Code 拡張機能としても利用できます。拡張機能マーケットプレイスで「Claude Code」を検索してインストールすることで、エディタ上から直接利用できます。

よくある問題と対処法

「command not found: claude」と表示される

npm のグローバルインストールパスが PATH に含まれていない可能性があります。以下を確認してください。

npm config get prefix
# 表示されたパス/bin を PATH に追加する

API キーの認証エラー

API キーが正しく設定されているか確認します。

echo $ANTHROPIC_API_KEY

空白や改行が混入していないかも確認してください。

まとめ

Claude Code のインストールは npm install -g @anthropic-ai/claude-code の1コマンドで完了します。API キーさえ用意すれば、すぐに AI エージェントとしてのコーディング支援を受けられます。ぜひ実際のプロジェクトで試してみてください。