Claude Code
ベストプラクティス

Cal 氏は約 1 年半前に Anthropic に入社し、Applied（アプライ）チームを立ち上げた人物だ。チームのミッションは「顧客やパートナーが Claude の上で素晴らしいプロダクトを作るのを助けること」。日々の仕事のほとんどは、モデルから最高の出力を引き出すためにプロンプトを書くことだという。

しかし Cal 氏はコードを書くのも好きだ。自分のことを「新しいプロジェクトを山ほど立ち上げるが、ほとんど完成させない、アイデア過多のコーダー」と笑って紹介する。書きかけのコードの「墓場」を抱えたエンジニアは世界中にいる。

金曜の夜、世界が変わった

昨年の終わり頃、社内 Slack で「新しいツールがすごいらしい」という噂を聞きつけた Cal 氏は、ある金曜の夜にそれをダウンロードした。のちに Claude Code と呼ばれることになるツールだ。以前から温めていた新しいメモアプリのアイデアにぶつけてみた結果——

その週末、コーディングとソフトウェアエンジニアリングに対する考え方が、完全に変わった。 Cal

ラップトップを抱えて週末中歩き回り、Enter キーを押してはブラウザを更新し、巨大で強力なアプリケーションが目の前で組み上がっていくのをただ眺めていた。一人では決して辿り着けなかったところまで辿り着いた——その体験に心を奪われた。

「Claude Code って結局何？」と聞かれたとき、Cal 氏はこう答える。

Cal 氏は駆け出しエンジニア時代のメンターを思い出す。バグに詰まって机まで行くと、彼は自分のターミナルをぐるりとこちらに向け、狂ったような bash コマンドと vim の操作で、あれよあれよという間に問題を解決してしまう。こちらは「すごい…いつか覚えよう」と思いながら席に戻り、結局覚えずじまいで終わる——そんな経験だ。

Claude Code をパソコンに入れることは、そのターミナル魔法使いをいつでも隣に座らせておくことに等しい。呼べば即答してくれるトニーが、常時待機している状態である。

「Claude Code って何に向いているの？」とよく聞かれる。率直な答えは、大体なんでも得意。ただし、輝く場面は確かにある。

1. ディスカバリーとオンボーディング

   新しいコードベースに放り込まれた最初の数日、人は最も非生産的になる。Claude に「この機能はどこに実装されてる？」「このファイルの Git 履歴を見て、過去数週間でどう変わったか物語風に説明して」と聞けば、立ち上がりが一気に早くなる。

2. 思考のパートナーとして使う（過小評価されている使い方）

   いきなり実装させるのではなく、まずはこう頼むといい：「この機能を実装したい。コードベースを調べて、2〜3 の実装方針を報告して。まだコードは書かないで」。返ってきた方針を吟味してから、合意できた方向で着手する。

3. ゼロからの構築

   空のディレクトリに「ゲームを作って」「アプリを作って」——デモ映えする使い方。とても楽しく、気持ちがいい。

4. 既存コードベースでの開発（こちらが本丸）

   現実に重要なのはこちら。Claude Code チーム自身のコードベースでは ユニットテストのカバレッジが異常に高い——テストを書くのが驚くほど簡単だからだ。コミットメッセージや PR の説明も整っている。「コミットして」「PR メッセージ書いて」と言うだけでいい。

5. 軽量なデプロイ・ライフサイクル自動化

   Claude Code には SDK（ヘッドレス利用、プログラマブル利用）がある。CI/CD に組み込む、GitHub Actions から呼び出す——コーディングエージェントを好きな場所に振りかけられる。

6. サポートと大規模リファクタ

   顧客の中には「古い Java から新しい Java へ」「PHP から React / Angular へ」といった、長年先延ばしにしてきた大規模移行を抱えるチームが多かった。Claude Code があると、こうしたプロジェクトが「一ヶ月リファクタに使います」とチームに切り出せる程度にまで消化しやすくなる。

プランニングと To-Do リストを使う

