Superwhisper 日本語設定ガイド｜Custom ModeでClaude Codeへ連携

「Superwhisperを日本語で使うと、専門用語がうまく認識されない」「長く話すと大事な条件が抜けてしまう」と困ることはありませんか？

特にClaude Codeへ指示を送るなら、文字起こしの正確さだけでなく、禁止事項や言い直した内容まできちんと残すことが大切です。

短い指示なら標準設定でも十分ですが、内容が複雑になるほどCustom Modeが役立ちます。

専門用語の聞き間違いには、VocabularyやReplacementsも活用できます。

この記事では、Superwhisperを日本語で使うときの設定方法から、Claude Codeへ指示を渡すまでの流れをわかりやすくご紹介します。

まずはSuperwhisperの仕組みを知っておこう

「設定項目がいろいろあって、どこを直せばいいのかわからない」と感じる方もいるかもしれません。

そんなときは、まずSuperwhisperがどんな順番で音声を処理しているのかを知っておくと、ぐっとわかりやすくなります。

大きく分けると、処理は次の2段階です。

1. 音声モデルが、話した声を文字に変える
2. 言語モデルが、文字になった内容を読みやすく整える

つまり、「聞き取りの問題」と「文章を整えるときの問題」は別ものです。

ここを分けて考えると、どの設定を見直せばよいのか判断しやすくなります。

設定項目	何を決めるものか
言語	何語として音声を聞き取るかを決める
音声モデル	話した声を文字へ変える
言語モデル	文字起こし後の文章を整える
AI Instructions	どのような文章へ整えるかを伝える
Vocabulary	専門用語を聞き取りやすくする
Replacements	よくある誤変換を決まった表記へ直す

たとえば、Djangoと話したのに別の単語へ変わっているなら、まず見るべきなのは音声モデルやVocabularyです。

反対に、Djangoとは正しく文字起こしできているのに、「変更しないで」と話した条件が消えているなら、AI Instructionsや言語モデル側を見直してみましょう。

日本語用Custom Modeを設定する手順

「最初からCustom Modeを細かく作り込まないといけないの？」と思うかもしれませんが、そこまで構える必要はありません。

短い修正や、一文で済むシンプルな指示なら、標準設定でも十分使えます。

Custom Modeを使いたいのは、たとえば次のような場面です。

• 専門用語が増えてきた
• 条件や禁止事項が複数ある
• 途中で言い直すことが多い
• Claude Codeへ渡す前に、一定の形へ整えたい

こうした指示が増えてきたら、次の順番で設定してみましょう。

1. Voice Processingで日本語と音声モデルを選ぶ
2. Custom Modeを作り、言語モデルを選ぶ
3. AI Instructionsへ文章の整え方を書く
4. VocabularyとReplacementsを設定する
5. Historyで元の文字起こしと処理後の文章を比べる
6. 内容を確認してClaude Codeへ渡す

最初からすべて設定する必要はありません。

使っていて困った部分から、少しずつ足していけば大丈夫です。

指示の組み立て方から確認したい方は、日本語の音声コーディングで指示を組み立てる基本も参考にしてみてください。

1. 言語を日本語に設定する

まずは、使いたいモードの「Voice Processing」を開き、言語を日本語に設定しましょう。

「Automatic」を選べば、話している言語を自動で判定してくれます。

便利ではありますが、日本語を話しているのに英語として処理されることもあります。

普段ほとんど日本語で使うのであれば、最初から日本語へ固定しておくほうが安心です。

次に選ぶのが、話した声を文字へ変える音声モデルです。

音声モデルには、インターネット経由で処理するクラウドモデルと、パソコン内で処理するローカルモデルがあります。

モデル	特徴
クラウドモデル	パソコンへの負担を抑えやすく、さまざまなモデルを選べる
ローカルモデル	音声をパソコン内で処理でき、通信環境にも左右されにくい

「開発内容を外部へ送りたくない」という場合は、ローカルモデルが気になりますよね。

ここで注意したいのが、音声モデルだけローカルにしても、すべての処理がパソコン内で完結するとは限らないことです。

Custom Modeでクラウドの言語モデルを使っている場合、文字起こし後の文章は外部へ送られます。

外部送信を避けたい場合は、音声モデルだけでなく、Custom Modeで使う言語モデルも確認しておきましょう。

また、選べるモデルや対応言語は環境によって異なります。

