Claude Code: 基本操作
AIアシスタントを使ったコーディングは、最初は圧倒されるように感じるかもしれません。Claude Codeは、隣に座っている知識豊富な同僚のようなものです。やりたいことを平易な日本語で説明すれば、目標達成を手伝ってくれます。このチュートリアルでは、会話の開始からワークスペースの管理まで、日々使用する基本的な操作を学びます。
主要な概念
- ワークスペース - Claude Codeを起動したフォルダ。そのセッション中、Claudeはこのフォルダ内のファイルを読み取り、編集します
- REPL(Read-Eval-Print Loop) - コマンドを入力し、Claudeが応答し、終了するまで会話が続く対話型セッション
- コンテキスト - Claudeが記憶するコードと会話履歴の量。時間とともに満杯になる作業メモリのようなもの
- スラッシュコマンド -
/で始まる組み込みショートカットで、履歴のクリアやヘルプの表示など特定のアクションを実行
必要なもの
ステップ1: ターミナルを開く
- Windows: Windowsキーを押し、
PowerShellと入力してEnterを押し、PowerShellを開きます - Mac:
Cmd+Spaceを押し、Terminalと入力してEnterを押します
注意: Windowsインストールチュートリアルでネイティブインストールではなく、オプションのWSL/Ubuntuの方法を設定した場合は、代わりにUbuntuアプリを開き、以下のステップではLinux形式のパス(例: /mnt/c/Users/YourName/...)を使用してください。
コマンドを入力できるウィンドウが開きます。
ステップ2: デモプロジェクトファイルを取得する
実際のデータサイエンスプロジェクトを使用して、Claude Codeの機能を探索します。Gitでクローンするか、直接ダウンロードできます。
オプションA: Gitでクローン(Gitがインストールされている場合):
git clone https://github.com/gexijin/data_projects
cd data_projects
オプションB: Gitなしでダウンロード:
- Webブラウザでhttps://github.com/gexijin/data_projectsにアクセスします
- 右上近くの緑色のCodeボタンをクリックします
- Download ZIPをクリックします
- ZIPファイルをダウンロード(Downloads)フォルダに解凍します。GitHubは解凍したフォルダにdata_projects-mainという名前を付けます。このチュートリアルの他の部分と一致させるため、data_projectsに名前を変更してください。Windowsでは、すべて展開を使うとフォルダの中にフォルダが作られることがあります(data_projects-main → data_projects-main)。フォルダを開いて、中にもう1つdata_projects-mainフォルダしかない場合は、その内側のフォルダをダウンロードフォルダに移動し、data_projectsに名前を変更してください。
- ターミナルで、解凍したフォルダに移動します:
cd ~/Downloads/data_projects
別の場所に解凍した場合はパスを調整してください。
ステップ3: フォルダからClaude Codeを起動する
ターミナルで(data_projectsフォルダ内にいることを確認してください)、次のように入力します:
claude
| インストールチュートリアル(Windows | Mac)に従って、Claudeサブスクリプションでログインしてください。ログイン後、ウェルカムメッセージとClaude Codeのプロンプトが表示されます。 |
ステップ4: プロジェクトについて質問する
Claude Codeは必要に応じて自動的にファイルを読み取ります。プロジェクトを理解するために、以下の質問を試してみてください:
フォルダ構造について質問:
このプロジェクトのフォルダ構造を教えてください
テクノロジーについて質問:
このプロジェクトで使用しているテクノロジーとライブラリを説明してください
最近の変更について質問:
このプロジェクトへの最新の変更内容は何ですか?
Claudeは(利用可能な場合)Git履歴をチェックし、最近のコミットについて教えてくれます。
コードについて何でも自然言語で質問できます。Claudeは必要に応じてファイルを読み取って質問に答えます。
ステップ5: 重要なスラッシュコマンド
/と入力すると、利用可能なすべてのコマンドが表示されます。最も重要なものは以下の通りです:
すべてのコマンドを表示:
/
これにより、すべてのスラッシュコマンドのメニューが表示されます。矢印キーで閲覧し、Enterで選択、Escでキャンセルします。
ヘルプを取得:
/help
Claude Codeの使用に関するドキュメントを表示します。
コンテキスト使用状況を確認: Claudeの「作業メモリ」であるコンテキストを管理することが重要です。
/context
会話履歴をクリア:
コンテキストが満杯になったり、トピックを変更したい場合は、/clearで新しい会話を開始します。
/clear
現在の会話を消去し、新たに開始します。会話が長くなりすぎた場合にも使用します。コンテキストを管理することは重要です。
Claude Codeを終了:
/exit
セッションを終了し、通常のターミナルプロンプトに戻ります。Ctrl + Cを2回押すこともできます。
ステップ6: 変更を承認し、ショートカットを使う
新しいセッションは通常Autoモードで始まり、Claudeは日常的な編集やコマンドを確認なしで処理します。Claudeが許可を求める場合は、YesやNoなどの選択肢を含む小さなメニューが表示されます。矢印キーで選択肢をハイライトし、Enterを押してください。すべての変更を自分で承認したい場合は、プロンプトの下のモード表示がManualになるまでShift+Tabを押してください。
いくつかのキーボードショートカットを使うと、Claude Codeでの作業がさらに速くなります:
- Shift+Tab - モード(Auto、Manual、Accept Edits、Plan)を順に切り替え。現在のモードはプロンプトのすぐ下に表示されます。Planモードは、Claudeが変更を加える前に複雑なタスクを確認したいときに便利です
- Ctrl+C - 現在の操作またはClaudeの応答をキャンセル
- Esc - Claudeの応答を途中で止める、またはメニューを閉じる
\を入力してEnter(またはCtrl+J) - メッセージを送信せずに新しい行を追加
ステップ7: CLAUDE.mdファイルを必ず作成する
CLAUDE.mdファイルは、プロジェクトのClaudeに対する取扱説明書です。セッション間で保持されるため、Claudeはプロジェクトに関する重要なコンテキストを記憶します。
ファイルを作成:
/init
Claudeはプロジェクトの概要を含むファイルを作成します。このファイルはプロジェクトルートに保存され、新しいセッションを開始するたびにClaudeが自動的に読み取ります。
プロジェクト固有の指示、コーディング規約、ファイルの目的などの重要なコンテキストを追加するために、プロジェクトフォルダ内のCLAUDE.mdをいつでも編集できます。
ステップ8: ファイルやコード行を参照する
@を使用して特定のファイルを参照できます:
@Visualization/Matplotlib/Nested_Pie_Chart.ipynb のコードを説明してください
Claudeはノートブックを読み取り、その内容、動作の仕組み、コードが何を達成するかを説明します。これにより、ファイルをコンテキストに効果的に追加できます。
VS CodeでClaude Code拡張機能を使用している場合は、ファイルを開くだけでコンテキストに追加されます。Claude Codeのプロンプト入力欄の下部にNested_Pie_Chart.ipynbと表示されます。これで、Claudeはあなたがこのファイルについて話していることを理解します。
さらに、数行のコードを選択すると、Claudeは3 lines selectedと表示します。これらの行に素早く変更を加えたり、質問したりできます。このため、VS CodeからClaude Codeを使用することを強くお勧めします。
ステップ9: ターミナルコマンドでアクションを実行する
Claudeは自然言語の指示をターミナルコマンド(Mac/LinuxではBash、WindowsではGit BashまたはPowerShell)に変換して実行できます。
- ソフトウェアをインストール
pandasライブラリをインストールしてください - バージョン管理を開始
Gitを使用して変更の追跡を開始してください。私の名前はジェームズ・ボンドで、メールアドレスはbond@earth.comです - 変更をコミット
これらの変更をコミットしてください - データを検索してダウンロード
UCIからワイン品質データセットをダウンロードして、wineという新しいフォルダに入れてください - コードを実行
ネストされた円グラフのコードを通常のPythonスクリプトとして書き直してください。実行して、新しいコードとプロットを同じフォルダに保存してください
Claudeはソフトウェアのインストール、エラーのトラブルシューティング、環境の管理をすべて自動で行います。
基本的に、ターミナルコマンドの専門家があなたのために働いてくれます。権限を管理し、アクションを承認する限り、非常に生産的に作業できます。
次のステップ
基本を理解したので、以下を自分で試してみてください:
- プロジェクト内のフォルダにある機械学習アルゴリズムの説明をClaudeに依頼する
- 既存のノートブックへの変更をリクエストする(チャートの色の変更や新機能の追加など)
- プロジェクトのデータを使う新しいPythonスクリプトを作成する
- コードベース内の2つの異なるアプローチの比較をClaudeに依頼する
トラブルシューティング
- 「Command not found」エラー - Claude CodeがインストールされていないかPATHに含まれていません。WindowsまたはMacのインストールチュートリアルをもう一度実行するか、インストーラーを直接再実行してください:
irm https://claude.ai/install.ps1 | iex(Windows PowerShell)またはcurl -fsSL https://claude.ai/install.sh | bash(Mac/WSL)。 - Claudeが古い情報を提供する -
/clearでコンテキストをクリアして、再度質問してください。長い会話はClaudeのメモリを満杯にする可能性があります。 - ファイル変更が機能しない - プロジェクトフォルダに書き込み権限があることを確認してください。Claudeが承認を求めてきた場合は、表示されるメニューからYesを選択してください。
- コンテキストが急速に満杯になる -
/contextを使用して使用状況を確認してください。ほぼ満杯になったら、/clearを使用して新しい会話を開始してください。
ワークフロー概要
Claude Codeでの作業は、次のパターンに従います:
- プロジェクトフォルダで
claudeを使用してClaudeを起動 - 自然言語で質問やリクエストを入力
- Claudeは必要に応じてファイルを読み取り、応答
- コード変更をリクエスト(Claudeが許可を求めてきたらYesを選択)
- トピックを変更する場合やコンテキストが満杯になった場合は
/clearを使用 - 完了したら
/exitを使用
作成者:Steven Ge、2025年12月14日