Claude Code 実践ワークフロー入門
環境構築と認証
始めの一歩
Claude Codeを実務で活用するためには、まず手元の開発環境を整える必要があります。最初のステップは、実行環境であるNode.jsのバージョンを確認することです。Claude CodeはNode.js 18以降を要求します。ターミナルで以下のコマンドを実行し、バージョンが v18.0.0 以上であることを確認してください。
node -v
バージョン要件を満たしていれば、準備は万端です。次に、npm (Node Package Manager) を使ってClaude Code本体をインストールします。以下のコマンドは、このツールをグローバルにインストールし、どのプロジェクトディレクトリからでも claude コマンドを呼び出せるようにするものです。
npm install -g @anthropic-ai/claude-code
-g フラグはグローバルインストールを意味し、一度インストールすればシステムのどこからでもアクセスできるコマンドラインツールとしてセットアップされます。これにより、プロジェクトごとにインストールする手間が省けます。
APIキーとの連携
ローカルにインストールしたツールがAnthropicのAIモデルと通信するには、認証のためのAPIキーが必要です。これは、あなたのリクエストを識別し、利用状況を追跡するための秘密の鍵のようなものです。
まず、Anthropicの公式ウェブサイトにあるコンソールにログインし、APIキーを発行します。このキーは絶対に他人に公開しないでください。コードに直接書き込むのではなく、環境変数として設定するのが最も安全な方法です。
# .zshrc, .bash_profile, またはお使いのシェルの設定ファイルに追記します
export ANTHROPIC_API_KEY='発行したAPIキーをここに貼り付け'
設定ファイルを変更した後は、source ~/.zshrc のようにコマンドを実行するか、ターミナルを再起動して変更を反映させるのを忘れないでください。これで、claude コマンドは自動的にこの環境変数を読み込み、認証に利用します。
APIキーの準備ができたら、いよいよ初回認証です。ターミナルで以下のコマンドを実行してください。
claude auth
このコマンドを実行すると、ブラウザが起動し、Anthropicへのログインを求められます。認証が成功すると、Claude Codeがあなたのローカルマシンとアカウントを安全に紐付けます。このプロセスは一度だけで、以降は自動的に認証されます。
安全な作業領域の設定
Claude Codeは、あなたの指示に基づいてローカルファイルを読み書きしたり、コマンドを実行したりできる強力なツールです。しかし、その強力さゆえに、意図しないディレクトリで操作が行われるリスクも伴います。
このリスクを管理するため、Claude Codeには「Allowed Directories（許可されたディレクトリ）」というセキュリティ機能が備わっています。これは、Claude Codeがアクセスしてもよい作業領域を明示的に指定する仕組みです。設定は簡単で、claude コマンドに --allow フラグを付けて実行します。
# 現在のディレクトリを許可リストに追加
claude --allow .
# 特定のプロジェクトディレクトリを許可リストに追加
claude --allow ~/projects/my-cool-app
. はカレントディレクトリ（現在いるディレクトリ）を指します。プロジェクトのルートディレクトリでこのコマンドを実行すれば、そのプロジェクト内でのみClaude Codeがファイル操作を行えるようになります。
許可されたディレクトリのリストは、以下のコマンドでいつでも確認できます。
claude --show-allowed-dirs
プロジェクトごとに作業ディレクトリを適切に設定することは、誤操作を防ぎ、安全に開発を進めるための重要な習慣です。
これで、Claude Codeを安全かつ効果的に利用するための初期設定が完了しました。APIキーの管理と作業ディレクトリの制限は、実務でAIコーディングツールを使いこなす上で不可欠なセキュリティ意識の第一歩です。