日本語対応かどうかを確認しながら、自分の使い方に合うものを選んでみてください。

2. Custom Modeと言語モデルを選ぶ

「メールでは使いやすいのに、Claude Codeへ渡すと指示が崩れる」と感じる場合は、Custom Modeを用途ごとに分けると使いやすくなります。

Custom Modeは、文字起こしした内容を、自分が使いたい形へ整えるための機能です。

たとえば、次のような使い方ができます。

• メールとして読みやすい文章にする
• 会議メモを箇条書きにする
• Claude Codeへ渡す開発指示にする
• 言い直した部分を整える
• 禁止事項やテスト条件を分けて表示する

ここで選ぶ言語モデルは、声を聞き取るためのものではありません。

文字になった内容を読み、「どう整えるか」を判断する役割があります。

Claude Codeへ長い指示を送りたい場合は、言い直しや複数の条件をきちんと読み取ってもらえることが大切です。

いきなり長文で試す必要はありません。

まずは短い指示で確認し、問題なければ禁止事項やテスト条件を含む長めの音声でも試してみましょう。

Windows版では、利用できるローカル言語モデルに制限がある場合もあります。

外部へ送りたくない内容を扱う場合は、今どのモデルを選んでいるのかも忘れずに見ておきたいポイントです。

3. AI Instructionsへ文章の整え方を書く

Custom Modeを作るときに、「AI Instructionsには何を書けばいいの？」と迷いやすいですよね。

Claude Code用なら、最初から細かいルールを大量に書く必要はありません。

まずは、次の内容がきちんと残るように指定してみましょう。

• 何をしたいのか
• どこを調べる、または変更するのか
• 何をしてはいけないのか
• どのテストを行うのか
• 最後に言い直した内容を優先する

特に気をつけたいのが、途中で言い直したときです。

たとえば、「この部分を直して。いや、直す前に原因だけ調べて」と話すことがありますよね。

この場合、最初の「直して」まで残っていると、Claude Codeが修正まで進めてしまう可能性があります。

そこで、あとから話した内容を優先するようにAI Instructionsへ書いておきましょう。

たとえば、次のように設定できます。

User Messageには、日本語で話した開発用の指示が入っている。

User Messageを読み取り、Claude Codeへ渡せる指示文へ整える。

ルール

・言い直しがある場合は、後から話した内容を優先する
・Django、Cloud Run、Playwrightなどの技術用語は、できるだけ元の表記を残す
・話していない作業や条件を追加しない
・禁止事項や変更してはいけない場所を省略しない
・曖昧な内容を勝手に決めない

出力する内容

・目的
・対象
・禁止事項
・テスト条件
・報告してほしい内容

短く、実行内容がわかる文章にする。

最初は、「言い直しは後の内容を優先する」「禁止事項を省かない」の2つだけでも十分です。

それでも思ったような文章にならない場合は、入力例と出力例を追加してみましょう。

普段自分が話しそうな指示を2〜3個入れておくと、「こういう形にしてほしい」というイメージが伝わりやすくなります。

4. VocabularyとReplacementsを使い分ける

「Playwrightと話したのに、毎回プレイライトになる」といった悩みは、音声コーディングではよく起こります。

DjangoやCloud Runなども、日本語の文章に混ぜると表記が崩れることがありますよね。

こうした専門用語の聞き間違いや表記揺れを減らしたいときに使うのが、VocabularyとReplacementsです。

機能	向いている使い方
Vocabulary	音声モデルへ単語の候補を伝え、聞き取りやすくする
Replacements	文字起こし後の決まった誤変換を、正しい表記へ直す

Vocabularyには、普段よく使う専門用語を登録しておきましょう。

たとえば、次のような言葉です。

• Django
• Cloud Run
• Playwright
• migration
• GitHub Actions

ここで、「たくさん登録したほうが精度も上がりそう」と思うかもしれません。

ですが、単語は増やしすぎないほうが無難です。

登録しすぎると、ほかの言葉の聞き取りや句読点へ影響することもあります。

まずは、何度も間違える単語だけに絞ってみましょう。

毎回ほぼ同じ形に間違える場合は、Replacementsが便利です。

Playwrightがいつも「プレイライト」になるなら、「プレイライト」を「Playwright」へ置き換える設定を作ります。

Vocabularyで聞き取りやすくし、それでも直らない表記だけReplacementsで補うと使いやすいでしょう。

