Soma Agent 使い方ガイド｜インストール・ライセンス認証・各機能

これは何

Soma は「チャット欄の中の AI」ではなく、デスクトップに浮かんでいて、目に見えて、行動できる相棒です。

姿がある：VRM／Live2D のキャラクターが透明でデスクトップに浮かび、常に手前に表示され、口も表情も動きます。
声がある：文ごとにストリーミング再生され、口の動きと同期します。
記憶がある：キャラクターごとに、あなたとの会話の要点を覚えています。
手がある（アドバンス版）：ウェブを開く、ファイルを整理する、音楽を操作する——会話の外で実際のデスクトップを動かします。

はじめかた

インストールから最初のひとことまで、4 ステップです。

Soma Agent を「アプリケーション」にドラッグしてから開いてください（dmg から直接開くと後で見つからなくなります）。
インターフェースの言語を選びます。後から変更でき、キャラクターが話す言語とは別です。
⚙ 設定 → ライセンスでメールアドレスを入れて 7 日間トライアルを開始するか、購入したシリアルを貼り付けます。
⚙ 設定 → AI モデルで API キーを貼り付け（または Ollama を選んで無料のローカルモデルを使い）、会話を始めましょう。

Soma はあえて Dock に表示されません——デスクトップの半透明のキャラクターがアプリ本体です。見失ったら Spotlight で「Soma」を検索してください。

AI モデルとキー

Soma は AI の利用枠を再販していません。あなた自身の API キーで直接プロバイダーにつなぎ、使った分だけそちらに支払います。会話が私たちのサーバーを通ることはありません。これが BYOK です。

Anthropic（Claude）: console.anthropic.com｜デスクトップ操作・画像・PDF に対応する唯一の選択肢
OpenAI（GPT）: platform.openai.com｜会話のみ
Google Gemini: aistudio.google.com｜会話のみ
Ollama（ローカル）: ollama.com｜無料・データが外に出ない・会話のみ

キーはこの Mac の secrets.json（パーミッション 600）にだけ保存され、Rust 側からしか読めません——ウェブ層にも私たちのところにも届きません。

費用はモデル次第です。Haiku が最も安く、雑談 1 通で 1 円未満。Opus や毎回大きな添付を使うと目に見えて増えます。完全無料にしたいなら Ollama を。

ライセンスとトライアル

⚙ 設定 → ライセンスでメールアドレスを入れると 7 日間の無料トライアルが始まります（支払い情報は不要）。シリアルもメールで届くので、機種変更のために保管してください。トライアルはベーシック版の機能です。

トライアルが終わってもキャラクター・設定・記憶はすべて残ります。メッセージが送れなくなるだけです。購入してシリアルを貼れば、続きから使えます。

買い切り、月額なし：ベーシック NT$599、アドバンス NT$899（キャラクター 2 体とデスクトップ操作が追加）、Podcast 2キャラ会話の追加購入 NT$399。

ベーシックは 1 台、アドバンスは 2 台まで。移行するときは先に古い Mac で「解除」してから、新しい Mac に同じシリアルを貼ってください。

購入とライセンス認証

公式サイト soma-agent.com でプランを選び、Paddle で決済します（クレジットカード・主要ウォレット対応）。買い切り型で月額はありません。

サイトの「プラン」でベーシックまたはアドバンスを選択。2 キャラクターの会話が必要なら Podcast を追加購入します。
Paddle の決済画面で支払いを完了します。メールアドレスは必ず受信できるものを入力してください。
ライセンスキーがそのアドレスに届きます（通常は数分以内）。
Soma Agent を起動し、⚙ 設定 → ライセンスにキーを貼り付けて「認証」を押します。

キーが届かないときは、まず迷惑メールフォルダを確認し、次にサイトの「キーの再送」ページで同じアドレスを入力してください。それでも届かない場合は soma-agent.com">support@soma-agent.com までご連絡ください。

サイトの「マイアカウント」ではメールでログインリンクを受け取れます（パスワード不要）。所有ライセンス、認証済み端末の確認、古い PC の認証解除ができます。

Podcast の追加購入は、決済時に既存のライセンスキーを入力すると同じライセンスに紐づきます。返金はサイトの返金ポリシーに従います。

キャラクター・記憶・言語

⚙ 設定 → キャラクターで切り替えや追加ができます。それぞれが人格・記憶・見た目を完全に別々に持っています。

言語と声はキャラクターごとの設定で、いつでも変更できます——どのキャラクターでもどの言語でも話せます。応答言語は ⚙ 設定 → キャラクター、声は → 音声で変更します。

キャラクターは話した内容を覚えていて、少しずつ長期記憶にまとめます。キャラクター設定から確認・削除できます。

Podcast を追加購入すると、入力欄の上の二人アイコンから、2 体で会話させたり（あなたは観るだけ）、自分も加わったりできます。

音声

⚙ 設定 → 音声で Azure Speech のキーとリージョンを入れると声が出ます。未設定のときはシステムの音声で代替します。

音声入力：右の Option キーを押しながら話し、離すと送信されます。macOS の「入力監視」の許可が必要で、ホットキーは変更できます。

自分のモデルを読み込む

⚙ 設定 → 外見 → モデルをインポート。.vrm と Live2D（フォルダまたは zip）に対応していて、自分で読み込んだモデルはプランの制限を受けません。

Live2D のテクスチャは RGBA PNG である必要があります。インデックスカラーの PNG だとキャラクターが「準備中…」で止まります。

トラブルシューティング

Dock にアイコンがない: 正常です。あえて Dock に出していません。デスクトップのキャラクターがアプリ本体です。
キャラクターが「準備中…」で止まる: 多くはインポートしたテクスチャが RGBA PNG でないケースです。変換して入れ直してください。
添付が Claude 専用と言われる: 画像と PDF は Anthropic のモデルでのみ使えます。対話モデルを Claude に戻してください。
音が出ない: ⚙ 設定 → 音声の Azure キーとリージョンを確認し、システム音量がミュートでないかも見てください。
音声入力が反応しない: システム設定 → プライバシーとセキュリティ → 入力監視で Soma を許可してください。
ウェブ取得が空になる: ウェブ機能は Anthropic 専用で、完全な http(s) の URL が必要です。

対応環境とショートカット

現在は macOS のみ（Intel と Apple Silicon）。Windows 版は計画中、Mac App Store 版も準備しています。

音声入力（押しながら話す）: 右 Option（変更可）
メッセージ送信: Enter
キャラの回転／ズーム／リセット: 右ドラッグ／スクロール／ダブルクリック

使い方ガイド