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に直接送信されます
  • あなたの作業環境で動作: ターミナルで直接操作
  • コンテキストを理解: プロジェクト構造全体を把握
  • アクションを実行: ファイルの編集やコミットの作成など、実際の操作を実行

質問から解決まで数秒で

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

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

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

始める前に

システム要件の確認

  • オペレーティングシステム: 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処理にインターネット接続が必要

インストールと認証

1

Claude Codeのインストール

ターミナルで実行: npm install -g @anthropic-ai/claude-code

2

プロジェクトに移動

cd your-project-directory
3

Claude Codeを起動

実行 claude で起動
4

認証を完了

Consoleアカウントで1回限りのOAuth処理を行います。console.anthropic.comでアクティブな課金が必要です。

プロジェクトの初期化

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

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

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

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

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

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

Git操作の自動化

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

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

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

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

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

より深い思考を促す

複雑な問題については、明示的に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 mcpModel Context Protocolサーバーを構成$ claude mcp add pyright_lsp

CLIフラグ:

  • --print: 対話モードなしでレスポンスを表示
  • --verbose: 詳細なログを有効化
  • --dangerously-skip-permissions: 権限プロンプトをスキップ(インターネットのないDockerコンテナ内でのみ)

スラッシュコマンド

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

コマンド目的
/bugバグを報告(会話をAnthropicに送信)
/clear会話履歴をクリア
/compactコンテキスト空間を節約するために会話を圧縮
/config設定の表示/変更
/costトークン使用統計を表示
/doctorClaude Codeのインストール状態を確認
/help使用方法のヘルプを表示
/initCLAUDE.mdガイドでプロジェクトを初期化
/loginAnthropicアカウントを切り替え
/logoutAnthropicアカウントからサインアウト
/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ファイルを作成または上書きはい
NotebookReadToolJupyterノートブックの内容を読み取り表示いいえ
NotebookEditToolJupyterノートブックのセルを変更はい

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

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

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

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

  1. 承認前に提案されたコマンドを確認
  2. 信頼できないコンテンツを直接Claudeにパイプしない
  3. 重要なファイルへの提案された変更を確認
  4. 不審な動作は/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の場合:

  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='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

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

DISABLE_PROMPT_CACHING=1

標準のAWS SDK認証情報(例:~/.aws/credentialsまたはAWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYなどの関連環境変数)が必要です。コストの削減と高いレート制限のためのプロンプトキャッシュについては、Amazon Bedrockにお問い合わせください。

Google Vertex AIへの接続

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

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ステップで始める

  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の商用利用規約に従います。