Claude Code 環境準備

Claude Code 環境準備

概要: Autonomous-Operationsを使用する前に、まずClaude Codeをインストールして使える環境を準備します。

対象読者: Autonomous-Operationsを初めて使う開発者 所要時間: 10分 前提知識: なし(ターミナルの基本操作ができれば十分)


目次


Claude Codeとは

Claude Codeは、Anthropicが提供するエージェンティックコーディングツールです。

主な特徴

  • ターミナル内で動作: 既存のワークフローに統合可能
  • 高速開発: 自然言語からコードへ即座に変換
  • ファイル直接編集: ファイルの読み書き、コマンド実行、コミット作成が可能
  • エンタープライズグレード: セキュリティとプライバシーに配慮

できること

Claude Codeでできること:
  - 自然言語での機能説明からコード構築
  - デバッグと問題修正
  - コードベースのナビゲーション
  - 面倒なタスクの自動化
  - Gitコミットの作成
  - プロジェクト全体の理解と説明

Autonomous-Operationsとの関係

Claude Codeは、Autonomous-Operationsを実行するための基盤ツールです。

graph TD
    A[Claude Code] -->|基盤| B[Autonomous-Operations]
    B --> C[AIエージェント]
    C --> D[自動コード生成]
    C --> E[自動テスト作成]
    C --> F[自動PR作成]

必要な環境

システム要件

  • OS: macOS、Linux、Windows (WSL推奨)
  • Node.js: バージョン 18 以降
  • ターミナル: bash、zsh、またはその他のシェル
  • インターネット接続: 必須

アカウント

以下のいずれかのアカウントが必要です:

  • Claude.ai アカウント (個人利用)
  • Claude Console アカウント (チーム・企業利用)

アカウントをお持ちでない場合は、https://claude.ai でサインアップしてください。


ステップ1: Node.jsのインストール

Node.jsがインストール済みか確認

node --version

v18.0.0以上が表示されればOKです。次のステップに進んでください。

Node.jsをインストールする (未インストールの場合)

macOSの場合

# Homebrewを使用
brew install node

# バージョン確認
node --version
npm --version

Linuxの場合 (Ubuntu/Debian)

# NodeSourceリポジトリを追加
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Node.jsをインストール
sudo apt-get install -y nodejs

# バージョン確認
node --version
npm --version

Windowsの場合

  1. https://nodejs.org/ にアクセス
  2. "LTS (推奨版)" をダウンロード
  3. インストーラーを実行
  4. コマンドプロンプトまたはPowerShellで確認:
node --version
npm --version

推奨: Windows Subsystem for Linux (WSL)を使用することをお勧めします。


ステップ2: Claude Codeのインストール

グローバルインストール

ターミナルで以下のコマンドを実行します:

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

インストール確認

claude --version

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

実行例

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

added 142 packages in 8s

$ claude --version
@anthropic-ai/claude-code/1.0.0 darwin-arm64 node-v20.10.0

ステップ3: 初回ログイン

Claude Codeを起動

任意のディレクトリで以下を実行:

claude

初回起動時は、ブラウザが自動的に開きます。

ログインフロー

graph LR
    A[claude コマンド実行] --> B[ブラウザが開く]
    B --> C[Claude.ai にログイン]
    C --> D[認証コードが表示]
    D --> E[ターミナルに戻る]
    E --> F[Claude Code 起動完了]

実行例

$ claude

🚀 Claude Codeへようこそ!

初回利用のため、認証が必要です。
ブラウザでログインしてください...

✓ ブラウザが開きました
✓ 認証完了

Claude Code が起動しました!
何を手伝いましょうか?

>

ログイン後

Claude Codeのプロンプト (>) が表示されたら成功です。

> Hello
こんにちは!Claude Codeです。コーディングをお手伝いします。

> exit

exit コマンドで終了できます。


ステップ4: 動作確認

簡単なテスト

Claude Codeを起動して、簡単なタスクを試してみましょう:

cd ~
mkdir claude-test
cd claude-test
claude

Claude Codeのプロンプトで:

> Create a simple hello.js file that prints "Hello, Claude Code!"

期待される動作

Claude Codeが以下を実行します:

  1. hello.js ファイルを作成
  2. 以下の内容を記述:
console.log("Hello, Claude Code!");
  1. ファイルの内容を説明

実行確認

> exit

$ node hello.js
Hello, Claude Code!

成功! これでClaude Codeが正しく動作しています。


よくある質問

Q: Claude Codeは無料ですか?

A: Claude Codeの利用には、Claudeのサブスクリプションまたはクレジットが必要です。

  • Claude Pro: 月額$20 (個人利用)
  • Claude Team: 月額$25/ユーザー (チーム利用)
  • API クレジット: 従量課金制

詳細は https://www.anthropic.com/pricing を参照してください。

Q: VS Code拡張機能もありますか?

A: はい、Claude Code VS Code拡張機能(ベータ版)も利用可能です。 VS Code Marketplaceから「Claude Code」を検索してインストールできます。

Q: オフラインで使えますか?

A: いいえ。Claude Codeはクラウドベースのため、インターネット接続が必要です。

Q: どんなプログラミング言語に対応していますか?

A: Claude Codeは以下を含む多くの言語に対応しています:

  • JavaScript / TypeScript
  • Python
  • Go
  • Rust
  • Java
  • C/C++
  • Ruby
  • PHP
  • その他多数

Q: 既存のプロジェクトで使えますか?

A: はい。既存のプロジェクトディレクトリで claude を実行すれば、即座に利用開始できます。

Q: セキュリティは大丈夫ですか?

A: Claude Codeはエンタープライズグレードのセキュリティを提供:

  • コードはAnthropicのセキュアなサーバーで処理
  • データは学習に使用されません (オプトアウト可能)
  • SOC 2 Type II 認証取得

トラブルシューティング

npm install がエラーになる

原因: Node.jsのバージョンが古い

# Node.jsのバージョンを確認
node --version

# v18.0.0未満の場合、最新版にアップグレード

原因: 権限エラー (Permission denied)

# sudoを使用 (推奨しない)
sudo npm install -g @anthropic-ai/claude-code

# または、npmの権限設定を変更 (推奨)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 再度インストール
npm install -g @anthropic-ai/claude-code

claude コマンドが見つからない

原因: PATHが通っていない

# インストール場所を確認
npm list -g @anthropic-ai/claude-code

# PATHに追加 (bash)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# PATHに追加 (zsh)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

ブラウザが自動で開かない

手動で認証URLを開く

$ claude

認証が必要です。
以下のURLをブラウザで開いてください:
https://claude.ai/auth/device?code=ABCD-1234

# 上記のURLを手動でブラウザにコピー&ペースト

認証エラーが発生する

# 認証情報をクリア
rm -rf ~/.claude-code

# 再度ログイン
claude

ネットワークエラー

原因: プロキシ設定

会社のプロキシを使用している場合:

# HTTPプロキシを設定
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

# Claude Codeを起動
claude

次のステップ

✅ Claude Codeの環境準備が完了しました!

次に進む

  1. クイックスタート

    • Autonomous-Operationsを5分で始める
    • 最初のAIエージェントタスクを実行
  2. 詳細セットアップガイド

    • GitHub Token の設定
    • Autonomous-Operations の環境構築
    • Anthropic API Key の設定
  3. 基本コンセプト

    • Autonomous-Operationsの仕組みを理解
    • Agent階層システムの学習

Claude Codeの基本操作を学ぶ

Claude Codeの詳細な使い方は公式ドキュメントを参照してください: https://docs.claude.com/ja/docs/claude-code/overview


関連ドキュメント


ドキュメントバージョン: 1.0.0 最終更新: 2025-10-10 メンテナー: Autonomous-Operations Team

🤖 このドキュメントはAutonomous-Operationsプロジェクトの一部です