LAB 000 — はじめに読む
— AI に書かせる2つのやり方 —
プログラミングを一度もやったことがない人向けの記事です。 手を動かす手順は出てきません。代わりに、この先の記事を読むときに ずっと効いてくる1つの見方だけをお渡しします。 ——コーディングの実体は「書くこと」ではなく「回すこと」だ、という見方です。
読むだけ
作業なし
約15分
読了の目安
前提なし
用語から説明
0円
この記事の範囲
※ この記事を読み終えたら LAB 001 から実際に手を動かします。
01 — WHAT
人に何かを頼むときは「写真を小さくしておいて」で通じます。 察してくれるからです。機械は察しません。 どのフォルダの、どのファイルを、どれくらい小さくして、どこに置くのか—— 抜けがあると止まります。
その抜けのない頼み方を書いたものがコードで、 書く行為がコーディングです。 コードは、人にも機械にも読める中間の言葉だと思ってください。
※ 真ん中のコードは実物の雰囲気です。読めなくて構いません。「英語と記号が並んでいるな」で十分です。
02 — CORE
ここがこの記事でいちばん伝えたいところです。 多くの人は、コーディングを「正しいコードを書いたら完成する作業」だと想像します。 実際は違います。
書いたものはまず動きません。動かして、エラーを読んで、直して、また動かす。 この往復が本体で、「書く」は全体のごく一部です。 経験者ほど、この往復を速く回すことに労力を使っています。
エラーは失敗ではありません。 初めての人がいちばん折れるのがここです。赤い文字が出ると「自分には向いていない」と思ってしまいますが、 エラーは機械からの返事で、何が足りないかを教えてくれています。 経験者の画面にも、同じくらい赤い文字が出ています。違うのは読んで次へ進む速さだけです。
03 — LANGUAGE
言葉は何十種類もありますが、この先の記事では Python(パイソン) を使います。 理由は3つだけです。
記号が少なく、英語の文に近い形です。書けなくても何をしているかは推測できます。AI に書かせるとき、これは大きな差になります。
Mac には最初から入っています。何かを買ったり、大きなものを入れたりしなくても、今日から動かせます。
世の中に例が最も多い言葉なので、AI の当たり外れが小さくなります。珍しい言葉ほど、AI は自信満々に間違えます。
「読める」がどれくらいかというと、この程度です。行の右の説明を隠しても、だいたい想像がつくはずです。
import os
from PIL import Image
for name in os.listdir("写真"): 写真フォルダの中を1つずつ
img = Image.open("写真/" + name) 開いて
small = img.resize((img.width // 2, img.height // 2)) 半分の大きさにして
small.save("小さい版/" + name) 別のフォルダに保存する
for(〜のあいだ繰り返す)、open(開く)、
save(保存する)。読めた部分だけで、もう十分です。
全部を理解してから始める必要はありません。
04 — TWO WAYS
「AI にコードを書かせる」と一口に言いますが、中身はまったく別物の2つに分かれます。 違いは、さっきのループ——書く・動かす・読む・直す——のうち、 AI がどこまで担当するかです。
これは「どの会社の AI か」の違いではありません。 Gemini にも ChatGPT にも Claude にもチャットの入り口があり、 同じ会社がエージェントの入り口も出しています(Claude Code、Codex など)。 製品名で覚えると、名前が変わった瞬間に通用しなくなります。 「やり方の違い」で覚えてください。
ブラウザの AI に頼むと、コードの文字列が返ってきます。 返ってくるのはそこまでです。そこから先——ファイルに貼る、保存する、動かす、 エラーを読む、それをまた AI に伝える——は、全部あなたの手作業です。
エージェントとは、AI があなたの Mac を直接さわれる形のことです。 ファイルを読み書きし、実行し、エラーを自分で読んで、自分で直します。 ループがAI の中で閉じます。
いろいろ違いますが、突き詰めるとたった1つです。 ——AI が、自分の書いたコードが動いたかどうかを知っているか。 チャットの AI は知りません。動かしていないからです。
05 — EXAMPLE
お題は「フォルダの中の写真を、まとめて半分の大きさにする」。 よくある雑用です。手でやると1枚30秒、100枚なら1時間近くかかります。
やり方①
ModuleNotFoundError と出る。意味が分からない往復 3回/コピー&ペースト 6回以上。 ただし全部が目の前で起きるので、何が起きたかは分かる。
やり方②
往復 0回/押したのは許可ボタン1回。 ただし途中で何が起きたかは、読まないと分からない。
速い方が偉い、という話ではありません。 ①は遅いですが、エラーの意味を1つずつ自分で見ているので、次に同じ壁に当たったとき分かります。 ②は速いですが、分からないまま動くものが手に入るということでもあります。 これは後で効いてきます(留意点)。
06 — CHOOSE
結論から言うと両方使います。ただし、始める順番はあります。 いきなりエージェントから入ると、何が起きているか分からないまま 自分の Mac を触られることになって、落ち着きません。
| こういうとき | チャットで書かせる | エージェントに任せる |
|---|---|---|
| まず触ってみたい | ◎ 無料・すぐ・壊れない | △ 導入と契約が要る |
| 意味を知りたい・勉強したい | ◎ 1つずつ目で見られる | △ 速すぎて置いていかれる |
| 数十行の小さな道具を作る | ○ 往復は数回で済む | ◎ 頼んで待つだけ |
| 複数のファイルにまたがる直し | ✕ 運ぶ量が現実的でない | ◎ 得意な領域 |
| 作ったものを育て続ける | ✕ 版の管理が破綻する | ◎ 記録もさせられる |
| 仕事の機密が絡む | △ 貼る前によく考える | △ 読ませる範囲を決める |
07 — CARE
どちらのやり方でも共通して踏む石があります。知っていれば避けられるものだけ挙げます。
いちばん大事です。エラーが出ないことと、思ったとおりに動いていることは別です。 エラーは親切な失敗で、機械が教えてくれます。怖いのは黙って間違っている方です。
「たぶん違います」とは言ってくれません。存在しない命令や 数年前の古い書き方を、堂々と出してきます。 チャット型は動かしていないので、特にそうなります。 断定的な口調は、正しさの証拠ではありません。
コピー&ペーストを往復していると、なんとか2.py
なんとか_最新.py が量産され、どれが動く版か見失います。
これは意志では解決しません。仕組みで解きます(→ LAB 002)。
自分の Mac を触れるということは、消すこともできるということです。 許可を聞く画面が出ますが、慣れると読まずに押すようになります。 増やす作業は流してよく、消す・置き換える作業だけは読む—— この線引きだけ決めておけば十分です。
エラーを丸ごとコピーするとき、パスワードやメールアドレスが混ざっていないかを一度見てください。 仕事の資料をそのまま貼るのも同じです。送ってしまったものは取り消せません。
チャットは無料の枠で始められます。 エージェントは有料の契約が前提です。 だからこそ「まず無料で触って、続きそうなら払う」という順番が理にかなっています。
エージェント特有の落とし穴です。完成はしますが、中身を1行も読んでいない状態になりがちです。 壊れたときに手が出せません。対策は簡単で、 ときどき「いま何をしたのか、素人向けに説明して」と聞くだけです。
FAQ
小さな道具なら作れます。ただし「読める」ようにはなっておいた方がいいです。全部書けるようになる必要はありません。AI が出したものを見て「だいたい何をしているか」が分かる程度で、事故がかなり減ります。
チャットで書かせるだけなら、貼って動かすまでは何も起きません。エージェントも、こちらが許可しない操作はしません。心配なら練習用のフォルダを1つ作って、その中だけで試すのが確実です。
この記事の趣旨からすると、その問いはあまり効きません。どちらの会社にもチャットとエージェントの両方があります。先に決めるべきは会社ではなくやり方で、会社は使いながら好きな方に寄せれば十分です。
頼むのは日本語で構いません。エラーは英語で出ますが、そのまま AI に貼って「これは何?」と聞けば日本語で返ってきます。訳す作業は要りません。
見せられます。ただし合言葉や個人の情報が混ざっていないかだけは、出す前に確かめてください。そのための仕組みは LAB 002 で作ります。
NEXT
まずお金のかからない側から試してみてください。 手元の AI のチャット画面に、こう打つだけです。
Mac で使える、ごく短い Python を1つ書いてください。
プログラミングは初めてです。
どこに貼って、どうやって動かすかも、順番に教えてください。
一度でも自分の Mac で何かが動いたら、この記事の役目は終わりです。 そこから先——往復が面倒になってきたら——エージェントの出番です。
この先の順番
※ 製品の名前・料金・できることは変わります。この記事で覚えてほしいのは製品名ではなく、 ループを誰が回すかという見方の方です。そちらは当分変わりません。