設定ファイルを1行変えるだけ！Claude Codeの便利機能を自動で呼び出そう
【これを読むと何ができるようになる？】
このTipsを読むと、あなたがいつも行っている作業を、Claude Codeが自動で実行してくれるようになります。例えば、「コードを書き終えて保存した瞬間に、自動でプログラムのエラーチェックを走らせる」といったことが、これまでよりもずっと簡単な設定で実現できます。
準備するもの
- Claude Codeがあなたのパソコンにインストールされていること
- 自動で動かしたい処理が、便利な道具（MCPツール）として準備されていること
手順（ステップごとに丁寧に）
ステップ1：ターミナル（命令を打ち込む黒い画面）を開く
まずは、Claude Codeに命令を出すための「ターミナル」という画面を開きましょう。パソコンの操作はここから行います。
- Macの場合: 「アプリケーション」フォルダの中の「ユーティリティ」フォルダにある「ターミナル.app」をダブルクリックします。
- Windowsの場合: スタートメニューで「PowerShell」または「cmd」と検索して、出てきたアプリをクリックします。
ステップ2：Claude Codeの設定ファイルを開く
次に、これから設定を書き込むためのファイルを開きます。このコマンドは「Claude Codeの設定ファイルを、テキストエディタで開いてください」という命令です。
code ~/.claude/config.json（お使いのテキストエディタがVisual Studio Codeでない場合は、codeの部分をopenやstartなどに置き換えてみてください）
ステップ3：設定を書き換える
設定ファイルが開いたら、「hooks」という項目を探しましょう。これが「特定のタイミングで自動で動く仕組み」の設定場所です。ここに、新しい設定方法で書き換えていきます。
【これまでの書き方】
これまでは、一度パソコン自身に命令するプログラム（シェル）を経由する必要があり、少し回りくどい書き方でした。
"hooks": { "on_save": { "type": "shell", "command": "claude-code mcp-tool-run my_checker_tool" } }【これからの書き方】
アップデートによって、たった2行で直接「道具」を呼び出せるようになりました。typeに"mcp_tool"と書き、tool_nameに使いたい道具の名前を指定するだけです。これは「ファイルを保存したとき(on_save)に、my_checker_toolという名前の道具を使ってね」という意味になります。
"hooks": { "on_save": { "type": "mcp_tool", "tool_name": "my_checker_tool" } }このように書き換えたら、ファイルを上書き保存してください。
ステップ4：動作を確認する
設定が完了したら、実際にファイルを作成して保存してみましょう。ターミナルに「Tool ‘my_checker_tool’ executed successfully.」のような、道具がうまく動いたことを示すメッセージが表示されれば成功です！
【💡 そもそも、どの「ツール名」を使えばいいか分からない場合】
もしmy_checker_toolという名前のツール名が思い出せない場合は、一度、準備したMCPツールのファイル名（フォルダ名）をそのまま試してみるのが安全です。ファイル名とツール名は同じものが使える場合が多いです。
- 例： もしツール名が
report_generator.pyなら、"tool_name": "report_generator"として試してみましょう。
うまくいかないときは
- 「Tool not found: (ツール名)」と表示される場合
指定した名前の道具（ツール）が見つからない、というサインです。設定ファイルに書いたtool_nameの名前が、準備した道具の名前と一致しているか、もう一度確認してみましょう。 - 「Invalid hook type: mcp_tool」と表示される場合
お使いのClaude Codeのバージョンが古い可能性があります。この便利な機能はバージョン2.1.118から利用できます。ターミナルでclaude-code --versionと打ち込んでバージョンを確認し、もし古ければアップデートを試してみてください。 - 設定を保存しても何も起こらない場合
設定ファイルの書き方（例えば、行末のカンマのつけ忘れなど）が間違っているかもしれません。ファイル全体の構造が崩れていないか、見直してみましょう。
もっと活用するには
基本の使い方がわかったら、少し応用してみましょう。
"on_save"（保存したとき）の部分を"on_startup"（起動したとき）に変えてみてください。Claude Codeを起動するたびに、プロジェクトの初期設定を自動で行う、といった使い方ができて便利です。- 呼び出す道具（ツール）に、ファイル名などの追加情報を渡すこともできます。これにより、「保存したファイルだけを対象にエラーチェックする」といった、より賢い自動化も可能になります。
※Claude Codeは継続的にアップデートされます。最新情報は公式ドキュメントをご確認ください。
情報源：@gus_aragon のポストをもとに編集部が解説記事として構成しました。
コメント