Claude Code概要

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

Claude Codeは、ターミナルに常駐し、コードベースを理解し、自然言語コマンドを通じてより速くコーディングを支援するエージェント型コーディングツールです。開発環境に直接統合することで、追加のサーバーや複雑なセットアップを必要とせずにワークフローを効率化します。

Claude Codeの主な機能は以下の通りです：

• コードベース全体でのファイルの編集とバグの修正
• コードのアーキテクチャとロジックに関する質問への回答
• テスト、リンティング、その他のコマンドの実行と修正
• gitの履歴検索、マージコンフリクトの解決、コミットとPRの作成

​

始める前に

​

システム要件の確認

• オペレーティングシステム: macOS 10.15+、Ubuntu 20.04+/Debian 10+、またはWSL経由のWindows
• ハードウェア: 最小4GB RAM
• ソフトウェア:
  • Node.js 18+
  • git 2.23+ (オプション)
  • PRワークフロー用のGitHubまたはGitLab CLI (オプション)
  • 拡張ファイル検索用のripgrep (rg) (オプション)
• ネットワーク: 認証とAI処理にインターネット接続が必要
• 地域: 対応国でのみ利用可能

​

インストールと認証

​

主な機能とワークフロー

Claude Codeはターミナルで直接動作し、プロジェクトのコンテキストを理解して実際のアクションを実行します。コンテキストにファイルを手動で追加する必要はありません - Claudeは必要に応じてコードベースを探索します。Claude Codeはデフォルトでclaude-3-7-sonnet-20250219を使用します。

​

セキュリティとプライバシーを重視した設計

コードのセキュリティは最重要です。Claude Codeのアーキテクチャは以下を保証します：

• 直接のAPI接続: クエリは中間サーバーを経由せずにAnthropicのAPIに直接送信されます
• あなたの作業環境で動作: ターミナルで直接動作します
• コンテキストを理解: プロジェクト構造全体を把握します
• アクションを実行: ファイルの編集やコミットの作成など、実際の操作を実行します

​

質問から解決まで数秒で

# コードベースについて質問する
claude
> 認証システムはどのように動作しますか？

# 1つのコマンドでコミットを作成
claude commit

# 複数のファイルにまたがる問題を修正
claude "auth モジュールの型エラーを修正して"

​

プロジェクトの初期化

初めてのユーザーには以下をお勧めします：

1. claudeでClaude Codeを起動
2. このプロジェクトを要約してのような簡単なコマンドを試す
3. /initでCLAUDE.mdプロジェクトガイドを生成
4. 生成されたCLAUDE.mdファイルをリポジトリにコミットするようClaudeに依頼

​

一般的なタスクにClaude Codeを使用する

Claude Codeはターミナルで直接動作し、プロジェクトのコンテキストを理解して実際のアクションを実行します。コンテキストにファイルを手動で追加する必要はありません - Claudeは必要に応じてコードベースを探索します。

​

不慣れなコードを理解する

> 決済処理システムは何をしていますか？
> ユーザー権限のチェックはどこで行われていますか？
> キャッシュレイヤーはどのように動作しますか？

​

Git操作の自動化

> 変更をコミットして
> PRを作成して
> 12月にマークダウンのテストを追加したコミットはどれですか？
> mainにリベースしてマージコンフリクトを解決して

​

コードのインテリジェントな編集

> サインアップフォームに入力バリデーションを追加して
> ロガーを新しいAPIを使用するようにリファクタリングして
> ワーカーキューの競合状態を修正して

​

コードのテストとデバッグ

> authモジュールのテストを実行して失敗を修正して
> セキュリティの脆弱性を見つけて修正して
> このテストが失敗している理由を説明して

​

より深い思考を促す

複雑な問題については、Claudeにより深く考えるよう明示的に依頼します：

> 新しい決済サービスをどのようにアーキテクチャ設計すべきか考えて
> 認証フローのエッジケースについてよく考えて

Claude Codeは、Claude（3.7 Sonnet）が拡張思考を使用している場合に表示します。計画が必要なタスクについては、事前にClaudeに「考える」または「深く考える」よう促すことができます。まずタスクについてClaudeに説明し、プロジェクトからコンテキストを収集させることをお勧めします。その後、計画を作成するために「考える」よう依頼してください。

​

CIとインフラワークフローの自動化

Claude Codeには、ヘッドレス実行用の非インタラクティブモードが付属しています。これは特に、スクリプト、パイプライン、Github Actionsなどの非インタラクティブなコンテキストでClaude Codeを実行する場合に便利です。

非インタラクティブモードで実行するには--print（-p）を使用します。このモードでは、カスタムAPIキーを提供するためにANTHROPIC_API_KEY環境変数を設定できます。

