# こえノート — 話すだけで、整った文章に

「こえノート」は、**話した内容をAIが整った文章にして、カーソルの位置に直接入力してくれる**音声入力ツールです。「えーっと」「あのー」は自動で消え、「やっぱり〇〇で」と言い直せばちゃんと直った文章になります。メール・チャット・メモ・ブログ、文字を打つ場所ならどこでも使えます。Mac版・Windows版、どちらも同じ仕組みで動きます。

> 📁 **このzipにはMac版・Windows版の両方が入っています。**
> **Macをお使いの方**は「Mac」フォルダの中の `こえノート.app` を、
> **Windowsをお使いの方**は「Windows」フォルダの中の `こえノート.exe` をお使いください。

## 動作環境

**Mac版**
- Apple Silicon搭載Mac（M1以降）／macOS 13以降

**Windows版**
- Windows 10 / 11（64bit）
- Claude Codeがインストール済み・ログイン済みだと追加コスト0円で使えます（無くてもAPIキーだけで動作可）

どちらも共通でインターネット接続が必要です（文章の仕上げにAIを使うため）。

## インストール

### Macの場合

1. **こえノート.app を「アプリケーション」フォルダにコピー**してダブルクリック
   - ⚠️ 初回に「開発元を確認できないため開けません」と出たら：アプリを**右クリック→「開く」**。それでもダメなら「システム設定 → プライバシーとセキュリティ」を下にスクロールして「**このまま開く**」を押してください（最初の1回だけです）
2. 自動で開く「**はじめの設定**」画面で、ボタンを順番に押していく
   - マイクの許可（あなたの声を聞くため）
   - アクセシビリティの許可（キーの検知と、カーソル位置への文字入力のため）
   - 音声認識データのダウンロード（約570MB・初回のみ）
   - APIキーの設定（下の「料金について」参照）
3. 設定が終わったら、**左Option（⌥）キーをポンと押して話す → もう一度ポン**。これだけです

さらに、**テキストを選択して右Option（⌥）** を押すと「書き換えモード」になります。「これを英語にして」「もっと丁寧に」「箇条書きにして」と話してもう一度押すと、選択した部分がその通りに書き換わります（翻訳・要約・リライト何でもOK）。

※ マイクとアクセシビリティの2つの許可は、TypelessやWispr Flowなどどの音声入力ツールでも必要になる標準的なものです。

### Windowsの場合

1. zipを解凍して、こえノート.exe を好きな場所に置く（デスクトップでもドキュメントでもOK）
2. **こえノート.exe をダブルクリック**
   - ⚠️ 初回に「Windowsによって PC が保護されました」という青い画面が出ます。これは**未署名アプリの標準的な警告**です。「**詳細情報**」をクリック→「**実行**」ボタンを押せば起動できます（最初の1回だけ）
3. 自動で「**はじめの設定**」画面が開くので、上から順にボタンを押す
   - 音声認識データのダウンロード（約580MB・初回のみ）
   - APIキーの設定（下の「料金について」参照。Claude Codeが入っていれば省略可）

設定が終わったら、**右Ctrlキーをポンと押して話す→もう一度ポン**。これでカーソル位置に整った文章が入ります。

テキストを選択して**左Ctrl**を押すと「書き換えモード」になります。「これを英語にして」「もっと丁寧に」と話してもう一度押すと、選択部分がその通りに書き換わります。

（キーの割り当ては、タスクトレイのアイコン右クリック→「ショートカット設定」からいつでも変更できます）

## 料金について

こえノート自体は無料です。文章の仕上げに使うAI（Claude）の利用料だけ、実費でかかります。

