AI生成記事についての注意
この記事は70%以上AIによって生成されています。内容の正確性については十分注意していますが、誤りがある可能性があります。実際にコードを実行する際は、必ず内容を確認の上、自己責任でお願いします。
はじめに
Claude Codeが気になっていたところ、元Uber/GoogleエンジニアのWaleed Kadous氏が20時間使い込んで得たTipsをまとめた記事を見つけました。かなり参考になったので、記事の要点と自分の使用感をまとめておきます。
参考記事：Claude Code Top Tips: Lessons from the First 20 Hours
URL：https://waleedk.medium.com/claude-code-top-tips-lessons-from-the-first-20-hours-246032b943b4
著者：Waleed Kadous（CVKey共同創業者、元Uber CTO室、元Google）
Kadous氏の記事から学んだこと
なぜClaude Codeが「ゲームチェンジャー」なのか
Kadous氏の反応は劇的でした。CursorもWindsurfも解約したほどClaude Codeに惚れ込んでいるそうです。Python開発、3Dデザイン編集、ドキュメント作成、記事執筆まで、あらゆる場面で既存ツールを上回ったと述べています。
特に印象的だったのは、「キャリアの中で『これだ！』と感じた技術革新は4〜5回しかない」という言葉。OpenGLやJavaを初めて学んだときのような感覚を、Claude Codeで再び味わったそうです。
メンタルモデル：「高速インターン」
Kadous氏が提案する**「非常に速いインターンで完璧な記憶力を持つ」**というメンタルモデルが秀逸です。このインターンは一度教えたことは忘れず、超人的な速度で作業をこなします。ただし経験は浅いので明確な指示が必要で、成果物の確認も欠かせません。
興味深いのは、時に過度に複雑な解決策を提案するという点。これも確かにインターンっぽい特徴です。
Kadous氏の8つのTips
1. CLAUDE.mdで「学習」させる
Claude CodeはCLAUDE.mdというファイルを作成し、プロジェクト固有の背景知識として使用します。これが本当に強力です。
Kadous氏の実例が分かりやすいです。OpenSCADで円柱の縁を丸める際、上下にトーラスを配置する複雑な方法を提案してきたそうです。実はライブラリに専用のパラメータがあったので、「今後はライブラリの機能を先に確認する」ようCLAUDE.mdに記載してもらったところ、以降同じミスは起きなくなったとのこと。
2. TODOリストの常連タスクを任せる
開発者が後回しにしがちなTODOこそ、Claude Codeの得意分野です。ドキュメントの更新、網羅的なテスト作成、複雑な関数へのコメント追加など、「やらなきゃ」と思いつつ放置しているタスクを片っ端から処理してくれます。
3. 開発ライフサイクル全体で活用
コード作成だけでなく、開発プロセス全体で活用できるのが驚きでした。Kadous氏は設計ドキュメントでも活用していて、GraphVizでダイアグラムを生成し、シェルスクリプトで.dotファイルを.pngに変換して、設計ドキュメントに組み込むという一連の作業をClaude Codeに任せたそうです。
4. 権限設定は慎重に
ここでKadous氏の失敗談が参考になります。git addの自動実行を許可したところ、「git add .」で機密情報を含むファイルまでステージングしてしまったそうです。
鉄則：
- ✅ 読み取り専用コマンド（git status、ls）は自動実行OK
- ❌ 書き込みコマンド（git commit、rm）は都度確認
5. ファイルシステムを共有ワークスペースに
作業ディレクトリをClaude Codeとの共有スペースとして活用する発想が面白いです。Kadous氏は3Dモデリング時にBOSL2ライブラリのソースをディレクトリに配置したり、examples/ディレクトリに過去の文章を保存して文体を学習・再現させたりしています。
6. コストは要注意
トークン課金制で、本格的に使うと1日$10、月$200程度になる可能性があります。CursorやWindsurfの約10倍というのは確かに高いですが、Kadous氏は生産性向上を考えれば十分価値があると判断しています。/costコマンドで随時確認できるのは助かります。
7. 大規模リファクタリングには--enable-architect
文書化されていないが、「--enable-architect」オプションで大規模コードベースの扱いが向上するそうです。これは試してみる価値がありそうです。
8. 完璧を求めすぎない
インターンと同じく、時に複雑すぎる解決策を提案することがあります。もっとシンプルな方法があれば遠慮なく指摘しましょう。
私が実際に使ってみて発見したこと
Kadous氏の記事を読んで自分でも試してみました。最初は半信半疑でしたが、使い始めて数日で手放せなくなりました。
個人的に発見した「筋の良い使い方」
実際に使い込んでみて、以下のサイクルが最も効果的だと感じています。
① 要件をふわふわさせない
最初に作りたいものを明確に。曖昧だとClaude Codeも迷走します。
② 失敗したらスクラップアンドビルド
うまくいかなかったら粘らずリセット。失敗から学んで要件を見直し。
③ ①→②を高速で回す
人間だと心が折れる試行錯誤も、Claude Codeなら気軽に。
その他の実践的Tips
使っていて気づいたのは、曖昧な指示を極力避けることの重要性です。「いい感じに」ではなく、具体的にどうしたいのかを明確に伝える必要があります。
また、モデルはOpusで統一するのがおすすめです。品質と一貫性が保たれます。そしてmemories.md（おそらくCLAUDE.mdのこと）を定期的に更新してあげると、プロジェクトが進むにつれてClaude Codeがどんどん賢くなっていきます。冗長にならない程度に、というのがポイントです。
本音
正直なところ、本質は今までのツールと変わらないんです。でも、レベルの高い合格点をオールウェイズ出してくれる。これがゲームチェンジャーすぎる。
今までのAIツールは当たり外れがありました。「今回はうまくいくかな？」という不安が常にあった。でもClaude Codeは外れが少ない。この安心感が、思い切った試行錯誤を可能にしてくれます。
まとめ
Kadous氏の「学習曲線を登る価値がある。その先には、1日で達成できることの真の拡張がある」という言葉には深く同意します。
まだ使いこなせてない機能も多いですが、開発体験は確実に変わりました。Kadous氏ほどではないけど、私も「もう戻れない」感覚を味わっています。
Claude Codeは単なる便利ツールではなく、開発の在り方を変える可能性を秘めています。興味がある人はぜひ試してみてください。最初の数時間は戸惑うかもしれませんが、その先には新しい開発体験が待っています。
個人の経験と見解です。効果は使い方次第。