非インタラクティブモードは、Claudeが使用できるコマンドのセットを事前に設定する場合に特に便利です：

export ANTHROPIC_API_KEY=sk_...
claude -p "READMEを最新の変更で更新して" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Edit

​

コマンドでClaude Codeを制御する

​

CLIコマンド

CLIフラグ:

• --print: インタラクティブモードなしで応答を表示
• --verbose: 詳細なログを有効化
• --dangerously-skip-permissions: 権限プロンプトをスキップ（インターネットのないDockerコンテナ内でのみ）

​

スラッシュコマンド

セッション内でClaudeの動作を制御します：

​

権限とセキュリティの管理

Claude Codeは、パワーと安全性のバランスを取るための階層化された権限システムを使用します：

​

Claudeが利用可能なツール

Claude Codeは、コードベースを理解し変更するのに役立つ強力なツールセットにアクセスできます：

​

プロンプトインジェクションからの保護

プロンプトインジェクションは、攻撃者が悪意のあるテキストを挿入してAIアシスタントの指示を上書きまたは操作しようとする手法です。Claude Codeには、これらの攻撃に対するいくつかの保護機能が含まれています：

• 権限システム: 機密性の高い操作には明示的な承認が必要
• コンテキスト認識分析: リクエスト全体を分析して潜在的に有害な指示を検出
• 入力サニタイズ: ユーザー入力を処理してコマンドインジェクションを防止
• コマンドブロックリスト: curlやwgetなどのウェブから任意のコンテンツを取得する危険なコマンドをブロック

信頼できないコンテンツを扱う際のベストプラクティス:

1. 承認前に提案されたコマンドを確認
2. 信頼できないコンテンツを直接Claudeにパイプしない
3. 重要なファイルへの提案された変更を確認
4. 不審な動作は/bugで報告

​

ネットワークアクセスの設定

Claude Codeには以下へのアクセスが必要です：

• api.anthropic.com
• statsig.anthropic.com
• sentry.io

コンテナ化された環境でClaude Codeを使用する場合は、これらのURLをホワイトリストに登録してください。

​

Claude Codeの設定

ターミナルでclaude configを実行するか、インタラクティブREPLで/configコマンドを使用してClaude Codeを設定します。

​

設定オプション

Claude Codeはグローバルおよびプロジェクトレベルの設定をサポートしています。

設定を管理するには、以下のコマンドを使用します：

• 設定を一覧表示：claude config list
• 設定を表示：claude config get <key>
• 設定を変更：claude config set <key> <value>
• 設定に追加（リスト用）：claude config add <key> <value>
• 設定から削除（リスト用）：claude config remove <key> <value>

デフォルトではconfigはプロジェクト設定を変更します。グローバル設定を管理するには、--global（または-g）フラグを使用します。

​

グローバル設定

グローバル設定を設定するには、claude config set -g <key> <value>を使用します：

​

自動更新の権限オプション

Claude Codeがグローバルnpmプレフィックスディレクトリ（自動更新に必要）への書き込み権限が不十分であることを検出した場合、このドキュメントページを指すような警告が表示されます。自動更新の問題に関する詳細な解決策については、トラブルシューティングガイドを参照してください。

​

推奨：新しいユーザー書き込み可能なnpmプレフィックスを作成

# まず、既存のグローバルパッケージのリストを後で移行するために保存
npm list -g --depth=0 > ~/npm-global-packages.txt

# グローバルパッケージ用のディレクトリを作成
mkdir -p ~/.npm-global

# 新しいディレクトリパスを使用するようnpmを設定
npm config set prefix ~/.npm-global

# 注：~/.bashrcを~/.zshrc、~/.profile、またはシェルに適切な他のファイルに置き換えてください
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# 新しいPATH設定を適用
source ~/.bashrc

# 新しい場所にClaude Codeを再インストール
npm install -g @anthropic-ai/claude-code

# オプション：以前のグローバルパッケージを新しい場所に再インストール
# ~/npm-global-packages.txtを確認して、保持したいパッケージをインストール
# npm install -g package1 package2 package3...

このオプションを推奨する理由：

• システムディレクトリの権限を変更しない
• グローバルnpmパッケージ用の専用の場所を作成
• セキュリティのベストプラクティスに従う

Claude Codeは活発に開発中であるため、上記の推奨オプションを使用して自動更新を設定することをお勧めします。

​

自動更新の無効化

権限を修正する代わりに自動更新を無効にする場合は、以下を使用できます：

claude config set -g autoUpdaterStatus disabled

​

プロジェクト設定

プロジェクト設定を管理するには、claude config set <key> <value>を使用します（-gフラグなし）：

例：

