Claude Code開発者が絶対に破らない1つのルール

AnthropicでClaude Codeを実際に開発したBorisが、なぜ多くの人々から使い方を尋ねられるのかを紹介しています。彼が「シンプル」と言うセットアップも、実際には他の人にとっては壮大なシステムである可能性があることが指摘されています。この動画では、技術的に古いものもあるが新鮮な視点を与えてくれる多くのポイントが紹介されることが予告されています。視聴者は、開発者本人から直接学べる貴重な機会であることが強調されています。

人々がClaude Codeで抱く最大の誤解は、タスクを与えて小さなエラーが出ると諦めてしまうことです。Borisは、人間も同様の働き方をするため、常にClaudeに作業を検証する方法を与えるべきだと教えています。例えば、Pythonコードを書く場合はテストも使用するように指示すべきで、これによりClaudeはフィードバックループを得て最終結果の品質が即座に向上します。自律的に動作させたい場合は、Claude.mdファイルを編集して「作業を行う前にその検証方法を述べるように」指示することで、常にフィードバックループを得られます。検証方法はドメインによって異なり、bashコマンド実行からClaudeのブラウザ拡張機能を使ったUI検証まで様々です。

Claudeのブラウザ拡張機能を使えば、サイト全体をナビゲートしてすべてを検証できることが説明されています。モバイルアプリの検証には、iOSおよびAndroidシミュレーターMCPが利用可能です。MCPがトークンを大量に消費する懸念がある場合は、検証主導の手法、特にテスト駆動開発(TDD)を使用できます。TDDでは、新機能のテストを最初に書いてから実際の実装を行い、そのプロセスでスクリーンショットを使用してUIを検証することも可能です。これらの手法により、トークン消費を抑えながら品質を担保できます。

Borisは、Claude.mdファイルがいかに重要で各リポジトリに固有のものであるべきかを強調しています。このファイルには、新しく作成されたClaudeセッションがプロジェクトについて持つべき基本情報をすべて含めるべきです。具体的には、技術スタック、基本的なプロジェクト構造、チームが従うコードスタイルと規約、そして最も重要な「やってはいけないこと」を記載します。Borisはチーム全体に週に複数回Claude.mdに貢献するよう習慣づけており、何か間違ったことを見るたびにそこに追加しています。フルスタックアプリでは、各マイクロサービスが独自のClaude.mdを持つ構造が推奨されており、彼自身のClaude.mdは約2.5Kトークンに抑えられています。

Claude Codeには、計画のためのプランモード、すべてのファイル編集を自動承認する自動承認モード、そしてClaudeがすべてを実行できる危険な権限スキップモードがあります。しかし、Borisは危険な権限スキップモードを使用していないと明言しています。特に本番環境では、1つのターミナルコマンドでプロジェクト全体を台無しにする可能性があるためです。代わりに、Claude Codeの権限機能を使用して、許可されるコマンド、実行前に確認すべきコマンド、完全に拒否されるコマンドを設定しています。これらの設定は.Claudeフォルダ内のsettings.jsonファイルに保存され、チームメンバーと共有できます。

Claude Codeは名前に反してコードのためだけに使用されるものではなく、完全なワークフローオーケストレーションシステムとして機能します。人々はAnetianワークフロー生成、SEOパイプライン設定、ビジネス市場分析など様々な用途で使用しています。Borisは、MCPサーバーを使用してSlackをClaude Code内で使用し、BigQuery、Sentryなどの多数のツールをCLIを通じて操作しています。動画制作者自身も、NotionとClaude CodeをMCP経由で接続し、データベースの作成、入力、すべての動画アイデアのコンテキスト理解などに活用しています。これにより、Claude Codeが様々なツールを統合する中心的な役割を果たすことが示されています。

Borisの実際のワークフローでは、機能やタスクの実装を開始する前に、まずプランモードに切り替えて望むことを明確に説明します。良い計画を持つことが非常に重要で、エージェントとの必要なやり取りはすべてプランモード中に行われます。計画が実際に有効であることを確認してからのみ、エージェントを危険な権限スキップモードではなく自動承認編集モードで起動します。規模での使用に関しては、彼は5つのClaude Codeセッションを並行して実行しており、タブに番号を付けることで、異なるタブから通知を受け取った際にどのターミナルタブからかを識別できるようにしています。

