0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

はじめに

僕はエンジニアではありません。

株式会社コホマダという会社をやっていて、海外企業の日本市場参入と、日本企業の海外展開を支援しています。あわせて、鳥取県の海外よろずビジネスサポート駐在員という公職も務めています。

要するに、ずっと人と会って話す仕事をしてきた人間です。プログラミングは書けません。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で地球を描いています。そういうものを、コードが読めない人間が自分の手元に持っていて、いまも直し続けている。ここが一番の変化でした。

構成はこれだけです。

package.json
{
  "dependencies": {
    "@vercel/analytics": "^2.0.1",
    "three": "^0.158.0"
  },
  "devDependencies": {
    "vite": "^5.4.0"
  }
}

依存パッケージは2つだけ。「軽くしたい」と言い続けた結果でした。

指示は、こんな日本語でした

技術用語は一切使っていません。実際に打ったのはこれです。

3Dの地球が回っていて、国をクリックすると情報が出てくるサイトにしたい

昼と夜の境目が、ぼんやり滲んでほしい

スクロールするのはやめよう。基本的に1ページで

第三者が初見で見て、違和感なく、すげーってなるサイトにしたい

最後のやつなんて、指示として成立しているのかも怪しいと思います。でも、ちゃんと返ってきました。

「滲んでほしい」に返ってきたコード

一番驚いたのがこれでした。

「昼と夜の境目を滲ませて」と言ったら、シェーダーというものを書いてきました。GPUで1ピクセルずつ色を計算する仕組みらしいです。

出てきたのがこれです。

src/main.js(フラグメントシェーダーの一部)
// 昼夜:やわらかいターミネータ
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)を足している、というところまでは追えました。

海のきらめきも一緒に出てきました。

src/main.js(海のスペキュラ)
// 海のスペキュラ(やわらかなきらめき+鋭いサングリント)
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 とカスタムシェーダーで組む形になりました。

「輪っかに見えるのが嫌」と言ったときの返し

地球のまわりに大気の光を足してもらったとき、最初は光が強すぎて、土星の輪みたいに見えました。

「輪っぽく見えるのが嫌」とだけ伝えたら、こう直ってきました。

src/main.js
/* ハローは大きくすると「輪」として見えてしまう。半径を抑え、
   減衰を緩くして、地球の縁から空気に溶けていくように見せる。 */
const atmoHalo = atmoShell(R*1.20, 0x8FCBFF, 2.2, 0.06, 0.26, 0.72);

僕が言った「輪っぽい」という言葉が、そのままコメントに残っています。

数字の意味は分かりません。ただ、自分の感想がコードのコメントとして固定されているのは、後から読み返したときに効きました。半年後の自分が「なんでこの値なんだ」と思っても、理由がそこに書いてある。

地球のテクスチャは、画像を1枚も使っていない

これは記事を書くために中を見ていて、自分でも初めて気づきました。

地球の雲、画像ファイルを読み込んでいません。ブラウザの中でその場で描いています。

src/main.js
/* ===== 雲レイヤー(独立してゆっくり流れる・昼夜で陰影) ===== */
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/news.js
/* ------------------------------------------------------------------
   上部ニュースバー用のフィード

   設計方針:
   - 外部の有料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キーが要らないので、鍵の管理も、月額も発生しません。

選択肢を知らないと、そもそも選べません。そこを埋めてくれたのが大きかったです。

「英語でも見られるようにしたい」の中身

日英の切り替えも入れました。ボタンひとつで全文が入れ替わります。

面白かったのは、タイトルとメタ情報まで差し替えていたことです。

src/main.js
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行で済みました。

src/styles.css
html, body { overflow: hidden; height: 100%; }

問題はここからでした。

画面の高さが足りない環境で、要素が全部重なります。ノートPCで開くと、文字の上に文字が乗る。

このとき、原因が「画面の幅」ではなく「画面の高さ」だと特定して、高さに応じて中身を削る仕組みを入れてくれました。

src/styles.css
@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は「展開を動かすための道具」として扱っています。サイト、業務の仕組み、自動化。必要なら構築とサポートまで手を出します。海外に出るときも、日本に入るときも、結局そこが詰まるからです。

ソフトウェア開発を看板にしている会社ではありません。それでもこのサイトが自分たちで作れた、というのが今回の記事です。

もし「海外に出たい」「日本に入りたい」「まず何から決めればいいか分からない」という話があれば、聞くだけなら無料でやっています。合わなければ、その旨をはっきりお伝えします。

info@kohomadha.com

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?