# npm testを承認なしで実行できるようにする
claude config add allowedTools "Bash(npm test)"

# npm testとそのサブコマンドを承認なしで実行できるようにする
claude config add allowedTools "Bash(npm test:*)"

# node_modulesを無視するようClaudeに指示
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"

​

ターミナルセットアップの最適化

Claude Codeは、ターミナルが適切に設定されている場合に最も効果を発揮します。最適な体験を得るには、以下のガイドラインに従ってください。

サポートされているシェル：

• Bash
• Zsh
• Fish

​

テーマと外観

Claudeはターミナルのテーマを制御できません。これはターミナルアプリケーションによって処理されます。オンボーディング時または/configコマンドを使用して、いつでもClaude Codeのテーマをターミナルに合わせることができます。

​

改行

Claude Codeに改行を入力するには、いくつかのオプションがあります：

• クイックエスケープ：\に続いてEnterを押して改行を作成
• キーボードショートカット：適切な設定でOption+Enter（Meta+Enter）を押す

ターミナルでOption+Enterを設定するには：

Mac Terminal.appの場合：

1. 設定 → プロファイル → キーボードを開く
2. “Optionをメタキーとして使用”をチェック

iTerm2とVSCodeターミナルの場合：

1. 設定 → プロファイル → キーを開く
2. 一般で、左/右Optionキーを”Esc+“に設定

iTerm2とVSCodeユーザー向けのヒント：より直感的な代替手段として、Claude Code内で/terminal-setupを実行してShift+Enterを自動設定できます。

​

通知設定

タスク完了時にClaudeからの通知を見逃さないように、適切な通知設定を行います：

ターミナルベル通知

タスク完了時のサウンドアラートを有効にします：

claude config set --global preferredNotifChannel terminal_bell

macOSユーザー向け：システム設定 → 通知 → [ターミナルアプリ]で通知権限を有効にすることを忘れないでください。

iTerm 2システム通知

タスク完了時のiTerm 2アラートの設定：

1. iTerm 2環境設定を開く
2. プロファイル → ターミナルに移動
3. “ベルを無音にする”と”アイドル時に通知を送信”を有効にする
4. 希望する通知遅延を設定

これらの通知はiTerm 2に固有のものであり、デフォルトのmacOSターミナルでは利用できないことに注意してください。

​

大きな入力の処理

広範なコードや長い指示を扱う場合：

• 直接貼り付けを避ける：Claude Codeは非常に長い貼り付けられたコンテンツで苦労する可能性があります
• ファイルベースのワークフローを使用：コンテンツをファイルに書き込み、Claudeに読み取りを依頼
• VS Codeの制限に注意：VS Codeターミナルは特に長い貼り付けを切り詰める傾向があります

これらの設定を構成することで、Claude Codeとのよりスムーズで効率的なワークフローを作成できます。

​

コストの効果的な管理

Claude Codeは各インタラクションでトークンを消費します。通常の使用コストは開発者1人あたり1日5-10ドルですが、集中的な使用時には1時間あたり100ドルを超える可能性があります。

​

コストの追跡

• /costを使用して現在のセッションの使用量を確認
• 終了時に表示されるコスト概要を確認
• Anthropic Consoleで履歴使用量を確認
• 支出制限を設定

​

トークン使用量の削減

• 会話を圧縮： コンテキストが大きくなったら/compactを使用
• 具体的なクエリを書く： 不必要なスキャンをトリガーする曖昧なリクエストを避ける
• 複雑なタスクを分解： 大きなタスクを焦点を絞ったインタラクションに分割
• タスク間で履歴をクリア： /clearを使用してコンテキストをリセット

コストは以下の要因によって大きく変動する可能性があります：

• 分析されるコードベースのサイズ
• クエリの複雑さ
• 検索または変更されるファイルの数
• 会話履歴の長さ
• 会話の圧縮頻度

​

サードパーティAPIとの使用

​

Amazon Bedrockへの接続

CLAUDE_CODE_USE_BEDROCK=1

デフォルトのモデルを上書きしたい場合は、ANTHROPIC_MODEL環境変数を渡すことができます（デフォルトではClaude 3.7 Sonnetが使用されます）：

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

プロキシ経由でClaude Codeにアクセスしたい場合は、ANTHROPIC_BEDROCK_BASE_URL環境変数を使用できます：

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

プロンプトキャッシュが有効になっていない場合は、以下も設定します：

DISABLE_PROMPT_CACHING=1

標準のAWS SDK認証情報（例：~/.aws/credentialsまたはAWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEYなどの関連環境変数）が必要です。AWS認証情報を設定するには、以下を実行します：

aws configure

コスト削減と高いレート制限のためのプロンプトキャッシュについては、Amazon Bedrockにお問い合わせください。

