はじめに#

AI コーディング支援といえば VS Code の拡張が主流ですが、ターミナルで完結する開発フローを好むエンジニアにとって IDE 前提のツールは相性が悪いことがあります。
Claude Code は Anthropic が提供する CLI ベースの AI エージェントで、ターミナルから直接コードの読み書き・実行・Git 操作までを対話的に行えます。

この記事では Claude Code の導入から、日常の開発フローに組み込むまでの流れを紹介します。

インストールと初期設定#

Claude Code の利用には Anthropic の Pro・Max・Team・Enterprise、または API（Console）アカウントが必要です。
無料プランでは利用できません。

インストール方法は 2 通りあります。

• Node.js 不要のネイティブインストーラー

$ curl -fsSL https://claude.ai/install.sh | bash
$ claude

• npm でグローバルインストール

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

初回起動時に Anthropic アカウントとの認証が走ります。
ブラウザが開くので、ログインして承認すれば完了です。

認証後、プロジェクトのルートディレクトリで claude を実行するだけで対話が始まります。
Claude Code は起動時にディレクトリ構造やファイルの内容を読み取り、プロジェクトの文脈を自動的に把握します。

基本の使い方#

Claude Code の操作はシンプルです。ターミナルに自然言語でやりたいことを伝えるだけで動きます。

$ claude
> このプロジェクトの構成を教えて
> src/utils/auth.ts のバリデーションにメールアドレス形式のチェックを追加して
> 直近の変更をコミットして

ファイルの読み取り・編集・作成、シェルコマンドの実行、Git 操作など、開発に必要な操作は一通りカバーされています。
破壊的な操作（ファイル削除や git push など）の前には確認プロンプトが出るため、意図しない変更が走る心配はありません。

$ claude -p "package.json の依存パッケージで非推奨になっているものを教えて"
$ claude -p "src/components/Header.tsx を TypeScript の strict モードに対応させて" --allowedTools Edit,Write

permission の設定#

Claude Code を快適に使ううえで重要なのが .claude/settings.json による permission 設定です。
デフォルトでは Bash コマンドの実行ごとに承認が必要ですが、安全なコマンドは事前に許可しておけます。

1
{
2
  "permissions": {
3
    "allow": [
4
      "Bash(pnpm lint)",
5
      "Bash(pnpm check)",
6
      "Bash(pnpm build)",
7
      "Bash(git status)",
8
      "Bash(git diff*)",
9
      "Bash(git log*)"
10
    ],
11
    "deny": [
12
      "Bash(git push --force*)"
13
    ]
14
  }
15
}

リント・ビルド・Git の読み取り系は allow に入れ、git push --force のような破壊的コマンドは deny で明示的にブロックします。
これがないと、エージェントが毎回承認を求めてきて作業のテンポが崩れます。

CLAUDE.md でプロジェクト文脈を渡す#

プロジェクトのルートに CLAUDE.md を置くと、毎セッション自動的に読み込まれます。
ここにスタック情報・コーディング規約・よく使うコマンドを書いておくと「この repo は何？」から始まる説明コストがゼロになります。

1
## Stack
2
- Astro 5 + Svelte 5 + Tailwind 3
3
- Package manager: pnpm
4
- Formatter: Biome (tabs, double quotes)
5

6
## Commands
7
| Purpose | Command |
8
|---|---|
9
| Dev server | `pnpm dev` |
10
| Build | `pnpm build` |
11
| Lint | `pnpm lint` |

CLAUDE.mdは短く保つのが推奨されています。
プロジェクトが育って情報量が増えたら、slash command やサブエージェントに切り出す方法を検討してください。

日常ワークフローの例#

実際にこのブログの運用で使っている典型的なフローを紹介します。

1
> ビルドで Warning が出ている。原因を調べて修正して

1
> src/utils/ にある日付関連のヘルパーが 3 ファイルに散らばっている。1 つに統合して

1
> git diff main...HEAD の変更をレビューして。セキュリティとパフォーマンスの観点で

まとめ#

• Claude Code はターミナルから AI エージェントとペアプログラミングできる CLI ツール
• .claude/settings.json の permission 設定で安全なコマンドを事前許可し、作業テンポを確保する
• CLAUDE.md にプロジェクト文脈を書いておけば、毎セッションの説明コストがなくなる
• バグ修正・リファクタリング・コードレビューなど、日常の開発タスクにそのまま組み込める

まずは npm install -g @anthropic-ai/claude-code でインストールし、
既存プロジェクトのディレクトリで claude を起動してみるところから始めるのがおすすめです。