日本語のPC名で vercel login が落ちる（ByteString TypeError）を、PC名を変えずに直す

症状

Windows で vercel login（Vercel CLI 63.x、Node 20〜24）を実行すると、ブラウザが開く前に即終了する。

Error: An unexpected error occurred in login: TypeError: Cannot convert argument to a ByteString because the character at index 0 has a value of 20316 which is greater than 255.

20316 は「作」の文字コード。コンピューター名が「作業用PC」のように日本語（非 Latin-1）を含むと起きる。

原因

Vercel CLI はデバイス認証の HTTP リクエストで User-Agent に os.hostname() を入れる（dist/chunks/*.js の userAgent = \${hostname()} @ ${ua}`）。Node の fetch`（undici）はヘッダー値に Latin-1 以外を許さないため、日本語のホスト名で例外になる。PC名の変更はドメイン参加や他ツールに影響するので避けたい。

直し方（PC名を変えない。CLI も編集しない）

1. シムを1ファイル置く（例 <ホーム>/.local-shims/os-hostname-ascii.cjs）:

// os.hostname() が非ASCIIのときだけ ASCII の別名を返す
const os = require('os');
const module_ = require('module');
const FALLBACK = 'my-pc';
const orig = os.hostname.bind(os);
function safeHostname() {
  let h = '';
  try { h = orig(); } catch { h = ''; }
  return (!h || /[^\x20-\x7E]/.test(h)) ? FALLBACK : h;
}
os.hostname = safeHostname;
if (os.default && typeof os.default === 'object') os.default.hostname = safeHostname;
// ESM の `import { hostname } from "os"` にも効かせる
if (typeof module_.syncBuiltinESMExports === 'function') module_.syncBuiltinESMExports();

2. Vercel CLI を呼ぶときだけ NODE_OPTIONS で先読みさせる:

$env:NODE_OPTIONS = "--require <ホーム>/.local-shims/os-hostname-ascii.cjs"
$env:VERCEL_TELEMETRY_DISABLED = "1"
vercel login        # 以後 vercel whoami / env add / --prod も同じ env で

bash なら NODE_OPTIONS="--require <ホーム>/.local-shims/os-hostname-ascii.cjs" vercel login。

3. 確認: node --require <シム> -e "console.log(require('os').hostname())" が my-pc を出せば OK。vercel login は Visit https://vercel.com/oauth/device?user_code=XXXX-XXXX まで進む。

罠

• 動作確認で vercel login を起動すると、CLI がブラウザを自動で開く。確認だけなら BROWSER=echo を付けるか、開いたタブを閉じる。放置すると期限切れコードのタブが残り、人がそれを操作して「Could not verify user code」になる。
• vercel link --yes は所属する team が複数あると止まる。--scope <team-slug> を付ける（vercel whoami の後の JSON の next[] にスラッグが出る）。
• vercel link は .env.local を上書きすることがある（「Updated .env.local」と出る）。env を入れる前に値を別ファイルに退避しておく。
• vercel env add NAME production は標準入力から値を読める: printf '%s' "$VALUE" | vercel env add NAME production。改行を混ぜない（tr -d '\r\n'）。

同じ原因で落ちる可能性があるもの

os.hostname() を HTTP ヘッダーや URL に入れる CLI 全般（デバイス認証系）。エラー文に ByteString と index 0 has a value of <5桁> が出たら、まず PC名の非ASCII を疑う。