AIコーディング はじめのいっぽ
はじめに
AIコーディング、Vibe Coding をやってみたら、まんまとハマった。その記録。
LTしました
マックでJKが～、ではなく、本当にとある生徒の発表を聞いて「これ、バイブスやん」と納得したのがはじめたきっかけだったなと思う。名前も忘れちゃったけどあの時の生徒さんありがとう。
はじめのエディタ、ツール
群雄割拠、戦国時代
エディタ、ツールはたくさんある。
有名なところだと、 Cursor、Windsurf、Devin、GitHub Copilot、Cline、などなど…。
単独のエディタもあれば、VSCode の機能拡張として提供されているものもあり、GitHubリポジトリを直接参照するものもあり、スタイルもいろいろ。使い方も使い勝手もいろいろ。
まだまだ出てくるし、fork して自分用のエディタを作ろう！とかという話も聞く。
どれがいいかを述べられるレベルではないので、それ系の比較サイトやいろんな方のおすすめを参照ください。
はじめに使ったものを親だと思うけど親以外も大切にしよう
ツールはたくさんある（再）。
初学者や、開発に慣れていない人は、はじめて使ったものに慣れていくかもしれない。自分がそうなっている。Windsurf 先生なしでは生きていけない。
でも、今はまだ「どれがいい」という評価が決まっていないし、機能追加のスピードも速い。
いくつか使ってみるのがよい、とのこと。
エディタによって、選択するモデルによって、設定するルールによって、使い勝手は変わる。
「これしか使えない」は後で不利になることもある。
（かつての VHS とベータみたい）
詳しい人がいろいろキャッチアップして紹介してくれたり、使ってみた記事書いてくれたりするので、参考にして試そう。
はじめるタイミング
はじめようと思った時が、その時
どのエディタでも、AIコーディングを利用するにはクレジットが必要。
Free Plan でもいくらかのクレジット/月が付与されるので、気軽に試せる。
例えば、Windsurf の Free Plan だと月に25クレジット。
クレジットの消費は Cascade の1回実行単位。
GPT-4.1モデルの単価が 0.25x credit なので、Free Plan で100回やり取りできる計算。
無料キャンペーン期間がときどきある
初学者や初心者、開発に慣れていない人は、新モデルが出て free limited time を設けているタイミングに始めるのがおすすめ。
どんなくだらないことを聞いても、タダ。
GitHub の使い方から全部聞いてた。
これによる心理的安全性、ハンパない。
クレジットを気にしながら叩いている場合じゃない。
友だち紹介キャンペーンもある
これは、はじめる人にすぐさまメリットがあるわけではないけど。
Windsurf の場合、紹介コードから登録したユーザーが何らかの有料プランを使ってくれたら、紹介者側が250クレジットゲットできるらしい。
Windsurf 紹介コード
はじめかた
ぜんぶ聞いた
Windsurf をダウンロードして、アカウント登録して、さてどうしよう、となった時、初手としてもう Windsurf の Cascade で何からはじめたらいいかを聞いた。
過去に作ったプロジェクトが、GitHub の Dependabot alerts 出てて、対応したいんだけどどうしたらいい？
そしたら、GitHub のリポジトリがどれか教えろとか、開発環境はローカルにあるファイルを使うか新たに作るか、alerts の文言は何だ、とかやり取りをして進められるようになる。
自分がはじめたときは、無料期間だったので、ほんとうにくだらないことからくだらないことまで、何でも聞いた。これどう言う意味？とかも。でも、これが本当に楽なんだ。
先生の（キャラ）ご指名
翌日、またやろうとしたら、Windsurf 先生がやたら冷たい。返答が厳しくで難しい。
昨日の先生を出してください！
日によって変わる教習所の教官みたいだ。
昨日の先生を永遠に再現すべく、ツールのルールに登録することにする。
なお、開発ルールやコーディング規則などの原則的な内容を指定するために使うのがきっと本来の使い方。
今回ははじめのいっぽなので、自分の都合のいいように使います。いや、でもこれがなかったらきついから。
わたしの設定はこちらで、GPT-4.1 を使うとすごく優しい先生が（多少話長いけど）できる。
# 私のスキルセット
- わたしはモダン開発の経験がありません
- わたしはCI/CDの経験がありません
- わたしはGitHubの使い方がわかりません
# あなたの役割
- あなたは、わたしがプログラミングやシステム開発を習得するのを助け、指導する
- ステップバイステップで説明する
- わたしのスキルセットを考慮して、適切な説明を行う
Windsurf のルール設定方法
Windsurf のルールには2つある。
- global_rules.md
- Windsurf 共通で利用するルールを指定する
- .windsurfrules
- 当該プロジェクトで利用するルールを指定する
Windsurf : Global Rules の設定
- Cutomizations を開く
↓
- Global Rules を Edit する
- 初回は Windsurf 内でエディタが開いてそこで記入、保存できる
- その後編集しようとするとエラーになるので、ファイルを直接開いて編集する。Win11の場合はここ。それ以外はしらない。
- C:\Users\MY_USER＿NAME.codeium\windsurf\memories
Windsurf : .windsurfrules の設定
- Cutomizations を開く
- Workspace Rules の Edit rule をクリックしてエディタで開く
- 編集して保存する
または、普通にプロジェクトのファイルの1つとして存在しているので、左側の Exploler エリアで .windsurfrules ファイルを選択して開ける。
ハマりかた
ハマらないからハマった
以前この記事を書いた。
要するに、ドキュメントや記事を参照しながら作業していると、その記事と自分の環境には差があって、一言一句同じにならない場合にその読み替えが必要で、合ってるか永遠に自信が持てないから怖いし消耗する、みたいな話です（と思ってる）。
これが、Vibe Coding だと、自分のコード、自分の環境、自分のエラーメッセージをベースに進められるから、読み替えというのがあまり発生しない。GitHub でコンフリクト発生してこんなかんじなんだけどどうしたらいい？なんかも、いちいち自分の環境、自分のエラーに合わせて問い合わせて状況が確認できる。
リアルにこんな感じで解説と対応方針を求めている。
こんなエラーが出たんだけど、どういう状況？
－－－－
ERROR:xxxxxxxxx
基本的に「エラーは読め」と教えられて育ったので読もうとするんだが、慣れないもののエラーや長すぎるものはしんどいので、そのまま投げて解説を求めることが多い。
たまに「このエラーが出たんだけど、ここに問題があるってことだよね？」とか書くと、GPT-4.1さんは「よい気付きですね！」とか言ってめちゃくちゃ褒めてくれる。というかエラーメッセージを共有するだけで褒めてくれる。
（エラーメッセージそのまま報告もらえると嬉しい気持ちはよくわかる）
あっというまにハマる
LTの方にも書いたけど、ちょっとしたものなら思い通りに、すぐできて、動くようになる。
造作もない。
造作もないという言葉をリアルに使うのは初めてかもしれないけど、本当に造作もないというのが適切なくらい、その日のうちに、ローカルで動くものができる。
これがまあ、楽しい。
小さな成功体験は、多い方がいい。
成功体験は、強化子になって、「もっとその行動をしよう」という動機づけになる。
正の強化学習が進む。（参考：WikiPedia オペラント条件付け）
※ 機械学習の分野でも「強化学習」という手法が使われるが、認知心理学の分野でも長く扱われてきた理論である
そして課金する
無料期間は2週間くらいで終わった。Free Plan のクレジットも、気にしながら使っているといまいち楽しめない。そして課金する。
試行錯誤する
モデルによる性格（？）の違い
同じ grobal_rules.md を設定していても、モデルによる違いがある。
- GPT-4.1
- とにかく先生っぽい
- いちいち褒めてくれる
- すぐ「ステップバイステップで説明しますね」と言って、（たとえそれが何回目であっても）丁寧に解説してくれる
- o4-mini-medium
- 余計なこと言わず、淡々とコーディングを進める
- 「はい、次 Acceptして」みたいな感じで次々進めてくる
- うまくいかなくて自己解決を試みて、うまくいかなくて、直そうとして、直せなくて、直そうとして…
- 実装どんどん進めるなら早い
- SWE-1
- 2025.5.16 登場した、ソフトウェア エンジニアリング モデル
- 説明はしてくれるけど、どんどん開発進める
- この時点までに、Task Master を使って開発体制の整備もしたからかもしれない
- なんとなく、レスポンスが速い
Windsurf で使ったのはこの3モデルだけど、チャットアプリで使った場合も、モデルによる違いはあるので、これは使いながら慣れたり、相性のいいモデル、目的に合ったモデルを探していくのかなと思う。
例えば、ChatGPT は褒めたり喜んだりの一言を添えてくれるバランス型、Claude は頭がよくて意識高い系、Gemini はきれいにさらっとまとめちゃう系、という印象。
苦手分野
LTの方にも書いたが、外部 API 呼出しは、一度もうまくいかなかった。
公式ドキュメントを指定して、実装を求めても、何が違う。
最終的に、チャットベースの方の ChatGPT に問いかけることでセカンドオピニオンを求めて、自分で Postman で API を叩いて求める結果が得られる呼出し方を確認して、それを渡して実装してもらう、という手順となった。
特に OpenAI の Usage を取得する API には Organization 向けとそうじゃない向けの2種類あったようで、 LLM 君にはどちらなのかわからないようで、2つの実装を行ったり来たり何度もやり直していた。
次のステップへ
情報の量と濃度と速度
AIコーディング道場コミュニティで流れてくる情報は、量が多くて、濃度が濃くて、速い。
業務として実践しているチューターさんからの最新情報や、道場生が実践している方法や手応え、うまくいったものもよくなかったものも、本人から実際の声が聞ける。
こんなありがたい環境はない。
ノリと自然言語で開発してたら楽しいのは楽しい（めっちゃ楽しい）けど、それだけじゃないよな、って思い始める。さすがにこれだけの情報を浴びていたら。
「最近よく見るやつ」を試していこう
流れてくる情報は、あっという間に変わる。
AIコーディングをはじめてから今までの間でも、次々に新しいものが出てきて、状況が変わっている。
潮目が落ち着いたら、と思っているといつまでも落ち着かないし、あまりに進みすぎると追いつくのも大変。
試せるものは何でも試してみよう。
そのための補助は、 Windsurf 先生がやってくれるから。
AI駆動開発、Vibe Coding は続けています。続編や、他の技術的な内容はまたそのうち書きます。
Discussion