Claude Codeを使ってみた #02 【基本キーワード集】

AI

Claude Codeを使ってみよう!

こんにちは、ECF Tech担当
Michiharu.Tです。

今回の記事では、Claude Codeを使ってみたレポートの第2弾として、Claude Codeを使う上で知っておきたい基本用語をご紹介します。内容は随時追加していく予定ですので、継続してご利用いただければ幸いです。

Claude Codeの動作、仕様は常に変更しつづけています。最新の動向・仕様については、公式サイト(https://code.claude.com/docs/ja) をご確認ください。

知っておきたい基本用語

コンテキスト(context)

簡単に言えば、Claudeの頭の中の記憶場所です。Claudeも1つの会話の中で記憶できる量に限りがあります。コンテキストがいっぱいになってくると、古い会話の内容があいまいになったり、忘れていたり、ということが起こります。

コンテキストの状況は、/contextで確認可能です。下図は、VS CodeのClaude Code用拡張機能で、/contextを実行した様子です。

VSCodeの権限モード

項目の説明については、また別の記事でご紹介させていただければと思います。

スキル(skill)

スキルは、特定の作業手順をあらかじめまとめておき、必要なときにClaudeが呼び出せるようにしたものです。筆者の場合は、「プログラム設計書に基づく作図作業」などを指示するのに使っていました。作業指示をする際に、「あ!なんだか同じことを何回もダラダラと書いて指示しているな」と思ったら、スキルを作成するタイミングだと思います。

繰り返し発生する作業手順をスキルとして登録しておくことで、毎回同じ指示を書かなくても、/スキル名のように記述すれば済むようになります。

スラッシュコマンド(slash command)

/から始まるコマンドのことです。Claude Codeにはあらかじめ多くのスラッシュコマンドが用意されています。単にコマンドということもあるようです。/exitのように、/から始まるコマンドを入力することで、Claudeに対する特定の操作を行うことができます。コマンドの一覧は下記の公式サイトからご参照ください。

コマンド - Claude Code Docs
Claude Code で利用可能なコマンドの完全なリファレンス。組み込みコマンドとバンドルされたスキルを含む。

/exit(終了)のほか、/context(コンテキスト状況の確認)、/clear(会話履歴のクリア)などは、個人的によく使うコマンドかなと思います。

権限モード(permission mode)

Claude Codeがファイルの編集やコマンドの実行を行う際に、ユーザーに確認を求めるかどうかを制御する仕組みです。安全性に配慮し、初期状態ではファイルの変更や外部への操作を伴う処理の前に、必ず確認画面が表示されます。

代表的な権限モードには、次のようなものがあります。

  • default:ツールを使うたびに確認を求める、最も安全なモード。初期状態はこちらになっています。
  • plan:ファイルの変更を一切行わず、計画の提示のみを行うモードです。(詳しくは後述します)
  • acceptEdits:ファイルの編集など一部の操作を確認なしで実行するモードです。

VS Code拡張機能のClaudeで権限モードを出力すると、次のように表示されます。

VSCodeの権限モード

上記はそれぞれ、次のモードに対応しています。

VS Codeのモード 上記権限モード
Manual default
Edit automatically acceptEdits
Plan plan
Auto bypassPermissions

bypassPermissionsは、長時間自動実行向けに設計された、自動化度合の高いモードです。熟練者向けのモードなので、本記事でのご紹介はしていません。利用し始めの方は、それ以外の3つのモードを少しずつ使っていきましょう。

サブエージェント(subagent)

メインのClaudeとは別に、特定の作業に特化した「もう一人のClaude」を呼び出して作業させる仕組みです。次のような、独立して完結する作業をサブエージェントに任せることができます。

  • コード全体からある機能の実装箇所を探す作業
  • 作成したコードのレビュー

サブエージェントは、調査した内容をすべてメインのClaudeに伝えるのではなく、要点だけを報告します。そのため、メインの会話のコンテキストを無駄に消費しないというメリットがあります。

メインの会話が上司、サブエージェントは部下のようなイメージですね。

CLAUDE.md

プロジェクトのルートフォルダなどにCLAUDE.mdという名前で配置する、特別なマークダウンファイルです。Claude Codeは起動時にこのファイルを自動的に読み込み、プロジェクトの目的やルール、コーディング規約などを把握したうえで作業を行います。

たとえば今回のようなブログ記事を作成するプロジェクトを作るのであれば、「記事はMarkdownで作成する」「書き方のトーンは、過去の記事と合わせる」といったルールを記載したCLAUDE.mdを用意して保存しておきます。それにより、Claudeは毎回それを踏まえて作業をしてくれます。

MCP(Model Context Protocol)

Claude Codeが、外部のツールやサービスと連携するための共通の規格(プロトコル)です。USBを使うとパソコンに色んな外部機器と接続ができるように、MCPを使うとClaudeに色んな機能やサービスが追加できるようになります。MCPを使うことで、GitHubやSlack、各種データベースといった外部サービスが、まるでClaudeに搭載されているかのように、チャットなどの会話を通じて使うことができます。

MCPは、Claude Code専用の仕組みではなく、他のAIツールでも採用が進んでいる規格です。公式サイトは下記です。

What is the Model Context Protocol (MCP)? - Model Context Protocol

プランモード(plan mode)

コードの変更やファイルの作成を一切行わず、「何をするか」の計画だけを提示させるモードです。複雑な作業や影響範囲の大きい作業を依頼するときは、まずプランモードで計画を確認し、内容に問題がなければ実行させる、という使い方が一般的です。

VS Code拡張機能で使用した場合は、あらかじめ計画した内容をマークダウンファイルとして出力してくれます。このマークダウンファイルを保存しておくことも指示できます。

おわりに

今回は、Claude Codeを勉強しながら、筆者が実際に触ってみた機能を中心にご紹介しました。Claudeにはまだまだ様々な機能がありますので、今後も新しい機能を使っていきながら、随時この記事に追記していく予定ですので、引き続きご覧いただけますと幸いです。どうぞよろしくお願いします。


[PR]
Claude Codeで本格的なプログラム開発を目指すための本です。
普段プログラムを書いている方、新人エンジニアの方におススメしたい本です。
Amazon.co.jp: ストーリーで覚えるClaude Code開発ガイド: 物語で学ぶAI駆動開発 物語で覚える開発入門 (ネクストステージ出版) eBook : 多佳宮 崇志: Kindleストア
Amazon.co.jp: ストーリーで覚えるClaude Code開発ガイド: 物語で学ぶAI駆動開発 物語で覚える開発入門 (ネクストステージ出版) eBook : 多佳宮 崇志: Kindleストア
タイトルとURLをコピーしました