Claude CodeはAnthropicが2025年に出したCLIツールで、2026年にはTerminalをよく使う人の主力になっています。ファイルを直接読み書きし、コマンドを実行し、gitを操作し、MCPで外部ツールにつながります。ClaudeやChatGPTのWeb版に「コードを貼る → 返答をもらう → 自分で直す」流れとはまったく違います。この記事ではインストールからhooks / MCP / スケジュールまでまとめます。

TL;DR:Claude CodeはAnthropicのCLIツールで、Terminalの中でClaudeと直接対話できます。開発者向けで、ファイルの読み書き、コマンド実行、MCPプラグイン接続ができ、CLAUDE.mdと組み合わせると自分専用のAI開発環境を作れます。

最初からTerminalに怖がる必要はありません。入門順序は短いです。Node.jsを入れる、Claude Codeを入れる、ログインする、安全なフォルダで最初の対話を走らせる、CLAUDE.mdを作る。安定してファイルを読み、小さな文章を直し、diffを理解できるようになってから、hooks、MCP、スケジュールタスクへ進めば十分です。完全な手順は Claude Code初心者ガイド にあります。

Claude Codeとは

Claude CodeはAnthropic公式のagentic開発ツールで、CLI、Desktop、Cloudの3形態があります。Terminalで claude と入力するとClaudeと対話でき、ファイルシステムを直接操作します。

Claude/ChatGPTのWeb版との違いはここです。Claude/ChatGPTはブラウザの中にいて、コードを貼ると修正案を返し、人が手でコピーして反映します。Claude Codeはプロジェクトフォルダを直接読み、編集して保存します。

実際の使用感としては、「この関数のエラーハンドリングを足して」と入力すると、ファイルを開き、その関数を見つけ、try-catchを追加し、保存までします。あとはdiffを確認するだけです。

Claude Code Terminalインターフェイスのイメージ

他のAI codingツールとの最大の違いは、Claude CodeにGUIがないことです。サイドバーもきれいなボタンもなく、ただのTerminalです。CLIに慣れている人には長所で、慣れていない人にはハードルです。詳しい比較は Claude Code vs Cursor をどうぞ。

インストール手順

事前に必要なもの

  • Node.js 18以上(バージョン管理にはnvmがおすすめ)
  • macOSまたはLinux(WindowsはWSL2)
  • Anthropicアカウント

インストール

npm install -g @anthropic-ai/claude-code

インストール後、Terminalで次を入力します。

claude

初回起動時にAnthropicアカウントへのログインを求められます。案内に従えば対話を始められます。

インストール後、環境確認として簡単なテストをします。

claude "列出目前資料夾裡的所有 .md 檔案"

lsglob を使ってMarkdownファイルを探してくれるはずです。正しく返ればインストール成功です。

よくあるインストール問題

Node.jsのバージョンが古いnode -v で確認し、18未満ならアップグレードします。nvmなら nvm install 18 && nvm use 18

権限問題:macOSで権限エラーが出ても sudo npm install -g は使わず、nvmでNode.jsを管理した方がこの問題を避けられます。

初心者向けの詳しい手順は Claude Code初心者ガイド にあります。

主要機能

Terminal AI:自分の環境の中で働く

Claude Codeの基本能力は、Terminalの中にいるAIアシスタントであることです。できることは次の通りです。

  • ファイルの読み書き:コードを直接見て、修正し、新規ファイルを作る
  • コマンド実行:git、npm、任意のCLIツールを実行する
  • コード検索:grep/globでプロジェクト全体を探す
  • 文脈理解:CLAUDE.mdや関連ファイルを読み、プロジェクトの状況を理解する

実用場面はコード監査です。「最近のcommitにセキュリティ問題がないか確認して」と言うと、git diff を走らせ、ファイルを順番に見て、潜在リスクを報告します。以前なら30分かかるreviewでも、3分でレポートを読めることがあります。

Hooks:自動トリガー

Hooksは特定のイベントが起きたときに自動で処理を実行する仕組みです。たとえば:

  • Claude Codeがbashコマンドを実行する前に、危険な操作がないか確認する
  • 対話終了時に作業記憶を自動更新する
  • ファイル変更後にlinterを自動実行する

設定は settings.json に書きます。よくあるhook設定は、Claude Codeが git push --force を実行する前にブロックし、productionを壊す事故を避けることです。

HooksはClaude Codeと純粋なチャットツールを分ける大きな違いの一つです。AIの行動を制約し、自動化できます。

MCP:能力を無限に広げる

