Claude Code の使い方

• 開発者：Anthropic（Claude の開発元）
• 形態：ターミナルの CLI が基本形。ほかにデスクトップアプリ・Web 版・VS Code / JetBrains 拡張
• 料金：Claude のサブスクリプション（Pro / Max）か API 従量課金
• できること：コードの読み書き・シェル実行・テスト・git 操作・Web 検索など、開発作業ほぼ一式

「補完ツール」ではなく「作業者」です。指示を出すと、必要なファイルを自分で探して読み、方針を立て、実装して、検証結果つきで報告してきます。

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

プロジェクトのルートで起動して、あとは日本語で話すだけです。

cd my-project
claude

初回はログイン（サブスク認証）を求められます。起動後は「このリポジトリの構成を説明して」あたりから始めると、何ができるかの感触がつかめます。

Claude Code とのやり取りは「指示を出す→エージェントがツール（ファイル編集・コマンド実行）を使って作業する→結果を報告してくる」の繰り返しです。

押さえておきたいのは権限モデルです。ファイルの書き換えや影響の大きいコマンドは、既定では実行前に許可を求めてきます。最初は全部確認しながら使い、信頼できる操作から順に許可リストへ入れていくと、確認疲れせずに安全側へ倒せます。

逆に、読み取り系（ファイルを読む・検索する）はどんどん任せて問題ありません。「読むのは自由・書くのと外に出るのは確認」が出発点として使いやすい線です。

リポジトリ直下に CLAUDE.md を置くと、毎セッション自動で読み込まれます。ここが Claude Code 運用の本丸で、「毎回口頭で言っていた指示」をここに書いて二度と言わないのが基本方針です。

うちの CLAUDE.md に入れているものの例：

• 開発の進め方（仕様を文書で合意してから実装する・テスト先行にする条件）
• 応答のルール（日本語で・完了報告は変更点の箇条書き＋検証結果に圧縮）
• 安全の線引き（秘密情報はコミットしない・本番反映とデータ削除は事前に一言）
• コミットの作法（author 固定・コメントは非自明な制約のみ）

コツは「命令の羅列」ではなく判断基準ごと書くことです。「テストを書け」より「計算・バリデーション・認可など壊れたら痛いロジックはテスト先行」のほうが、初見のタスクでも意図どおりに動いてくれます。

開設記録にも書いたとおり、このサイトの開発で私はコードを 1 行も書いていません。それでも破綻しないのは、確認が必ず来る操作を先に決めてあるからです。

• 必ず確認：お金が絡む操作・本番デプロイ・データ削除・外部に公開される変更
• 任せる：実装・テスト・リファクタ・デバッグ・ドキュメント更新

この線を引いた上で、日々のやり取りは「進めて」「続けて」「はい」がほとんどになります。エージェントの自走力を活かすほど、人間の仕事は「何を作るか」と「どこに確認の線を引くか」に寄っていきます。

実運用で踏んだ穴と対策です（順次追記）。

• ビルドは緑なのに本番だけ動かない：ローカルと本番の実行環境差（このサイトでは Cloudflare Workers にファイルシステムが無い等）はエージェントも踏みます。「ビルドが通る」ではなく「本番相当の環境で検証してから完了報告する」ルールにしておくと、この種の事故が減ります。
• セッションが長くなると文脈があふれる：1 セッション 1 タスクを目安に区切り、決定事項はファイル（設計メモや ADR）に書かせて次のセッションに引き継ぐのが安定します。「会話に覚えさせる」のではなく「リポジトリに書かせる」が原則です。
• 完了報告を鵜呑みにしない：「テスト緑」の報告には何のテストが何本通ったかまで言わせる、目に見える変更は自分でも一度見る。確認コストは残りますが、コードを書くコストよりずっと小さいです。

• Claude Code とこのサイトを 1 日で作った話 — 実際の開発の様子
• Claude Code 公式ドキュメント — インストール・設定の一次情報