Borisは、Claude CodeのWeb版も頻繁に使用しており、GitHubに接続してデモリポジトリへのアクセスを許可することでクラウド上で操作できます。彼はバックグラウンドエージェント機能を使用して長時間実行タスクをバックグラウンドに置いており、時には携帯電話からも使用しています。Claudeはクラウドセッションですべての作業を自動的に行い、完了すると新しいブランチを作成してすべてのコード変更をプッシュし、レビューできるようにします。テレポートコマンドを使えば、クラウドセッションをローカルターミナルに戻して自分で表示・作業することも可能です。これはAIエージェントをジュニア開発者として扱う真の定義と言えます。

Borisは、すべてに対してthinkingを有効にしたOpus 4.5をほぼ使用していると述べています。Opus 4.5はより大きく遅いモデルで、SonnetよりもHaikuモデルよりもかなり時間がかかります。しかし、エラーを起こす可能性がはるかに低いという大きな利点があります。その結果、モデルと作業して操縦するのに費やす全体的な時間は、実際にはOpus 4.5の方がはるかに少なくなります。つまり、一見遅く見えるモデルでも、エラー修正の時間を削減することで、トータルの生産性が向上するというパラドックスが存在します。

BorisはClaude Code GitHubアクションも使用しており、これは認証されたGitHubリポジトリ内で呼び出すことができるボットです。彼の強力なユースケースは、PRレビュー中にミスを見つけたときはいつでも、単にClaudeにそれらのミスをClaude.mdファイルに追加するよう依頼することです。これにより、同じミスが繰り返されることを防ぎ、チーム全体の知識ベースが継続的に改善されます。GitHubとClaude Codeの統合により、コードレビューのプロセスが自動化され、品質管理が強化されます。

長時間実行タスクには3つの異なるアプローチがあります。1つ目は、Claude Code自体が考案した異なるテストを使用してClaudeに作業を検証させ、それらのタスクをバックグラウンドに配置する方法です。これらは静かに実行され、完了したらメインエージェントに報告します。2つ目のアプローチは、Claudeが出力を停止したときに自動的に検証をトリガーするストップフックを使用することです。3つ目のオプションは、Ralph Wiggumプラグインの基盤となっており、開発中にClaude Codeが生成しているUIが実際に正しいかどうかを検証するテスト方法を提供します。これにより、ループから人間を完全に排除できます。Borisは、さまざまな言語用のリンターやフォーマッターも使用して、書かれたコードの形式を検証しており、モデルが生成する正しいコードの残り10%をクリーンアップするのに役立つと述べています。

Borisのワークフローは驚くほど標準的で、本当に生産的になるために、Claude Codeのすべてを過度に複雑にする必要はありません。シンプルな組み込み機能だけで、達成しようとしている生産性の約90%をすでに得られます。/commandsは、1日に何度も繰り返す「インナーループ」ワークフローに使用され、.claudフォルダ内のcommandサブフォルダに保存されるためgitにコミットしてチームと共有できます。サブエージェントについて、人々は市場調査員や製品検証者など様々なユースケースのために構築していますが、Borisは完全に異なる指示を必要とするシンプルなワークフローの自動化に使用しています。具体的には、コードのアーキテクチャ検証、コードのリファクタリング、最終的なビルドが機能することの検証などに活用しています。

動画の最後では、Automataというサービスが紹介されています。何百万人もの人々にAIを使った構築方法を教えた後、彼らはこれらのワークフローを自分たち自身で実装し始め、より良い製品をこれまで以上に速く構築できることを発見しました。Automataは、素晴らしいアイデアがあるが技術チームがない人々のための技術的な副操縦士として機能し、開発チームの雇用や管理の煩わしさなしに、コンセプトを実際に機能するソリューションに変えます。興味がある場合はhello@automata.devに連絡できます。視聴者は、スーパーサンクスボタンを使用してチャンネルをサポートできることが案内されています。