- **Windowsで、このPCにClaude Codeが入っていてログイン済みなら、追加コスト0円で動きます**（Claude Codeのサブスクをそのまま使う仕組み。Macでも同様の仕組みが使えます）
- 最速で使いたい場合は [console.anthropic.com](https://console.anthropic.com/) で無料登録→**クレジットを最低$5（約750円）購入**→APIキーを作成して設定画面に貼り付け
- 費用の目安：**毎日1時間ガッツリ話しても月$5（約750円）前後**。月額制ではないので、使わない月は減りません
- いま使っている分は、メニュー（Mac：メニューバー／Windows：タスクトレイ）の「今月のAPI代」でいつでも確認できます

参考：同種の有料ツール（Typeless Pro）は月$12〜30。こえノートなら**1/6〜1/20程度のコスト**で同じことができます。

## プライバシー

- **音声はPCの外に出ません**。音声→文字の変換は、すべてお使いのPCの中で行われます
- 文字になったテキストだけが、整文のためにAnthropic（Claude）に送られます（学習には使われません）
- 変換履歴はPCの中だけに保存されます（Mac：`~/Library/Application Support/こえノート/`／Windows：`%APPDATA%\こえノート\`）

## 使いこなし

- **メニュー（Mac：メニューバー／Windows：タスクトレイ）**から、整文モデルの切り替え（はやい/じっくり）、トーン切り替え（自動/話し言葉/ですます）、履歴のコピーができます
- **辞書が勝手に育ちます**：よく使う言葉や固有名詞を覚えて、誤変換がどんどん減ります。「設定フォルダを開く」→「辞書.md」で自分で編集もできます
- **整文のクセも変えられます**：「整文ルール.md」がAIへの指示書そのものなので、好みに書き換えられます

## うまくいかないとき

**共通**
- **「今月のAPI代」が増えない/整文されない** → APIクレジットの残高切れの可能性。コンソールで残高を確認してください

**Mac**
- **キーを押しても反応しない** → メニューバーのアイコンをクリックして⚠️表示がないか確認。アクセシビリティ許可のオン/オフを一度切り替えると直ることがあります
- **文字が入らずクリップボードに入る** → 同上（アクセシビリティ許可）

**Windows**
- **「PCが保護されました」画面が消せない** → 「詳細情報」を押すと「実行」ボタンが出ます
- **キーを押しても反応しない** → タスクトレイのアイコンをダブルクリックして、Claude Codeが起動しているか、辞書ファイルが壊れていないか確認してください
- **Claude Codeのサブスクモードで整文されない** → コマンドプロンプトで `claude --version` を実行し、Claude Code CLIがPATHに通っているか確認してください
- **音が録音できない** → Windowsの「設定→プライバシー→マイク」で、デスクトップアプリからのマイクアクセスが許可されているか確認してください

---
制作：マナミ（このツールは試用版です。感想・不具合報告をぜひ聞かせてください）

## 【Windows版を試してくれる方へ】既知の未検証事項

Windows版はMac版をもとに作られていますが、**Windows実機での動作確認がまだ済んでいません**。特に次の点を確認いただけると助かります：

1. 起動してタスクトレイにアイコンが出るか
2. 右Ctrl／左Ctrlキーの単独タップがちゃんと検知されるか（他のショートカットと干渉しないか）
3. 録音→変換→カーソル位置への文字入力が実際に動くか（メモ帳やブラウザで）
4. Claude Codeサブスクモード（`claude`コマンド呼び出し）がちゃんと動くか
5. Windows Defenderが誤検知でブロックしてこないか

## トライアル版と製品版

このアプリは1本で、はじめは「トライアル版」として動きます。
- トライアル版：音声入力を合計30回まで試せます。整文（文章を整える機能）はGemini無料枠だけ使えます
- 製品版：設定画面の「はじめに」で、購入者にお渡しする合言葉（またはMY TOOL BOXの「BOXの鍵」）を入力すると切り替わります。回数の制限がなくなり、Claude API・Claude Codeサブスク流用の整文も使えます

合言葉とBOXの鍵は、MY TOOL BOX（Brain）の購入者エリアでお渡ししています。
