Claude Codeとは？ターミナルで動くAIコーディングエージェントの使い方・料金・導入の注意点

Claude Codeとは、Anthropicが提供する、ターミナル上で動くAIコーディングエージェントです。自然言語で指示すると、リポジトリのファイルを読んで構造を把握し、コードの修正、テストやビルドの実行、Gitのコミットまでを、操作のたびに確認を挟みながら自律的に進めます。

チャット型のClaudeが「相談相手」だとすると、Claude Codeは「作業を代行する同僚」に近い存在です。その分だけ権限と機密情報の扱いを先に決めてから使う必要があり、後半はその判断材料（料金の仕組み、企業導入の論点、他ツールとの使い分け）に充てています。

Claude Codeとは：チャットのClaudeと何が違うのか

「エージェント」とは、与えられた目標に対して自分で手順を組み立て、ツール（ファイルの読み書き、シェルコマンド、検索）を呼び出しては結果を見て次の行動を決めるプログラムのことです。チャットのClaudeはユーザーが貼ったコードに回答を返すだけで、ファイルを開くこともテストを走らせることもできません。Claude Codeはカレントディレクトリのリポジトリを作業場所にして、次のように動きます。

できること：コード理解からGit操作まで

使い方は「リポジトリでclaudeを起動し、日本語で頼む」だけです。典型的な依頼と、Claude Codeが内部で行う動作を並べます。

苦手なのは、リポジトリの外にある前提（社内の暗黙ルール、本番環境の実状態）を知らないまま推測で進めてしまうことです。後述のCLAUDE.mdに前提を書くのは、この推測を減らすためです。生成された変更は必ず人がdiffを読む、という前提も変わりません。

インストールと初期設定

執筆時点の基本的な導入方法はnpm経由で、Node.js（対応バージョンは公式ドキュメント参照）が必要です。macOSとLinuxに加え、WindowsではWSL2上のLinuxとして使う方法とネイティブで動かす方法があります（執筆時点。ネイティブ利用にはGit for Windowsが必要）。npm以外の公式インストーラーも提供されているため、npmを使わない環境では公式ドキュメントの手順に従ってください。

npm install -g @anthropic-ai/claude-code   # sudo は付けない（npmのprefixをユーザー領域にする）
cd ~/repos/my-app
claude          # 初回はブラウザでAnthropicアカウントにログイン、またはAPIキーを設定
> /init         # リポジトリを解析して CLAUDE.md の雛形を生成
> /help         # コマンド一覧

初回起動時に、Claudeのサブスクリプションアカウントでログインするか、Anthropic ConsoleのAPIキーを使うかを選びます。どちらを選ぶかで課金の仕組みが変わります（後述）。/clearで文脈を捨てて次のタスクへ移り、/compactで長くなった履歴を要約して続行します。1つのセッションに無関係なタスクを詰め込むと、古い文脈が判断を鈍らせるうえトークン消費も増えるので、タスクごとに/clearする習慣が実用上の要点です。

基本的な使い方：対話・CLAUDE.md・権限の確認

CLAUDE.mdはリポジトリ直下に置くMarkdownで、Claude Codeが起動時に必ず読む「プロジェクトの記憶」です。ビルド・テストのコマンド、コーディング規約、触ってはいけないファイル、作業後に必ずやることを書いておくと、毎回の指示から前提の説明が消えます。Gitにコミットしてチームで共有するものと、~/.claude/CLAUDE.mdに置く個人用の2層があります。

# my-app
FastAPI + PostgreSQL 17。Python 3.12、依存は uv で管理。

## コマンド
- テスト: `uv run pytest -q`
- Lint / 型チェック: `uv run ruff check . && uv run mypy src`
- ローカル起動: `docker compose up -d db && uv run fastapi dev`

## ルール
- `.env*` と `secrets/` は読まない・書かない
- DBスキーマの変更には必ず Alembic のマイグレーションを追加する
- `git push --force` と main への直接コミットは禁止
- 変更後は必ずテストと lint を実行し、結果を報告してから終える

権限の仕組みはこうです。読み取り系（ファイル閲覧、検索）は確認なしで行い、ファイルの書き込みやシェルコマンドの実行の前には「このコマンドを実行してよいか」を都度確認します。プロンプトで「このセッション中は許可」を選ぶと同種の操作の確認が省かれ、.claude/settings.jsonのpermissionsにallowとdenyのルールを書けば、チームで同じ許可設定を共有できます。

{
  "permissions": {
    "allow": [
      "Bash(uv run pytest:*)",
      "Bash(git diff:*)",
      "Bash(git status)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(git push --force:*)"
    ]
  }
}

権限確認をすべて省略する起動オプション（--dangerously-skip-permissions）は、使い捨てのコンテナやCI専用のサンドボックスで使うためのものです。自分のPCや本番に届く環境では使わないでください。エージェントがrm -rfやgit reset --hardを「正しい判断」として実行する可能性は常にあり、確認プロンプトがその最後の防波堤です。

VS Code / JetBrains との連携

執筆時点でVS Code（およびCursorなどVS Code系エディタ）向けの拡張機能と、JetBrains IDE（IntelliJ IDEA、PyCharm、WebStormなど）向けのプラグインが提供されています。動作の主体はターミナルのClaude Codeのままで、統合によって変わるのは3点です。エディタで選択している範囲や開いているファイル、診断（lintエラー）が自動で文脈として渡されること、Claude Codeが加えた変更をエディタのdiffビューで確認できること、IDEのターミナルから起動すると作業ディレクトリが自動で一致することです。

