Claude Code概要
Anthropicが開発したエージェント型コーディングツールであるClaude Codeについて学びます。現在ベータ版として研究プレビュー中です。
Claude Codeは、ターミナルに常駐し、コードベースを理解し、自然言語コマンドを通じてより速くコーディングを支援するエージェント型コーディングツールです。開発環境に直接統合することで、追加のサーバーや複雑なセットアップを必要とせずにワークフローを効率化します。
Claude Codeの主な機能は以下の通りです:
- コードベース全体でのファイル編集とバグ修正
- コードのアーキテクチャとロジックに関する質問への回答
- テスト、リンティング、その他のコマンドの実行と修正
- gitの履歴検索、マージコンフリクトの解決、コミットとPRの作成
研究プレビュー
Codeはベータ版として研究プレビューの段階にあります。AIとの協働に関する開発者の好み、AIアシスタンスが最も効果的なワークフロー、エージェントの体験を改善する方法について、フィードバックを収集しています。
この初期バージョンはユーザーフィードバックに基づいて進化していきます。今後数週間で、ツール実行の信頼性、長時間実行コマンドのサポート、ターミナルのレンダリング、Claudeの機能に関する自己認識を強化する予定です。
バグの報告は/bug
コマンドを使用するか、GitHubリポジトリを通じて直接行ってください。
主要機能とワークフロー
Claude Codeはターミナルで直接動作し、プロジェクトのコンテキストを理解して実際のアクションを実行します。手動でファイルをコンテキストに追加する必要はありません - Claudeは必要に応じてコードベースを探索します。Claude Codeはデフォルトでclaude-3-7-sonnet-20250219
を使用します。
セキュリティとプライバシーを重視した設計
コードのセキュリティは最重要事項です。Claude Codeのアーキテクチャは以下を保証します:
- 直接APIに接続: クエリは中間サーバーを介さずにAnthropicのAPIに直接送信されます
- あなたの作業環境で動作: ターミナルで直接操作
- コンテキストを理解: プロジェクト構造全体を把握
- アクションを実行: ファイルの編集やコミットの作成など、実際の操作を実行
質問から解決まで数秒で
始める前に
システム要件の確認
- オペレーティングシステム: macOS 10.15+、Ubuntu 20.04+/Debian 10+、またはWSL経由のWindows
- ハードウェア: 最小4GB RAM
- ソフトウェア:
- ネットワーク: 認証とAI処理にインターネット接続が必要
インストールと認証
Claude Codeのインストール
ターミナルで実行: npm install -g @anthropic-ai/claude-code
プロジェクトに移動
cd your-project-directory
Claude Codeを起動
claude
で起動認証を完了
Consoleアカウントで1回限りのOAuth処理を行います。console.anthropic.comでアクティブな課金が必要です。
プロジェクトの初期化
初めてのユーザーには以下をお勧めします:
claude
でClaude Codeを起動summarize this project
のような簡単なコマンドを試す/init
でCLAUDE.mdプロジェクトガイドを生成- 生成されたCLAUDE.mdファイルをリポジトリにコミットするようClaudeに依頼
一般的なタスクにClaude Codeを使用
Claude Codeはターミナルで直接動作し、プロジェクトのコンテキストを理解して実際のアクションを実行します。手動でファイルをコンテキストに追加する必要はありません - Claudeは必要に応じてコードベースを探索します。
不慣れなコードを理解する
Git操作の自動化
コードのインテリジェントな編集
コードのテストとデバッグ
より深い思考を促す
複雑な問題については、明示的にClaudeにより深く考えるよう依頼します:
コマンドでClaude Codeを制御
CLIコマンド
コマンド | 説明 | 例 |
---|---|---|
claude | 対話型REPLを起動 | $ claude |
claude "query" | 初期プロンプトでREPLを起動 | $ claude "explain this project" |
claude -p "query" | 1回限りのクエリを実行して終了 | $ claude -p "explain this function" |
cat file | claude -p "query" | パイプされたコンテンツを処理 | $ cat logs.txt | claude -p "explain" |
claude config | 設定を構成 | $ claude config set --global theme dark |
claude update | 最新バージョンに更新 | $ claude update |
claude mcp | Model Context Protocolサーバーを構成 | $ claude mcp add pyright_lsp |
CLIフラグ:
--print
: 対話モードなしでレスポンスを表示--verbose
: 詳細なログを有効化--dangerously-skip-permissions
: 権限プロンプトをスキップ(インターネットのないDockerコンテナ内でのみ)
スラッシュコマンド
セッション内でClaudeの動作を制御します:
コマンド | 目的 |
---|---|
/bug | バグを報告(会話をAnthropicに送信) |
/clear | 会話履歴をクリア |
/compact | コンテキスト空間を節約するために会話を圧縮 |
/config | 設定の表示/変更 |
/cost | トークン使用統計を表示 |
/doctor | Claude Codeのインストール状態を確認 |
/help | 使用方法のヘルプを表示 |
/init | CLAUDE.mdガイドでプロジェクトを初期化 |
/login | Anthropicアカウントを切り替え |
/logout | Anthropicアカウントからサインアウト |
/pr_comments | プルリクエストのコメントを表示 |
/review | コードレビューをリクエスト |
/terminal-setup | 改行用のShift+Enterキーバインドをインストール(iTerm2とVSCodeのみ) |
権限とセキュリティの管理
Claude Codeは、パワーと安全性のバランスを取るために階層化された権限システムを使用します:
ツールタイプ | 例 | 承認が必要 | ”はい、今後は確認しない”の動作 |
---|---|---|---|
読み取り専用 | ファイル読み取り、LS、Grep | いいえ | 該当なし |
Bashコマンド | シェル実行 | はい | プロジェクトディレクトリとコマンドごとに永続的 |
ファイル変更 | ファイルの編集/書き込み | はい | セッション終了まで |
Claudeが利用可能なツール
Claude Codeは、コードベースを理解し変更するための強力なツールセットにアクセスできます:
ツール | 説明 | 権限が必要 |
---|---|---|
AgentTool | 複雑な多段階タスクを処理するサブエージェントを実行 | いいえ |
BashTool | 環境でシェルコマンドを実行 | はい |
GlobTool | パターンマッチングでファイルを検索 | いいえ |
GrepTool | ファイル内容でパターン検索 | いいえ |
LSTool | ファイルとディレクトリを一覧表示 | いいえ |
FileReadTool | ファイルの内容を読み取り | いいえ |
FileEditTool | 特定のファイルを対象とした編集を実行 | はい |
FileWriteTool | ファイルを作成または上書き | はい |
NotebookReadTool | Jupyterノートブックの内容を読み取り表示 | いいえ |
NotebookEditTool | Jupyterノートブックのセルを変更 | はい |
プロンプトインジェクションからの保護
プロンプトインジェクションは、攻撃者が悪意のあるテキストを挿入してAIアシスタントの指示を上書きまたは操作しようとする手法です。Claude Codeには、これらの攻撃に対する複数の保護機能が含まれています:
- 権限システム: 機密性の高い操作には明示的な承認が必要
- コンテキスト認識分析: リクエスト全体を分析して潜在的に有害な指示を検出
- 入力サニタイズ: ユーザー入力を処理してコマンドインジェクションを防止
- コマンドブロックリスト:
curl
やwget
のようなウェブから任意のコンテンツを取得する危険なコマンドをブロック
信頼できないコンテンツを扱う際のベストプラクティス:
- 承認前に提案されたコマンドを確認
- 信頼できないコンテンツを直接Claudeにパイプしない
- 重要なファイルへの提案された変更を確認
- 不審な動作は
/bug
で報告
これらの保護機能は大幅にリスクを低減しますが、完全に攻撃から免れるシステムは存在しません。AIツールを使用する際は、常に適切なセキュリティプラクティスを維持してください。
ネットワークアクセスの設定
Claude Codeには以下へのアクセスが必要です:
- api.anthropic.com
- statsig.anthropic.com
- sentry.io
コンテナ化された環境でClaude Codeを使用する場合は、これらのURLをホワイトリストに登録してください。
ターミナルのセットアップを最適化し環境を設定
Claude Codeは、ターミナルが適切に設定されている場合に最も効果を発揮します。これらのガイドラインに従って、体験を最適化してください。
サポートされているシェル:
- Bash
- Zsh(Fishシェルは現在サポートされていません)
テーマと外観
Claudeはターミナルのテーマを制御できません。これはターミナルアプリケーションによって処理されます。オンボーディング時または/config
コマンドを使用して、いつでもClaude Codeのテーマをターミナルに合わせることができます。
改行
Claude Codeに改行を入力するには、いくつかのオプションがあります:
- クイックエスケープ:
\
に続いてEnterを押して改行を作成 - キーボードショートカット: 適切な設定でOption+Enter(Meta+Enter)を押す
ターミナルでOption+Enterを設定するには:
Mac Terminal.appの場合:
- 設定 → プロファイル → キーボードを開く
- “Optionをメタキーとして使用”をチェック
iTerm2とVSCodeターミナルの場合:
- 設定 → プロファイル → キーを開く
- 一般で、左/右Optionキーを”Esc+“に設定
iTerm2とVSCodeユーザー向けのヒント: Claude Code内で/terminal-setup
を実行して、より直感的な代替としてShift+Enterを自動設定できます。
通知の設定
適切な通知設定で、Claudeがタスクを完了したことを見逃さないようにします:
ターミナルベル通知
タスク完了時のサウンドアラートを有効にします:
macOSユーザー向け: システム設定 → 通知 → [ターミナルアプリ]で通知権限を有効にすることを忘れないでください。
iTerm 2システム通知
タスク完了時のiTerm 2アラート:
- iTerm 2環境設定を開く
- プロファイル → ターミナルに移動
- “ベルを無音にする”と”アイドル時に通知を送信”を有効にする
- 希望する通知遅延を設定
これらの通知は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への接続
プロンプトキャッシュが有効になっていない場合は、以下も設定します:
標準のAWS SDK認証情報(例:~/.aws/credentials
またはAWS_ACCESS_KEY_ID
、AWS_SECRET_ACCESS_KEY
などの関連環境変数)が必要です。コストの削減と高いレート制限のためのプロンプトキャッシュについては、Amazon Bedrockにお問い合わせください。
Google Vertex AIへの接続
Vertex AI上のClaude Codeは現在us-east5
リージョンのみをサポートしています。プロジェクトがこの特定のリージョンでクォータを割り当てられていることを確認してください。
google-auth-libraryを通じて設定された標準のGCP認証情報が必要です。最適な体験のために、レート制限の引き上げについてGoogleにお問い合わせください。
開発コンテナのリファレンス実装
Claude Codeは、一貫性のある安全な環境が必要なチーム向けに開発コンテナ設定を提供します。この事前設定されたdevcontainerセットアップは、VS CodeのRemote - Containers拡張機能や同様のツールとシームレスに連携します。
コンテナの強化されたセキュリティ対策(分離とファイアウォールルール)により、無人操作のために権限プロンプトをバイパスするclaude --dangerously-skip-permissions
を実行できます。ニーズに合わせてカスタマイズできるリファレンス実装を提供しています。
devcontainerは実質的な保護を提供しますが、完全にすべての攻撃から免れるシステムは存在しません。常に適切なセキュリティプラクティスを維持し、Claudeの活動を監視してください。
主な機能
- 本番環境対応Node.js: 必要な開発依存関係を備えたNode.js 20をベースに構築
- 設計によるセキュリティ: 必要なサービスのみにネットワークアクセスを制限するカスタムファイアウォール
- 開発者フレンドリーなツール: git、生産性向上機能を備えたZSH、fzfなどを含む
- VS Codeとのシームレスな統合: 事前設定された拡張機能と最適化された設定
- セッションの永続性: コンテナの再起動間でコマンド履歴と設定を保持
- どこでも動作: macOS、Windows、Linux開発環境と互換
4ステップで始める
- VS CodeとRemote - Containers拡張機能をインストール
- Claude Codeリファレンス実装リポジトリをクローン
- リポジトリをVS Codeで開く
- プロンプトが表示されたら、“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の商用利用規約に従います。
Was this page helpful?