LAB — AI AGENT BASICS
2026年7月から、AI があなたの Mac を直接操作して作業する「AI エージェント」（Claude Code）を使い、 エージェント型コーディングで道具を作っています。このシリーズは、その導入から先に組み立てた仕組みの記録です。AI エージェントを知らない人でも読めるように、 1本15分ほどで書いています。
それより前、チャットの AI（Gemini）と対話しながら道具を作っていた頃（対話型コーディング）の知見は はじめての道具箱 にあります。
ARTICLES
プログラミングを一度もやったことがない人向け。手を動かす手順は出てきません。 コーディングの実体は「書くこと」ではなく「回すこと」だという見方と、 コードは指示書、エラーは返事。対話型コーディング／エージェント型コーディングを上から順に、写真の例と注意点まで図6枚で。
Claude Code を、ターミナルではなくデスクトップアプリの「Code」から始めます。やることは、作業用のフォルダを決める・ 許可の表示で場所を確かめる・CLAUDE.md に決まりを書く、の3つ。4つの STEP それぞれに確認欄を付けています。
手順を読む →AI に書かせた作業の記録が、自分のノートに勝手に溜まっていく仕組みを作ります。 AI との会話は消えても、Obsidian のノートは残ります。前編は part 1〜4 の一本道で、ノート用フォルダを作り、AI に書き足してもらい、 コードのフォルダから指定するところまで。フォルダの場所は Finder からドラッグ＆ドロップで渡せます。
MCP（AI に外部の道具を使わせる共通の接続方式）で Obsidian らしい操作（タグで探す・今日の日誌を開く）をできるようにし、CLAUDE.md で頼まなくても記録を書く状態にします。つまずき集・やめ方も後編に。
手順を読む →AI に書かせたコードは、壊れたとき記憶では戻せません。自分で書いていないからです。 GitHub はまだ使わず、Mac 1台の中だけで「戻れる状態」を作ります。 コピーしてはいけないものを最初のコミットより先に決めるところまで、図9枚で順番に。
記録（コミット＝変更履歴として残す操作）を AI に任せる頼み方と、壊れたときに実際に戻す手順。合言葉をうっかりコピーしてしまっていたときの片付け方も。
手順を読む →MacBook を買った理由はカフェで作業したかったから。店の Wi-Fi につないだ瞬間に気づきました——この電波、誰が聞いているんだろう。 怖がる順番を直すところから始めて、公衆Wi-Fi・覗き見・持ち出す機械・家の Mac への経路まで。 やらなくていいことも理由つきで。図7枚。
コードは GitHub（コードの置き場所のサービス）、ノートは iCloud（Apple のクラウド保存）、画面は Tailscale（自分の機器どうしだけをつなぐ仕組み）。ではAI との会話はどこを通るのか。 電車の中でコードは書けるのか——結論は「書けない。でも頼める」。 iPhone を書く端末ではなく頼む端末として使う話です。図7枚。
土台が揃ったら、次は何かを作るだけです。最大の壁は技術ではなく「何を作るか」。 答えは自分が毎日困っていること、1つだけ。 見つけ方・頼み方、そして育てない勇気の話です。図5枚。
AI の「できました」は報告であって、確かめた結果ではありません。合否を言葉ではなく終了コード（0 か、それ以外か）で決める小さなテストの作り方と、 AI にテストを甘くさせない頼み方、テスト自体を疑う方法をまとめました。5つの STEP それぞれに確認欄を付けています。
道具が増えると、作ることより「どれがどこにあるか」を探すほうが大変になります。道具の情報を1か所の台帳に集め、画面をそこから作る方法と、 分類に入れ忘れても消えない「未分類」の受け皿、押すと中身が変わるボタンの守り方、台帳の抜けを機械に見張らせる方法をまとめました。5つの STEP それぞれに確認欄を付けています。
「触らないで」と文章で頼むだけでは、守られたかを誰も確かめていません。設定の禁止リスト・実行直前の検査（フック）・サンドボックス（箱の中だけで動かす仕組み）の3層で、 止める場所を分けて壁を作り、ダミーのファイルで本当に止まるかを確かめる方法をまとめました。5つの STEP それぞれに確認欄を付けています。
数え漏れを受け止めるサンドボックスを足し、3枚の壁にダミーを当てて止まるのを確かめ、設定を原本から2台目へ配ります。
手順を読む →人がいないと、確認は自動で拒否になり、終わったかも誰も見ません。任せる仕事の選び方・無人で使うモードの決め方・時間切れと合否の検査つきの実行スクリプト・夜の予約（cron）と朝のレビューを、 ダミーの仕事で試しながら組み立てます。5つの STEP それぞれに確認欄を付けています。
時間切れと合否の検査つきの実行スクリプトを作り、cron で夜に予約。朝は結果だけを確かめます。
手順を読む →夜に回り始めると、次に困るのは「本当に回っているのか」が分からないことです。「回っている」を段階に分け、テストの有無・実行ログ・予約・最後に動いた日といった残った跡から、 いま何段目まで届いているかを数える小さな測定スクリプトを作ります。装置があるだけでは稼働と呼ばない、という数え方も試します。3つの STEP それぞれに確認欄を付けています。
わざと止めて判定が下がるのを見て、測定が効いていることを確かめ、結果の読み方と朝のレビューへの組み込みを決めます。
手順を読む →