導入は各エディタの拡張機能マーケットプレイスから行います。Remote SSHやDev Containersの中でも動作し、その場合はサーバーやコンテナ側にClaude Codeをインストールします。仕組みはRemote SSHのVS Code Server（UIは手元、処理は接続先）の分離と同じです。

料金の考え方：サブスクリプションとAPI従量

具体的な金額と上限は改定が続いているため、この記事では数字を書きません。判断の軸は「1日中使う人が何人いるか」です。毎日数時間使う人にはサブスクリプションの方が費用を読みやすく、週に数回の人や自動化用途はAPI従量の方が無駄が出ません。API利用時はセッション内で/costを打つとそのセッションのトークン消費と概算費用が表示され、コンテキストが長くなるほど1回あたりの入力トークンが増えるので、/compactや/clearが費用対策にもなります。

企業導入時の注意点：機密情報・ログ・レビュー・権限

Claude Codeは読んだファイルの内容と実行結果をAnthropicのAPIへ送信して回答を得るため、「どのデータが社外に出るか」を最初に決めます。個人向けプランと法人向けプラン・API利用ではデータの保持期間や学習利用の扱いが異なり、設定で変更できる項目もあるので、契約するプランの利用規約とプライバシーポリシーを原文で確認してください。オンプレのみで完結する製品ではないため、送信自体を避けたいリポジトリでは使えません。

CLAUDE.mdに「.envを読まない」と書いても、それは指示であって強制ではありません。強制したい制約はsettings.jsonのdenyルールに書き、さらに本番の認証情報は開発端末に置かない（AWSならSSOの短命トークン、DBなら検証用の別アカウント）という多層の構えにしてください。

GitHub Copilotなど他ツールとの使い分け

執筆時点では各製品が互いの機能（補完、チャット、エージェント）を取り込み続けており、機能表は数か月で変わります。判断基準は製品名ではなく「補完が欲しいのか、作業を任せたいのか」「契約とデータ規約が社内ルールに合うか」の2点で、補完系とエージェント系の併用は普通に行われています。

導入の実践ステップ

1. 機密性の低い社内ツールのリポジトリを1つ選び、2〜3人が個人アカウントまたはAPIキーで2週間試す。試す作業は「テスト追加」「ログ調査」「既存コードの説明」のような結果を検証しやすいものにする
2. /initで生成したCLAUDE.mdを実際のコマンドと規約で埋め、.claude/settings.jsonのdenyに秘密情報のパスを入れてコミットする
3. ブランチ保護でPRとレビューを必須にし、AI生成の変更もCIのテスト通過なしにはマージできない状態にする（Gitブランチ戦略の選び方）
4. 料金方式を決める。毎日使う人が数人ならサブスクリプション、まばらな利用や自動化はAPI。法人向けプランやクラウド経由が必要かは、監査・データ規約の要件で判断する
5. 2週間の記録（何を任せて、どこを直したか）をもとに対象リポジトリを広げ、生成AIガイドラインに「エージェント型ツール」の項目を追記する

よくある質問

Claude Codeは無料で使えますか？

ツール自体は無料で入手できますが、動かすにはClaudeの有料サブスクリプションか、Anthropic APIの従量課金（またはクラウド経由の課金）が必要です。無料枠やトライアルの有無・条件は執筆時点でも変更があるため、Anthropic公式の料金ページで確認してください。

Claude CodeとClaudeの違いは？

Claudeはブラウザやアプリで会話するチャットサービスで、貼り付けた内容に回答します。Claude Codeはターミナルで動くエージェントで、ローカルのファイルを読み、編集し、コマンドを実行し、Gitを操作します。同じモデルを使っていても、「提案する」だけか「作業を実行する」かが違い、後者には権限管理が必要です。

Windowsでも使えますか？

使えます。執筆時点ではWindowsネイティブでの動作（Git for Windowsが必要）と、WSL2上のUbuntuなどで動かす方法があります。Docker、Python、Ansibleなどのツールチェーンを揃えやすいのはWSL2側なので、開発環境がすでにWSL2にあるならそちらで動かすのが自然です。

社内コードを渡しても安全？

コードはAnthropicのAPIに送信されるため、契約プランのデータ保持・学習利用の条件を原文で確認したうえで、送ってよいリポジトリの範囲を決めるのが前提です。settings.jsonのdenyで認証情報を除外し、顧客データや規制対象データを含むリポジトリでは使わない、という線引きをして初めて「安全に使える」と言える状態になります。

まとめ

Claude Codeは「提案するAI」ではなく「作業を実行するAI」で、価値も危険もそこから来ます。導入時に決めるのは、CLAUDE.mdに書く前提、settings.jsonのdenyで守る範囲、PRレビューという受け入れ基準、そして課金方式の4つです。この4つを小さなリポジトリで固めてから広げれば、テスト追加やログ調査のような「時間はかかるが判断は単純」な作業を安心して任せられます。

次に読む

• MCPサーバーを自作して社内ツールをAIに接続する：Claude Codeから社内システムを安全に呼び出す仕組み
• VS CodeのRemote SSHとDev Containers：リモートのターミナルでClaude Codeを動かす土台