なお、「調査だけと伝えたのに修正まで含まれている」「禁止事項が消えている」といった問題は、Vocabularyでは直せません。

そうした場合は、AI Instructions側を見直してみてください。

5. HistoryでVoiceとAIを比べる

設定を変えたら、そのまま本番で使うのではなく、Historyで一度確認してみましょう。

Historyでは、「Voice」と「AI」を切り替えて見比べられます。

• Voiceには、音声モデルが作った元の文字起こしが表示されます
• AIには、Custom Modeで整えたあとの文章が表示されます

「どこで内容が変わったの？」と迷ったときは、ここを見ると原因を探しやすくなります。

Voiceの時点で専門用語が間違っているなら、音声モデルやVocabulary側の問題です。

Voiceでは合っているのに、AIで禁止事項が消えているなら、AI Instructionsを見直してみましょう。

設定を比べるたびに、同じ内容を録音し直す必要はありません。

Historyから同じ音声をもう一度処理すれば、Custom Modeを変えたときの違いも確認できます。

見るときは、次のポイントをチェックしてみてください。

• 技術用語の表記が合っているか
• 最後に言い直した内容が優先されているか
• 「変更しない」「作らない」といった条件が残っているか
• テスト方法や確認する範囲が消えていないか
• 自分が話していない作業が追加されていないか

少し手間に感じるかもしれません。

でも、Claude Codeへ渡したあとに「条件が抜けていた」と気づくより、先にHistoryで確認しておくほうが安心でしょう。

Claude Codeへ指示を渡す方法

Custom Modeで文章を整えたら、いよいよClaude Codeへ渡します。

ここはmacOSとWindowsで少し使い方が変わるので、それぞれ見てみましょう。

macOSでは専用連携を使える

macOS版では、SuperwhisperからClaude Codeを操作できる専用連携が用意されています。

音声で指示を送りながら、Claude Codeの動きを確認できる仕組みです。

便利ではありますが、長い指示をそのまま送るのは少し不安ですよね。

特に禁止事項や変更範囲を含む場合は、送信前に一度文章を確認しておくと安心です。

たとえば、次の内容を見ておきましょう。

• 調査だけなのか、修正まで行うのか
• 変更してはいけない場所が残っているか
• migrationなど、作成してはいけないものが書かれているか
• 実行してほしいテストが含まれているか

音声ではきちんと話したつもりでも、処理の途中で条件が抜けることがあります。

最後に自分の目で確認しておくと、意図しない変更を防ぎやすくなります。

Windowsでは確認してから貼り付ける

Windows版では、Custom Modeで整えた結果をHistoryで確認し、Claude Codeへ貼り付ける方法がわかりやすいでしょう。

Claude Codeの入力欄で直接音声入力することもできます。

短い指示なら、それでも問題ないケースはあります。

でも、禁止事項や複数の条件を含む場合は、一度Historyで文章を確認してから渡すほうが安心です。

最初から複雑な連携を作る必要はありません。

「音声入力する」「Historyで確認する」「Claude Codeへ貼り付ける」というシンプルな流れから試してみましょう。

同じ音声がどう変わるか比べてみよう

ここまで設定方法を見てきましたが、「実際にどれくらい変わるの？」と気になりますよね。

そこで、途中で言い直しがあり、禁止事項も含む音声を例に比べてみましょう。

ポイントは、専門用語の聞き取りミスと、指示の内容がうまく整っていない問題を分けて考えることです。

Voiceの段階でPlaywrightが「プレイライト」になっているなら、音声認識側を見直します。

文字起こしは正しいのに、目的や禁止事項が抜けている場合は、Custom Mode側の問題です。

1. Voiceに表示される元の文字起こし

DjangoのユーザーAPIを直して。いや、変更じゃなくて原因を調べて。migrationは作らないで。Playwrightでログインのテストをして、ほかの画面は変えないで。

最初に話した「直して」と、あとから言い直した「原因を調べて」が両方残っています。

人が読めば、「修正ではなく調査をしてほしいんだな」とわかるでしょう。

でも、Claude Codeへそのまま渡すと、「調査したあとに修正もする」と受け取られる可能性があります。

2. Custom Modeで処理した結果