​

Google Vertex AIへの接続

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

デフォルトのモデルを上書きしたい場合は、ANTHROPIC_MODEL環境変数を渡すことができます（デフォルトではClaude 3.7 Sonnetが使用されます）：

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

プロキシ経由でClaude Codeにアクセスしたい場合は、ANTHROPIC_VERTEX_BASE_URL環境変数を使用できます：

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

プロンプトキャッシュが有効になっていない場合は、以下も設定します：

DISABLE_PROMPT_CACHING=1

google-auth-libraryを通じて設定された標準のGCP認証情報が必要です。GCP認証情報を設定するには、以下を実行します：

gcloud auth application-default login

最高の体験を得るには、高いレート制限についてGoogleにお問い合わせください。

​

開発コンテナのリファレンス実装

Claude Codeは、一貫性のある安全な環境が必要なチーム向けに開発コンテナ設定を提供します。この事前設定されたdevcontainerセットアップは、VS CodeのRemote - Containers拡張機能や同様のツールとシームレスに連携します。

コンテナの強化されたセキュリティ対策（分離とファイアウォールルール）により、無人操作のために権限プロンプトをバイパスするclaude --dangerously-skip-permissionsを実行できます。ニーズに合わせてカスタマイズできるリファレンス実装を提供しています。

​

主な機能

• 本番環境対応Node.js: 必要な開発依存関係を備えたNode.js 20をベースにしています
• セキュリティ重視の設計: 必要なサービスのみにネットワークアクセスを制限するカスタムファイアウォール
• 開発者フレンドリーなツール: git、生産性向上機能を備えたZSH、fzfなどを含む
• VS Codeとのシームレスな統合: 事前設定された拡張機能と最適化された設定
• セッションの永続性: コンテナの再起動間でコマンド履歴と設定を保持
• どこでも動作: macOS、Windows、Linuxの開発環境と互換性あり

​

4ステップで始める

1. VS CodeとRemote - Containers拡張機能をインストール
2. Claude Codeリファレンス実装リポジトリをクローン
3. VS Codeでリポジトリを開く
4. プロンプトが表示されたら、“Reopen in Container”をクリック（またはコマンドパレット：Cmd+Shift+P → “Remote-Containers: Reopen in Container”）

​

設定の内訳

devcontainerセットアップは3つの主要なコンポーネントで構成されています：

• devcontainer.json: コンテナ設定、拡張機能、ボリュームマウントを制御
• Dockerfile: コンテナイメージとインストールされるツールを定義
• init-firewall.sh: ネットワークセキュリティルールを確立

​

セキュリティ機能

コンテナはファイアウォール設定で多層的なセキュリティアプローチを実装しています：

• 精密なアクセス制御: ホワイトリストに登録されたドメイン（npmレジストリ、GitHub、Anthropic APIなど）のみに外部接続を制限
• デフォルト拒否ポリシー: 他のすべての外部ネットワークアクセスをブロック
• 起動時の検証: コンテナ初期化時にファイアウォールルールを検証
• 分離: メインシステムから分離された安全な開発環境を作成

​

カスタマイズオプション

devcontainer設定はニーズに合わせて適応できるように設計されています：

• ワークフローに基づいてVS Code拡張機能を追加または削除
• 異なるハードウェア環境のためにリソース割り当てを変更
• ネットワークアクセス権限を調整
• シェル設定と開発者ツールをカスタマイズ

​

次のステップ

​

ライセンスとデータ使用

Claude CodeはAnthropicの商用利用規約に基づいてベータ研究プレビューとして提供されています。

​

データの使用方法

データの使用方法について完全な透明性を目指しています。フィードバックを製品とサービスの改善に使用する場合がありますが、Claude Codeからのフィードバックを使用して生成モデルをトレーニングすることはありません。潜在的な機密性を考慮して、ユーザーフィードバックの転写は30日間のみ保存します。

​

フィードバック転写

Claude Codeに関するフィードバック（使用状況の転写など）を送信することを選択した場合、Anthropicはそのフィードバックを関連する問題のデバッグとClaude Codeの機能改善（例：同様のバグが将来発生するリスクを減らすため）に使用する場合があります。このフィードバックを使用して生成モデルをトレーニングすることはありません。

​

プライバシー保護

機密情報の限定保持期間、ユーザーセッションデータへのアクセス制限、フィードバックをモデルトレーニングに使用しないという明確なポリシーなど、データを保護するためのいくつかの保護措置を実装しています。

詳細については、商用利用規約とプライバシーポリシーをご確認ください。

​

ライセンス

© Anthropic PBC. All rights reserved. 使用はAnthropicの商用利用規約に従います。