音声入力 ヘルプ

1. 入れ方

macOS 14 以降の、Apple シリコン（M1 以降）を搭載した Mac でお使いいただけます。ターミナル（「アプリケーション」→「ユーティリティ」）を開いて、次の順に進めてください。

手順1　Homebrew を入れる

すでに入っている方は飛ばしてください。ターミナルで brew -v と打ち、バージョンが出れば入っています。

手順2　文字起こしの部品（whisper-cpp）を入れる

手順3　音声認識モデルを入れる（約 0.5GB）

次の2行を貼り付けます。通信の速さによっては数分かかります。

手順4　アプリを入れる

1. こちらから zip ファイルをダウンロードします（これまでの版）
2. zip を開き、出てきた「VoiceInput」を「アプリケーション」フォルダへ移します

手順5　ログインしたら自動で起動させる（任意）

「システム設定」→「一般」→「ログイン項目」の「＋」から VoiceInput を足してください。

2. はじめて開くとき

Apple の開発元の署名を付けていないため、はじめて開くと「開発元を確認できない」「開けません」と表示されます。一度だけ、次の操作で開いてください。

macOS 15 Sequoia 以降

1. VoiceInput をダブルクリックし、表示された画面で「完了」を押します
2. 「システム設定」→「プライバシーとセキュリティ」を開き、下の方にある「“VoiceInput”は開発元を確認できないため…」の横の「このまま開く」を押します
3. もう一度 VoiceInput を開き、「このまま開く」を押します

macOS 14 Sonoma

VoiceInput を Control キーを押しながらクリックし、「開く」を選びます。確認の画面でもう一度「開く」を押してください。

開くと、画面右上のメニューバーにアイコンが出ます。Dock には出ません。

3. マイクとアクセシビリティを許可する

はじめて ⌥Space を押すと、マイクの使用を求める画面が出ます。「許可」を押してください。

話した文字をほかのアプリへ貼り付けるには、アクセシビリティの許可も必要です。

1. メニューバーのアイコンから「権限を確認…」を開きます
2. 「設定を開く」を押し、「アクセシビリティ」の一覧で VoiceInput をオンにします
3. 一覧に VoiceInput が出ないときは、メニューの「アプリを Finder で表示」で出てきた VoiceInput を、一覧へドラッグしてください

4. 使い方

1. 文字を入れたい場所（メール、チャット、メモなど）をクリックします
2. ⌥ Option と Space を同時に押すと録音が始まります（「ティン」と鳴ります）
3. 話し終えたら、もう一度 ⌥Space を押します（「ポン」と鳴ります）
4. 文字に直されて、カーソルの位置に貼り付けられます

モードの切り替え

メニューから2つのモードを選べます。

• 高速入力モード（Mac内ですぐ変換）　Mac の中だけで文字にします。AI もネットも使いません
• 通常モード（AIで漢字を補正）　文字にしたあと、Claude が漢字の誤りや言い直しを整えます。準備が必要です

そのほかの機能

• 直近の変換結果　これまでに入れた文字を、もう一度コピーできます
• 用語辞書を開く　よく使う社名や専門用語を登録すると、その表記に寄せて変換します
• 人名の読みを登録…　「読み」と「正しい表記」の組み合わせを登録できます
• 仕上げの文体を設定…　「チャットでは短く」「メールでは丁寧に」など、通常モードでの整え方を指定できます

「〜じゃなくて、〜」と言い直したときは、前半を消して後半だけを残します。英数字と日本語のあいだには半角スペースが入ります。

5. AI 補正を使う（API キーか Max プラン）

通常モードでは、Anthropic の Claude を使います。次のどちらかをご用意ください。

A. Anthropic の API キーを使う

使った分だけ Anthropic から請求されます。Claude の月額プランに入っていない方は、こちらが手軽です。

1. Anthropic Console に登録し、支払い方法を設定します
2. 「API Keys」でキーを作成し、表示されたキー（sk-ant- で始まる文字列）をコピーします
3. 音声入力のメニューで「Claude APIキーを設定…」を押し、キーを貼り付けて「保存」を押します
4. メニューで「通常モード（AIで漢字を補正）」を選びます

キーは Mac のキーチェーンにだけ保存され、設定ファイルやログには書かれません。消すときは、同じメニューの「キーを削除」を押してください。

B. Claude Code の Max プランを使う

Claude の Max プランをお使いの方は、追加の料金なしでお使いいただけます。API キーを入れていないときは、こちらが使われます。

1. ターミナルで Claude Code を入れます
   curl -fsSL https://claude.ai/install.sh | bash
2. ターミナルで claude と打ち、案内に沿って Max プランのアカウントでログインします
3. 音声入力のメニューで「通常モード（AIで漢字を補正）」を選びます

「入力画面を参考にする（端末内）」をオンにすると、入力中の画面の文字を手がかりに、人名や社名の表記を合わせます。その文字を Claude にも送ってよいかは「画面の参考情報もClaudeに送る」で選べます。

6. どのデータがどこへ送られるか

メニューの「Jevの設定…」は、TypeSafe 社の表記補正サービスを使う任意の機能です。お使いになる場合は、画面に出る送信内容と保持条件をご確認ください。

7. 困ったとき

⌥Space を押しても録音が始まらない

ほかのアプリが ⌥Space を使っていると、登録できません。メニューに「⚠️ ⌥Space を登録できていません」と出ていないかご確認ください。出ている場合は、そのアプリのショートカットを変えるか、メニューの「録音を始める」をお使いください。

文字にはなるが、貼り付けられない

アクセシビリティの許可が外れています。3. の手順で許可し直してください。貼り付けられなかった文字はクリップボードに入っていますので、⌘V で貼るか、メニューの「直前の文字起こし結果をコピー」をお使いください。

新しい版に入れ替えたら、許可が外れた

署名を付けていないため、版を入れ替えるとマイクとアクセシビリティの許可が外れることがあります。システム設定の一覧で VoiceInput をいったん「−」で消し、もう一度許可してください。一覧から消せないときは、ターミナルで次を実行してから許可し直してください。

tccutil reset Microphone com.ishot.voice-input tccutil reset Accessibility com.ishot.voice-input

「モデルが見つからない」と出る

手順3のモデルが入っていないか、ダウンロードが途中で止まっています。もう一度手順3のコマンドを実行してください。

通常モードにしても補正されない

API キーをお使いの方は、キーが正しいか、Anthropic Console で支払い方法が設定されているかをご確認ください。Max プランをお使いの方は、ターミナルで claude を開き、ログインの状態をご確認ください。補正できなかったときは貼り付けを止め、補正前の文字をクリップボードに残します。⌘V で貼り付けてください。

ほかに原因を調べたい

メニューの「ログを開く」で、動作の記録をご覧いただけます。サポートはございませんが、ソースコードは公開していますので、Claude Code などの AI にログとあわせて渡すと、原因を調べやすくなります。

8. 削除のしかた

1. API キーを入れた方は、メニューの「Claude APIキー: 設定済み（変更・削除…）」→「キーを削除」で先に消します
2. メニューの「終了」でアプリを止めます
3. 「アプリケーション」フォルダの VoiceInput をゴミ箱へ入れます。ログイン項目に足した方は、そこからも外してください
4. 設定・辞書・モデルをまとめて消すときは、ターミナルで次を実行します
   rm -rf ~/.voice-input
5. システム設定の「マイク」「アクセシビリティ」の一覧から VoiceInput を「−」で消します