• 目的：DjangoのユーザーAPIで起きている問題の原因を調査します
• 対象：ユーザーAPIに関係する処理を確認します
• 禁止事項：コードは修正せず、migrationやほかの画面も変更しません
• テスト条件：Playwrightでログインテストを行います
• 報告内容：考えられる原因とテスト結果を報告します

あとから話した「原因を調べて」が優先され、調査だけを行う指示になりました。

「変更しないもの」も分かれているので、Claude Code側でも作業範囲を読み取りやすくなっています。

3. Claude Codeへ渡す完成形

目的
DjangoのユーザーAPIで起きている問題の原因を調査する。

対象
ユーザーAPIに関係する処理を確認する。

禁止事項
・この段階ではコードを修正しない
・migrationを作らない
・ほかの画面を変更しない

テスト
Playwrightでログインテストを実行する。

報告
考えられる原因と、テスト結果を報告する。

長い指示を1つの文章へ詰め込むより、目的や禁止事項を分けたほうがわかりやすくなります。

「調査だけしてほしいのか」「修正まで任せたいのか」も、これなら迷いにくいでしょう。

AIへの指示用として確認したいポイント

SuperwhisperをClaude Code用に使うときは、「文字起こしが合っているから大丈夫」と判断しないようにしたいところです。

本当に確認したいのは、自分が話した条件が、処理後の文章にもきちんと残っているかです。

確認すること	見る場所
日本語や専門用語を正しく聞き取れているか	HistoryのVoice
言い直した内容が反映されているか	HistoryのAI
禁止事項やテスト条件が残っているか	HistoryのAI
話していない指示が加わっていないか	VoiceとAIを比べる
Claude Codeが迷わず作業できる形か	完成した指示文を確認

試すときは、Django、Cloud Run、migration、Playwrightなど、普段の開発で実際に使う単語を入れてみましょう。

短い文章だけでは、言い直しや禁止事項まで残せるかは判断しにくいです。

本番に近い長さで一度試しておくと、実際に使うときも安心でしょう。

Superwhisperが向いている人・向かない人

ここまで読むと、「自分にはSuperwhisperが合っているのかな？」と気になる方もいるかもしれません。

Superwhisperは、開発用の音声入力だけに使うツールではなく、メールやメモ、チャットなどにも使えます。

そのぶん、設定できる項目も多めです。

細かく自分向けに調整したい方には便利ですが、「とにかくすぐ音声入力したい」という方には少し重く感じることもあるでしょう。

Superwhisperが向いている人

Superwhisperは、次のような方に向いています。

• Claude CodeやCursorへ長い指示を送ることが多い方
• 開発以外のメールやメモにも音声入力を使いたい方
• 用途に合わせて複数のモードを切り替えたい方
• 専門用語や文章の形を細かく調整したい方
• AIへ送る前に、文字起こし後の文章を確認したい方

最初にVocabularyやAI Instructionsを設定する手間はかかります。

でも、よく使う言葉や文章の形が決まってくれば、毎回手直しする負担は減らせるはずです。

Superwhisperが向かない人

反対に、「AIコーディング用の音声入力を一度だけ試したい」という方には、少し機能が多く感じられるかもしれません。

次のような方は、まずシンプルな音声入力から始める方法もあります。

• Custom Modeを設定せず、すぐに使いたい方
• 音声をそのまま文字へ変えられれば十分な方
• 専門用語の登録や結果の比較をしたくない方
• 開発以外では音声入力を使う予定がない方

設定をしないまま日本語の技術用語を多く話すと、あとから直す箇所が増えることもあります。

まずはVoice to Textで聞き取り精度を確認し、「もう少し整えたい」と感じてからCustom Modeへ進んでも遅くありません。

構造化まで任せたい場合の選択肢

Superwhisperは、日本語の音声入力や専門用語の補正に便利です。

短い指示や単語の修正であれば、Superwhisperだけでも対応しやすいでしょう。

一方で、長い音声から毎回「目的・対象・禁止事項・テスト条件」のような形へ整えたい場合は、Custom Modeやvoice-prompt系サービスなど、別の方法も候補になります。

「どの音声認識が一番正確か」だけで選ぶのではなく、Claude CodeやCursorへ渡す前に、どこまで文章を整えたいのかも考えてみてください。

専門用語が正しく残っているか、長い指示でも条件が抜けていないかを確認してから渡せば、意図しない作業も防ぎやすくなります。

自分の使い方に合う設定から少しずつ試して、音声での開発指示をもっと使いやすくしていきましょう。