MCP(Model Context Protocol)はClaude Codeのプラグインシステムです。MCPを通じてClaude Codeをさまざまな外部ツールにつなげられます。

よく使われるMCP serverには、ブラウザ操作、データベース問い合わせ、外部APIがあります。設定すると、TerminalでClaudeに「このAPIの返り値形式を確認して」と言うだけで、MCP経由で呼び出せます。

MCPの設定ファイルは .claude/ フォルダ配下にあり、JSON形式で各serverの接続方法と利用可能なツールを定義します。

Scheduled Tasks:スケジュールタスク

Claude Codeは /loop コマンドで繰り返しタスクを設定でき、毎日または毎週実行できます。Desktop版は最長3日、Anthropic Cloud版は無期限に動かせます。

よくあるスケジュールタスク:

  • 毎朝コンテンツスケジュールを走らせ、書き終えた草稿をBufferへ送る
  • 定期的にコード健診をする
  • 毎週作業記憶を整理し、古い情報を消す

スケジュールタスクはhooksと組み合わせると特に強力です。タスク完了後に通知を出し、状態ファイルを更新する流れまで自動化でき、人の介入が不要になります。

Claude Codeスケジュールタスクの流れ

CLAUDE.md:AIにルールを覚えさせる

Claude Codeの設計で一番賢いところはCLAUDE.mdです。きちんと設計すれば、覚えてほしいことをすべて覚えさせられます。

プロジェクトルートに CLAUDE.md を置くと、Claude Codeは起動時に毎回自動で読みます。そこには次のようなことを書けます。

  • プロジェクトのコード規約
  • 禁止事項(たとえば git push --force 禁止)
  • 好みのツールと作業フロー
  • ファイル構造の説明

自然な進化は、まず10行から始めることです。つまずいたたびに1つルールを足していく。3か月後にはかなり個人化されたAI運用マニュアルになります。

Cursorの .cursorrules に似ていますが、Claude CodeのエコシステムではCLAUDE.mdでさらに多くのことができます。たとえば複数ファイルへのルール参照や階層的な読み込みです。

Cursorとの違い

両方使った結論は、位置づけが完全に違うということです。

比較項目Claude CodeCursor
インターフェイスTerminal(CLI)IDE(GUI)
使い始めの難易度中〜高。Terminalに慣れが必要低い。入れたら使える
柔軟性非常に高い。任意のコマンドを実行できる中程度。IDEの枠に制約される
自動化hooks + スケジュール + MCP限定的
向いている人CLI好き、DevOps、重度自動化ユーザーフロントエンド、一般開発者、早く始めたい人

Claude Codeを選ぶ理由として多いのは、もともとの作業フローがTerminalにあることです。git、npm、docker、全部Terminalで操作する。その同じ環境にAIアシスタントがいる方が、別IDEに切り替えるより自然です。

Cursorとの詳しい比較は Claude Code vs Cursor比較 をどうぞ。

Claude Code / Cursor / Copilot 判断表

利用場面推奨ツール理由
Terminal中心、repo-wideタスク、スケジュール、自動化Claude CodeCLI原生で、ファイル編集、コマンド実行、hooks / MCPに強い
frontend、ライブプレビュー、IDE内でdiff確認CursorGUI、inline diff、多ファイルComposerが滑らか
チームがGitHub PR / issue中心GitHub CopilotPR review、issue → PR、組織policyとの統合が深い
OpenAI-family coding pipelineを自作CodexAPI / token billingの入口で、custom統合に向く

この表は Claude Code vs Cursor の核心判断です。Claude CodeとCursorは単純な代替関係ではありません。Claude CodeはTerminal agent、CursorはAI IDE、CopilotはGitHub workflow assistantです。

高度な使用場面

Multi-Agent管理

OpenClawはClaude Codeで組んだmulti-agentシステムです。4つのagentが別々の役割を持ちます。Opusは戦略、Sonnetは機械的タスク、Codexはコード、Geminiは意見出しです。

Claude Codeはこのシステム全体の操作インターフェイスです。Terminalの中でagentを切り替え、タスクを振り、各agentの出力を確認します。

コンテンツ制作

長文の初稿もClaude Codeの中で作れます。アウトラインとスタイルガイドを渡し、草稿を作らせ、そこから修正します。全工程をTerminalから出ずに進められます。

コード監査

新しいcommitがあるたびに、Claude Codeへ安全チェックを任せられます。diffを読み、注入リスクを探し、機密情報が誤ってcommitされていないか確認します。

つまずき記録