最高のやり方のひとつは——いきなり「バグを直して」と言わないこと。代わりにこう頼む：

プランを読めば、Claude がこれからやろうとしていることを事前に検証できる。時間を大幅に節約できる。

大きめのタスクでは、Claude が自分で To-Do リストを作る。作業を横目で見ながら、リストに変な項目や意図からずれたものが混じっていたら、Escape で止めて「このリスト、変えたい。方向が違うと思う」と介入する——これが理想的な関わり方だ。

賢い「バイブコーディング」

Claude に任せて Enter を押し、結果を待つ——楽しいし強力だが、落とし穴もある。以下を守ると大外れが減る：

• テスト駆動で：小さな変更 → テスト実行 → 通る、を繰り返させる
• 常に TypeScript と Lint をチェックさせる
• こまめにコミットする。暴走したら git で戻ればいい

スクリーンショットでガイド・デバッグ

Claude のモデルはマルチモーダルだ。画像を貼り付けるか、プロジェクト内のファイルを指して「この mock.png を見てウェブサイトを作って」と言うだけでいい。UI のバグ報告にも有効——スクショを渡して「この見え方を直して」で話が通じる。

複数の Claude を同時に走らせる

使いこなしてくると、どうしても複数の Claude を並列で動かしたくなる。Anthropic 社内にも、顧客の中にも、同時に 4 つの Claude を回している人たちがいる。tmux、別タブ、別ワークツリー——手段はさまざま。

自分は 2 つが精一杯。でも 4 つ同時に走らせる人を知っている。挑戦してみて。 Cal

Escape は最高の友達

Claude が作業している間、常に見ていて、違うと思った瞬間 Escape で止める——これは使いこなしの肝だ。いつ止めるべきか、いつ任せるべきかの嗅覚が、生産性を決める。

ツール拡張と MCP

Bash と標準ツールだけでは届かない領域に行きたくなったら、MCP サーバーを検討するタイミング。社内データベース、ナレッジベース、専用 SaaS——自社固有の知識源を Claude に繋ぐ手段として有効。

ヘッドレス自動化

Anthropic がいま最も興奮している領域であり、同時にまだ手探りしている領域でもある。プログラムから Claude をどう使うか？

• GitHub Actions に Claude Code を組み込む
• CI/CD パイプラインから呼び出す
• テスト実行後の自動修正、ログ解析、レビュー補助…

「みなさんにも、この方向を一緒に探してほしい」——Cal

Claude Code は出荷速度が異常に速い。Cal 氏自身が「自分でもついていけない」と笑う。プレゼン当日時点で新しかったものを一部紹介する。

モデル切り替え：/model と /config

起動後に /model を打つと、現在どのモデルで動いているかわかる。デフォルト（Sonnet）から Opus へ切り替えることも、/config からも同じ操作ができる。用途に合ったモデルを選び直せる。

> /model
  現在のモデル: Claude Sonnet (default)
  ↓ を押して切り替え
  → Claude Opus
    Claude Sonnet

ツール呼び出しの「あいだ」で考える

以前から think hard や拡張思考（Extended Thinking）はあったが、過去のモデルではツール呼び出しの間では思考させていなかった——本当に考えたい瞬間は、まさにそこなのに、だ。

Claude 4 からは、ツール呼び出しの間でも思考する。画面では薄いグレーのテキストで思考が流れ、ファイルを読んでまた考え、次の行動を決める。バグ解決や複雑なタスクでは think hard を一言添えるといい。

VS Code / JetBrains 統合の強化

エディタとの統合が新しくなり、Claude はいま開いているファイルが何かを自動で認識する。「この file を〜して」と曖昧な指示でも、コンテキストを拾ってくれる。

追いつき方

GitHub の anthropic/claude-code を見ると、Issue 報告も、チェンジログも公開されている。Cal 氏も週に一度はここを眺めて、新機能を把握するようにしているそうだ。

今日から使える実践リスト。チェックできるたびに Claude Code との相性がひとつ良くなる。