TOOLBOX — 引いて使う事典
— 必要なところだけ、15分で —
コーディングにほとんど触れたことがない人のための事典です。 最初から順に読む必要はありません。 いま困っていること・気になった言葉の項目だけを開いてください。 どの項目も図が中心で、長くても15分で読み終わります。
15分
1項目の上限
図解
文章は短く
コピペ0
コードはAIが書く
ITEMS
必要な項目だけを選んで読めます。
ほかの項目にもよく出てくる言葉です。途中で分からなくなったら、ここを開いてください。
A1 ・ 目安 13分
ファイル・フォルダ・「場所(パス)」とは
AI やプログラムがファイルを指すときの「住所」。打たずに写す方法と、名前が変わると届かなくなる理由。
A2 ・ 目安 12分
CSV と JSON ――データを入れる2つの箱
表に収まるなら CSV、入れ子なら JSON。どちらも文字だけなので、太字や色は入りません。
A3 ・ 目安 13分
HTML・JavaScript・Python は何を分担しているか
画面の表側と、裏方の Python。ブラウザの中からファイルに手が届かない理由と、症状から係を当てる方法。
A4 ・ 目安 13分
localhost とポート番号 ――自分の Mac の中にある「店」
作った道具を開くときの「http://localhost:8001」は何を指しているのか。iPhone から開けない理由も。
ファイルや問題などの「中身」をどう持つか。
B1 ・ 目安 13分
ファイル名に分類を書き込むという整理法
フォルダに入れる代わりに、名前に【大】【中】【小】を書く。1つのファイルに分類をいくつも持たせられます。
B2 ・ 目安 13分
「一覧表」と「実物」を分けて持つ
何百ものファイルを、表の上で直してまとめて反映する。表と実物が食い違わないための約束も。
B3 ・ 目安 12分
データと画面を分ける
問題のような中身と、それを見せる画面を別のファイルに。直す場所が1つに決まります。
B4 ・ 目安 12分
元データには触らず、直した分を別に持つ
作り直されるデータを手で直すとき、直した分だけを別のファイルに。作り直しても消えません。
B5 ・ 目安 12分
元データに既にある決まりを利用する
AI に選ばせず、資料が書いている配点などのしるしを拾う。取れた数を数えて確かめます。
B6 ・ 目安 12分
1問1問に「名札」を付ける
番号ではなく問題の文章から作った目印で成績を結ぶ。問題文を直すと成績が消える理由も。
たくさんの中から目当てを見つける画面の作り方。
C1 ・ 目安 12分
ブラウザだけではファイルを書き換えられない理由
見るだけの画面と、直せる画面の分かれ目。名前を変えるボタンに、裏方(店)が要る理由。
C2 ・ 目安 11分
AND で絞るか OR で絞るか
0件にしない絞り込み。すべて満たすか、どれかでよいかで件数が変わる理由と、連動プルダウンの考え方。
C3 ・ 目安 10分
並べ替えの落とし穴:作成日と変更日
日付で並べる前に決めること。コピーや移動で日付が変わる理由と、日付の書き方で順番が狂う理由。
C4 ・ 目安 9分
少ない回数の正答率を信じない
「何回のうちの何回か」を一緒に見る。回数が少ない数字が当てにならない理由と、最低回数と平均で弱点を選ぶ考え方。
C5 ・ 目安 10分
操作する画面と見る画面を分ける
手元は操作、映像は別の窓へ。リモコンの指示が別の窓へ届く流れと、窓を閉じたときなどのつまずき。
取り返しのつかない失敗を、作りの段階で防ぐ。
D1 ・ 目安 8分
消すならゴミ箱へ ――取り返しのつく作りにする
「すぐに消す」と「ゴミ箱へ移す」の違い。外付けドライブでは、そのドライブの中のゴミ箱へ入れる理由。
D2 ・ 目安 8分
名前を決め打ちしない ――ドライブの名前を変えたら全部空になった
コードに名前をそのまま書くと、改名で動かなくなる理由。名前に頼らず「探して見つける」作りにする考え方。
D3 ・ 目安 8分
「読めなかった」を「0件」と扱わない ――空に見えた一覧が本物を消す
読めなかったことを空の一覧として扱うと、次の保存で本物を上書きする理由。「読めなかった」を別の結果にする作り方。
D4 ・ 目安 8分
途中で止まっても壊れない保存の仕方 ――別のファイルに書いてから差し替える
ファイルを直接上書きすると、途中で止まったときに書きかけが残る理由。一時ファイルに書き終えてから名前を差し替える作り方。
D5 ・ 目安 8分
いつもと違ったら止める「安全弁」 ――数がおかしいときは黙って先へ進まない
道具が黙って間違った結果を作る理由。材料と結果の数を見張って、書き換える前に止まる作り方。
D6 ・ 目安 8分
記録の書き出しと読み込み ――作り直しで記録を失わない
道具を作り直すと記録が空に見える理由。日時入りのファイルに書き出し、確かめてから読み込む作り方。
チャットで AI にコードを書いてもらうときのコツと落とし穴。
E1 ・ 目安 9分
「何を作るか」より「何に困っているか」を伝える ――方法ではなく、困りごとを渡す
方法だけを頼むと困りごとが残る理由。困りごとを3つの材料で伝え、AI に案を出してもらう頼み方。
E2 ・ 目安 9分
遅すぎる自動化は、場所を変える ――直すのは速さではなく、処理する場所
動くのに遅くて使えないとき、書き直しより効くことがある「処理する場所を変える」考え方と、AI への頼み方。
E3 ・ 目安 10分
1回に1つだけ頼み、動いた版を取っておく ――壊れても、原因をつかめて、戻れるように
直したら別の所が壊れる理由。頼むのを1つに絞り、動いた版を日付つきで取っておく習慣と、貼り付けで壊れる形。
E4 ・ 目安 10分
作った機能を消す判断 ――残すか消すかを決めて、壊さずに消す
機能を消すか残すかを決める3つの問いと、取っておく・書き出す・消す・確かめるの手順、消した代わりの置き方。
E5 ・ 目安 10分
自分のデータを AI に丸ごと渡さない ――要点だけにして渡す
貼る前に見る3つの問いと、手元で集計してから要点だけを渡す手順、渡せないものの置き換え方。
E6 ・ 目安 10分
チャットの AI とエージェントの違い ――動かして確かめるのは、だれか
コードを書いてもらう2つのやり方の違いと、同じ作業での比べ方、向いている場面、それぞれで気をつけること。
ここに並んでいるのは、2026年1月〜6月に Gemini のチャットでコードを書いてもらい、 動画ファイルの管理と、資格試験のクイズの道具を作ったときに分かったことです。 その道具の話そのものではなく、ほかの道具を作るときにも使える形に言い直してあります。
コードは載せていません。コードは AI が書くので、 覚えておきたいのは「何がどうなっているか」と「AI にどう伝えるか」の2つです。 どの項目も、次の6つが同じ順番で並んでいます。
この事典の前提:対話型コーディングです。 ブラウザの画面で AI に頼むとコードが返ってきて、それを自分で保存し、動かし、エラーが出たらその文字を貼り返す——という使い方です。 AI があなたの Mac を直接操作する「AI エージェント」は、E6 を除いて使いません。 2026年7月からは AI エージェント(Claude Code)を使い、エージェント型コーディングで道具を作っています。そこからの話は AIエージェントことはじめ にまとめています。
1
何か・なぜ必要か
答えと、知っておく理由。最後に概念図があります。急ぐときはここだけ読めば十分です
2
しくみの説明
図と文章で、しくみを順に説明します
3
よくあるつまずき
実際に起きた失敗を、症状から引ける表で
4
AI への伝え方
言い方の例。自分の言葉に直して使います
5
確かめ方
うまくいったかを、どこで見分けるか
6
関連する項目
次に読むとつながる項目
ALSO
チャットでの往復(貼る・動かす・貼り返す)が面倒になってきたら、AI に Mac を直接操作させる「AI エージェント」の出番です。 導入から順に進める記録は「AIエージェントことはじめ」にまとめています。
AIエージェントことはじめへ