はじめに
僕はエンジニアではありません。
株式会社コホマダという会社をやっていて、海外企業の日本市場参入と、日本企業の海外展開を支援しています。あわせて、鳥取県の海外よろずビジネスサポート駐在員という公職も務めています。
要するに、ずっと人と会って話す仕事をしてきた人間です。プログラミングは書けません。HTMLとCSSが「Webページを作るやつらしい」ということは知っている、その程度です。
そんな僕が、Claude Codeで自社サイトを作りました。
きっかけは単純で、作りたいものがあったのに、頼む相手も、頼むお金もなかったからです。
テンプレートを買って埋めるだけのサイトなら作れたと思います。でも、それでは意味がないと思っていました。うちは「海外と日本をつなぐ」ことを仕事にしていて、それが一目で伝わる何かが欲しかった。
頭の中にあったのは「3Dの地球が回っていて、国をクリックすると情報が出てくるサイト」でした。
自分で作れるわけがない、と思っていました。
結果から言うと、作れました。
そして一番おもしろかったのは、速さではありません。頭の中にあった曖昧なイメージが、そのまま吸い上げられて、形になっていくという感覚でした。
「こういう感じ」としか言えないものを投げると、それが技術に翻訳されて返ってくる。返ってきたものを見て「もう少しこう」と言うと、また翻訳される。その往復だけで進みました。
この記事では、実際に生成されたコードをそのまま載せます。僕には読めないコードですが、読める人が見れば「本当に動くものが出てきているのか」が分かると思ったからです。
作ったもの
先に、この記事で一番言いたいことを書きます。
打ち合わせ0回。要件定義書なし。ワイヤーフレームなし。見積もりも取っていません。
やったのは、チャットに日本語を打っただけです。それで3,200行が動きました。
できたのは1ページだけのサイトです。ただ中身はけっこう入っています。
| ファイル | 行数 |
|---|---|
| index.html | 290 |
| src/main.js | 1,837 |
| src/styles.css | 1,097 |
合計およそ3,200行。うち1行も自分では書いていません。
しかも中身は、テンプレートを組み合わせたものではありません。カスタムシェーダーを書いてGPUで地球を描いています。そういうものを、コードが読めない人間が自分の手元に持っていて、いまも直し続けている。ここが一番の変化でした。
構成はこれだけです。
{
"dependencies": {
"@vercel/analytics": "^2.0.1",
"three": "^0.158.0"
},
"devDependencies": {
"vite": "^5.4.0"
}
}
依存パッケージは2つだけ。「軽くしたい」と言い続けた結果でした。
指示は、こんな日本語でした
技術用語は一切使っていません。実際に打ったのはこれです。
3Dの地球が回っていて、国をクリックすると情報が出てくるサイトにしたい
昼と夜の境目が、ぼんやり滲んでほしい
スクロールするのはやめよう。基本的に1ページで
第三者が初見で見て、違和感なく、すげーってなるサイトにしたい
最後のやつなんて、指示として成立しているのかも怪しいと思います。でも、ちゃんと返ってきました。
「滲んでほしい」に返ってきたコード
一番驚いたのがこれでした。
「昼と夜の境目を滲ませて」と言ったら、シェーダーというものを書いてきました。GPUで1ピクセルずつ色を計算する仕組みらしいです。
出てきたのがこれです。
// 昼夜:やわらかいターミネータ
float ndl = dot(N, L);
float day = smoothstep(-0.16, 0.44, ndl);
float light = ambient + day * 0.98;
vec3 col = base * light;
// 夜側:深く沈める(宇宙の暗さとのコントラスト)
col = mix(col * vec3(0.52, 0.60, 0.80), col, day);
// ターミネータ(夜明け/夕暮れ)の暖色バンド
float term = smoothstep(0.0, 0.30, ndl) * (1.0 - smoothstep(0.30, 0.60, ndl));
col += vec3(1.0, 0.62, 0.34) * term * 0.15 * (1.0 - oceanMask * 0.45);
僕はこのコードを読めません。
ただ、コメントが日本語で書いてあるので、「何をしようとしているか」は分かります。smoothstep で境界をぼかして、朝焼け・夕焼けの帯にオレンジ(1.0, 0.62, 0.34)を足している、というところまでは追えました。
海のきらめきも一緒に出てきました。
// 海のスペキュラ(やわらかなきらめき+鋭いサングリント)
vec3 H = normalize(L + V);
float sh = max(dot(N, H), 0.0);
float spec = pow(sh, 88.0) * oceanMask * day;
float glint = pow(sh, 340.0) * oceanMask * day;
col += vec3(1.0, 0.96, 0.86) * spec * 1.05;
「滲ませたい」は自分にしか言えないけれど、「それはシェーダーで実現する」は自分には一生出てこない。この記事で一番言いたいのは、そこです。
ちなみに three は入れましたが、React Three Fiber などは使っていません。「依存を増やしたくない」と言ったら、素の Three.js とカスタムシェーダーで組む形になりました。
「輪っかに見えるのが嫌」と言ったときの返し
地球のまわりに大気の光を足してもらったとき、最初は光が強すぎて、土星の輪みたいに見えました。
「輪っぽく見えるのが嫌」とだけ伝えたら、こう直ってきました。
/* ハローは大きくすると「輪」として見えてしまう。半径を抑え、
減衰を緩くして、地球の縁から空気に溶けていくように見せる。 */
const atmoHalo = atmoShell(R*1.20, 0x8FCBFF, 2.2, 0.06, 0.26, 0.72);
僕が言った「輪っぽい」という言葉が、そのままコメントに残っています。
数字の意味は分かりません。ただ、自分の感想がコードのコメントとして固定されているのは、後から読み返したときに効きました。半年後の自分が「なんでこの値なんだ」と思っても、理由がそこに書いてある。
地球のテクスチャは、画像を1枚も使っていない
これは記事を書くために中を見ていて、自分でも初めて気づきました。
地球の雲、画像ファイルを読み込んでいません。ブラウザの中でその場で描いています。
/* ===== 雲レイヤー(独立してゆっくり流れる・昼夜で陰影) ===== */
function cloudSphereTex(){
const w=1024, h=512, c=document.createElement('canvas');
const x=c.getContext('2d');
const blob=(bx,by,r,a)=>{ /* 放射グラデーションで雲のかたまりを描く */ };
for(let i=0; i<90; i++){
const by=Math.random()*h, band=Math.sin(by/h*Math.PI);
if(Math.random() > 0.32 + band*0.42) continue; // 赤道付近に雲を寄せる
...
}
return new THREE.CanvasTexture(c);
}
Math.sin(by/h*Math.PI) で赤道あたりに雲を集めています。つまり雲の分布まで計算で作っている。
僕が言ったのは「軽くしたい」だけです。その一言が、こういう形で効いていました。
「有料APIしかないの?」と聞いたら、別の道が出てきた
サイト上部にニュースを流したかったのですが、調べるとニュースAPIは有料のものが多い。
「無料でできない?」と聞いたら、Google ニュースの RSS を読むという方法が出てきて、そのまま実装まで進みました。
/* ------------------------------------------------------------------
上部ニュースバー用のフィード
設計方針:
- 外部の有料APIを使わない。Google ニュースの RSS は鍵が要らない。
- 失敗しても画面を壊さない。取れなければ自社の実データだけを返す。
- キャッシュを効かせ、訪問のたびに外部へ取りに行かない。
------------------------------------------------------------------ */
const FEEDS = {
ja: [
{ q: '対日投資 OR 日本法人設立 外国企業', tag: '対日投資' },
{ q: '貿易 輸出 中小企業', tag: '貿易' },
{ q: '海外展開 日本企業', tag: '海外展開' }
],
en: [
{ q: 'foreign company Japan market entry', tag: 'Japan entry' },
{ q: 'global trade exports', tag: 'Trade' },
{ q: 'Japan investment economy', tag: 'Economy' }
]
};
APIキーが要らないので、鍵の管理も、月額も発生しません。
選択肢を知らないと、そもそも選べません。そこを埋めてくれたのが大きかったです。
「英語でも見られるようにしたい」の中身
日英の切り替えも入れました。ボタンひとつで全文が入れ替わります。
面白かったのは、タイトルとメタ情報まで差し替えていたことです。
function applyLang(l){
LANG = l;
document.documentElement.lang = l;
// 英語で開かれたときに、タイトルと説明が日本語のままだと海外では読まれない
const M = l==='en'
? ['Kohomadha Inc. — Connecting Japan with Global Innovation', '...']
: ['株式会社コホマダ | 海外企業の日本参入と、日本企業の海外展開を支援', '...'];
document.title = M[0];
document.querySelector('meta[name=description]')?.setAttribute('content', M[1]);
...
}
「英語でも見られるように」としか言っていません。検索結果に出る文字まで英語にするという話は、僕の頭にありませんでした。
しかもコメントに理由が書いてある。「日本語のままだと海外では読まれない」。言われてみればそのとおりです。
「1画面に収める」と言った代償
スクロールをなくす、と決めたのは僕です。かっこいいと思ったので。
指定はこの1行で済みました。
html, body { overflow: hidden; height: 100%; }
問題はここからでした。
画面の高さが足りない環境で、要素が全部重なります。ノートPCで開くと、文字の上に文字が乗る。
このとき、原因が「画面の幅」ではなく「画面の高さ」だと特定して、高さに応じて中身を削る仕組みを入れてくれました。
@media(min-width:901px) and (max-height:900px){
#heroPanel h1{font-size:clamp(25px,2.8vw,35px);margin-top:9px}
#heroPanel .hsub{font-size:13.5px;-webkit-line-clamp:2}
.hero-trust .ht-i{font-size:10px;padding:3px 7px}
}
/* 特に窮屈な画面(768px級ノート)では実績を2件に絞り、
文字量の多い言語でもガイドと衝突させない */
@media(min-width:901px) and (max-height:820px){
.hero-trust .ht-i:nth-of-type(3){display:none}
}
コメントに「文字量の多い言語でも」と書いてあります。英語表示にすると文章が長くなって溢れる、という話まで含めて対応されていました。僕はそこまで指示していません。
最終的にメディアクエリは56本になりました。ほぼ全部、この「1画面」の後始末です。
かっこいい制約は、払うコストも大きいです。もう一度やるなら、同じ判断をするか少し悩みます。
使ってみて驚いたこと
自分でブラウザを開いて、確認してくる
直した後、Claude Code自身がブラウザを開いて、スクリーンショットを撮って、「ここが崩れています」と自分で見つけて直していました。
一度、ページを開くたびに404エラーが2件出ているのを見つけてきたことがあります。以前に使っていた動画ファイルを削除したのに、読み込みの記述だけ残っていた、という話でした。
画面上は何も起きていないので、僕は一生気づかなかったと思います。
断ってくる
ある画像を「透かしが見えないように加工して」と頼んだとき、はっきり断られました。利用規約に反するから、と。
正直そのときは少しイラッとしましたが、後から考えると、断ってくれてよかったと思います。言われるがままに何でもやる相手だったら、こちらが気づかないうちに問題を起こしていました。
逆に、詰まったこと
1. もっともらしい数字を作ることがある
これが一番怖い失敗でした。
サイトに載せる文章を書いてもらっていたとき、確認していない統計の数字が入っていたことがありました。
「〜%」という具体的な数字で、読むともっともらしい。ただ出典がありません。指摘したら、その場で認めて、以後は「数字と法制度は書かない」というルールで書くようになりました。
厄介なのは、これが「間違いに見えない間違い」だということです。
コードなら、動かせばエラーが出ます。赤い字が出て、そこで止まります。でも文章は、間違っていても普通に読めてしまう。むしろ数字が入っているぶん、説得力が増して見えます。
AIは指示には忠実だけれど、指示の前提が正しいかは確認してくれない。
「説得力のある文章にして」と頼めば、忠実に説得力を足してきます。その材料が本物かどうかは、こちらが見るしかありません。
2. チャットに貼った画像は、パソコンには存在しない
これは笑い話ですが、30分ほど溶かしました。
サイトの右下に自分の顔写真を出したくて、チャットに画像を貼って「これを入れて」と頼みました。ところが、いつまでも「ファイルが見つかりません」と言われる。画像はチャットに表示されているのに、です。
チャットに貼っただけでは、パソコンのフォルダには保存されていない。
当たり前なのですが、目に見えているぶん、なかなか気づけませんでした。
非エンジニアでも使えると思った理由
作っているあいだに一番はっきりしたのは、この分担でした。
| こちらの仕事 | Claude Codeの仕事 |
|---|---|
| 何を作るか決める | どう作るか提案する |
| 良し悪しを判断する | 実装する |
| 事実かどうか確認する | 選択肢を出す |
| 責任を持つ | 手を動かす |
左側は、プログラミングの知識と関係ありません。
「昼と夜の境目を滲ませたい」と言ったのも、「スクロールはやめよう」と決めたのも、「これは違う」と却下したのも、全部こちら側です。
そして、僕は Vite も Three.js もシェーダーも、作り終わってから名前を覚えました。用語を覚えてから始めようとすると、たぶん一生始まりません。
もうひとつ大きかったのは、gitで作業が記録されていることです。おかしくなったら戻せる。「壊したらどうしよう」がなくなると、試す回数が一気に増えます。そして試した回数が、そのまま上達になりました。
まとめ
Claude Codeは「コードを書いてくれる道具」ではなく、「頭の中にあるものを、形になるまで付き合ってくれる相手」でした。
コードが書けないことは、思ったほど問題になりませんでした。
代わりに問題になったのは、「何を作りたいのか」を自分の言葉で説明できるか、そして「これは違う」と判断できるかでした。これは技術力ではなく、それを分かっているかどうかの話です。
そして、言われたことを疑わずに受け取ってはいけないということ。数字の件も、こちらが気づいて止めました。気づけたのは、僕がその内容を分かっていたからです。
任せられるのは手であって、判断ではない。作り終えて一番強く感じたのはそこでした。
もし「興味はあるけど自分には難しそう」と思っている人がいたら。作りたいものが1つでもあるなら、それが唯一の必要条件だと思います。
用語は後から覚えれば大丈夫でした。少なくとも僕はそうでした。
おまけ:この記事で作ったサイト
実際に動いているものはこちらです。
記事に載せたシェーダーも、スクロールしない1画面も、日英の切り替えも、全部そこで動いています。うまくいっていないところも含めて、そのままです。
直したいところが出たら、いまはその日のうちに自分で直せます。作れたことより、この状態になったことのほうが大きいと思っています。
作った会社
株式会社コホマダ(Kohomadha Inc.)
- 海外企業の日本市場参入支援 … 日本での販路、パートナー探索、商談の設定
- 日本企業の海外展開支援 … 市場の選定から、現地パートナー、実務まで
- 代表:髙松 直弥(鳥取県 海外よろずビジネスサポート駐在員/現職)
- 所在地:東京都杉並区
もともとは映像制作をしていました。いまは海外展開の支援が本業で、現地に行って、人に会って、取引が動くところまで関わっています。自分でもスリランカで事業を立ち上げ、調達から販売まで一通りやりました。
そのうえで、ITは「展開を動かすための道具」として扱っています。サイト、業務の仕組み、自動化。必要なら構築とサポートまで手を出します。海外に出るときも、日本に入るときも、結局そこが詰まるからです。
ソフトウェア開発を看板にしている会社ではありません。それでもこのサイトが自分たちで作れた、というのが今回の記事です。
もし「海外に出たい」「日本に入りたい」「まず何から決めればいいか分からない」という話があれば、聞くだけなら無料でやっています。合わなければ、その旨をはっきりお伝えします。