Context windowが爆発した:Claude Codeの会話にはtoken上限があります。最初はすべての記憶ファイルをCLAUDE.mdに詰め込んでいて、800行以上あり、会話開始時点で大量のcontextを消費していました。後で階層構造に分け、必要なときだけ特定ファイルを読むようにしたら、context使用量を半分ほど削れました。

Hookを書き間違えて無限ループになった:hookを「ファイル変更のたびにlintする」にしていましたが、lintが自動修正でファイルを書き換え、それが次のhookを呼びました。連鎖して何十回も走り、Ctrl+Cで止めました。教訓:hookの発火条件には、自分自身を呼ばないための防護が必要です。

スケジュールタスクのタイムゾーン問題:スケジュールをUTCで設定していたのに、サーバーは台湾時間のつもりで見ていました。朝8時のタスクが深夜0時に走ってしまいました。スケジュール確認時はwall clockと設定タイムゾーンを必ず合わせる必要があります。

初心者はここから

初めてClaude Codeに触れる人へのおすすめルート:

  1. まず環境を入れて、簡単な会話をいくつか試す
  2. プロジェクトに CLAUDE.md を作り、一番大事なルールを3つ書く(またはClaudeに書いてもらう)
  3. 毎日やっている作業を1つ任せてみる
  4. つまずいたらCLAUDE.mdを更新し、少しずつ蓄積する

より詳しい初心者ガイドは Claude Code初心者ガイド をどうぞ。

こぺんぎんの体験談

こぺんぎんの主力はClaude Codeで、毎日Terminalを開いた最初に起動します。記事を書く、コードを書く、スケジュールを管理する、multi-agentシステムを回す。全部その中で完結しています。CLAUDE.mdはすでに一つのルールシステムに進化していて、最初の10行から、今では階層化された複数ファイル構成になりました。このルール設計こそ、Claude Codeと他のAI codingツールの最大の違いです。

OpenClawのmulti-agentシステムもClaude Codeをベースに組んでいます。Opusは戦略 / Sonnetは機械的タスク / Codexはコード / Geminiは第三者視点。一般ユーザーにこの複雑さは不要ですが、multi-agentワークフローを試したいなら、今のところClaude Codeが一番支えられるツールです。

Cursorは日常フローには入りませんでした。もともとの作業がTerminal中心だからです。IDE路線はAntigravityで試しました。プロジェクトを見ながら、コードを書いている最中にAIが提案してくれる体験は、IDEに慣れている人にはかなり自然です。ただ、こぺんぎんの作業は「設定して自動で走らせる」方向なので、hooks + スケジュール + MCPは今のところ他ツールが追いつきにくい部分です。

関連記事

よくある質問

Q: Claude Codeとは何ですか?

Claude CodeはAnthropicが出しているCLIツールで、Terminalの中でClaudeと直接やり取りできます。ファイルの読み書き、コマンド実行、コード検索ができ、開発者が慣れたTerminal環境でAIを使うのに向いています。

Q: Claude Codeは有料ですか?

Claude CodeにはAnthropicのPro($20/月)以上のサブスクリプション、またはAPI課金が必要です。ヘビーユーザーはProの5倍・20倍の利用量があるMax 5x($100/月)やMax 20x($200/月)も検討できます。

Q: Claude CodeとCursorの違いは?

Claude CodeはTerminalで動き、CLIに慣れた開発者に向いています。柔軟性は高い一方でハードルも高めです。CursorはIDEで、GUIとリアルタイムプレビューがあり、エディタ内で直接AIを使いたい人に向いています。両者は役割が違い、置き換え関係ではありません。

Q: CLAUDE.mdとは何ですか?何に使いますか?

CLAUDE.mdはプロジェクトルートに置く設定ファイルです。Claude Codeは起動するたびに自動で読みます。プロジェクトルール、コードスタイル、注意事項を書いておくと、毎回同じ説明をしなくてもAIが好みを覚えてくれます。

Q: Claude Codeはスケジュールタスクを自動実行できますか?

できます。Claude Codeはscheduled tasksに対応しており、毎日のコード監査、コンテンツ公開、データ更新などを定時実行できます。

Q: Claude CodeはどのOSに対応していますか?

Claude CodeはmacOSとLinuxに対応しています。WindowsユーザーはWSL2経由で使えます。インストールにはNode.js 18以上が必要です。

Q: Claude CodeのMCPとは何ですか?

MCP(Model Context Protocol)は、Claude Codeをデータベース、API、ブラウザなどの外部ツールやデータソースにつなぐ仕組みです。MCPを通じてClaude Codeの能力を大きく拡張できます。


— Penchan