Claude Codeで作業していると、ところどころで「これしていい？」と許可を求められる。ファイル編集の許可、コマンド実行の許可、外部への送信の許可——どれも対象とやることを確認してから判断する。「許可するとファイルが消える」というケースは確かに存在するので、慣れないうちは1回ずつ見るのが安全。

混乱しやすいのがrunの種類。「runを許可しますか？」という文言は同じでも、実行する内容は全然違う。npm installなどのコマンドをターミナルで走らせる「Bash実行」と、ファイルをコピー・移動する「ファイル操作」の2種類がある。見た目が同じだから並列に思えるが、中身は別物。ダイアログに表示される操作内容の文章をちゃんと読んで判断するのが正解。

さらに進んだ設定としてバイパス許可がある。確認ダイアログをすべて自動でOKにして、Claudeが止まらずに作業を進める設定。「編集を承認」ボタンが毎回表示されるのは、バイパスが許可されていない状態だ。使いこなした人はバイパスを許可して自動化するが、慣れないうちは1つずつ確認しながら進む方が安全。

そして大事なこと。AIができないことがある。クレカの入力、本人確認、利用規約への同意——お金やアイデンティティが絡むものは本人が手を動かす場面。Claude Codeが「ここはあなたが入力してください」と止まったら、それはサボっているのではなく安全のための線引きだ。

時に「evalを実行してよいですか」という許可が出ることもある。evalは「文字として渡されたプログラムを、その場で動かしてしまう」ちょっと特別な命令。便利だが、悪意ある文字も実行してしまう危険があるので、AIが必ず止まって聞いてくる場面だ。何を動かそうとしているのか中身を見てから判断する。

AIを使って開発する時に目にする設定ファイルがある。CLAUDE.md（Claude Code用）やAGENTS.md（OpenAI Codex用）は、「このプロジェクトでAIに守ってほしいルール」を書いておくファイル。AIが最初に読む説明書で、毎回説明しなくても文脈を共有できる。対応するAIが違うだけで、役割はどちらも同じだ。

VS Codeは、Claude Codeから「VS Codeで確認してください」と言われた時に開くソフト。左側にフォルダ一覧、右側にコードが表示され、エラーのある行に色がついて知らせてくれる。エラーが起きた時、Claude Codeが「デバッグを開始してください」と言う場面がある——その時はVS Codeの緑の▶ボタンを押すだけでいい。アプリが「調査モード」で動いて、エラーの場所でひとりでに止まる。この▶ボタンの動きを事前に設定しているのがlaunch.jsonで、Claude Codeが自動で作ってくれるファイルだ。自分で書く必要はほとんどない。

作業の途中でAIが「ハードコードをやめます」と言う場面がある。ハードコードとは、変わる可能性がある値をコードの中に直接書き込んでしまうこと。後から変えたい時に、コードの中を探して何か所も直す手間が生まれる。AIがこれを整理する時は、直書きしていた値を変数や設定ファイルに移して「一か所変えれば全体に反映される」状態にしている。コードをこのように整理・改善する作業をリファクタリングと呼ぶ。

アプリが完成したらデプロイで世界に公開する。その前にある「ビルド」という処理を理解しておくと流れが見えてくる。開発中に触るファイルはすべてsrc フォルダ（source＝源）にある。このsrcの中身をビルド（変換・最適化処理）すると、ブラウザが直接動かせる形に変わってdist フォルダに出力される——「srcを編集する → ビルド → distに完成品が入る」という流れだ。Cloudflare Pages でドラッグして公開する時はこのdistを渡す。distは直接触ってはいけない——次のビルドで上書きされて変更が消えるから、編集は必ずsrcで行う。デプロイコマンドを使う場合は「copy application to public directory」というpublic ディレクトリへのコピー操作が自動で実行される。

コードで図形を描く技術としてSVGがある。JPGやPNGのような画像ファイルではなく、「この位置にこの大きさの円を描く」というコードで図形を表す。拡大しても数学的に再計算するから、どんなサイズでも鮮明なまま。Claude Codeが「純SVGで描画する」という時は、画像ファイルを一切使わずコードだけで図形を作っている。

Claude Codeとの作業を整理すると、こうなる。許可を求められたらrunの種類を読んで判断する。バイパスは慣れてから。AIにはできないこともある。evalは必ず止まって確認。CLAUDE.mdにルールを書いておけばAIが最初に読んでくれる。VS Codeで確認し、デバッグで原因を探り、launch.jsonで起動方法を定義する。完成したらdistに入れてデプロイ。

Claude Codeの設定と作業