> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> SoloEnt に関するよくある質問への短い回答

よくある質問を画像付きでまとめています。必要なところまでスクロールしてご覧ください。一覧に該当する項目がない場合は、本ハンドブック内の対応する機能ページの詳細をご確認ください。

<Note>
  **それでも解決しない場合は** [team@soloent.ai](mailto:team@soloent.ai) までメールでご連絡いただき、以下の情報をお知らせください：

  1. ログインに使っているアカウント（メールアドレス）
  2. お使いのクライアントのバージョン
  3. 詳細な再現手順
  4. 関連する画面のスクリーンショット
</Note>

## ログイン時にリダイレクトのポップアップが出ない

認証成功後、ブラウザーが SoloEnt を開くか確認したり、ページに代替ボタンが表示されたりします：

* ダイアログで **Open SoloEnt** を選び、デスクトップアプリの起動を許可する
* ダイアログが出ない場合は、ページの **Click here to open SoloEnt** をクリック

<img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/login_1.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=3179e044022b5450574d352472e67303" alt="認証成功ページ：ブラウザーの起動確認と Click here to open SoloEnt の代替ボタン" style={{ width: '70%', maxWidth: '560px', display: 'block' }} width="1180" height="1970" data-path="assets/images/login_1.png" />

反応がない場合はポップアップがブロックされている可能性があります。Chrome の例：**設定 → プライバシーとセキュリティ → サイトの設定**（位置情報・カメラ・**ポップアップ**など）で、`account.soloent.ai` にポップアップとリダイレクトを許可します。

<img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/login_2.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=00d4cd24dcd0c9c8621c7743cedd3a14" alt="Chrome 設定：プライバシーとセキュリティとサイトの設定への導線" style={{ width: '70%', maxWidth: '560px', display: 'block' }} width="828" height="438" data-path="assets/images/login_2.png" />

**サイトの設定**の **ポップアップとリダイレクト**で SoloEnt 関連を許可し、ログインをやり直してください。

## サブスクリプションの入口が見つからない

サブスクリプションダッシュボードへの経路は2つあります：

* **方法1**：アカウントアバター → **Dashboard** → [account.soloent.ai/en/dashboard](https://account.soloent.ai/en/dashboard/)

<img src="https://mintcdn.com/soloent/2KTENKv9UFaCgQsj/assets/images/payment1.png?fit=max&auto=format&n=2KTENKv9UFaCgQsj&q=85&s=5faaf80d30686494481b01b742240dd6" alt="アカウントアバターのメニューから Dashboard を選択" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="1334" height="966" data-path="assets/images/payment1.png" />

* **方法2**（v0.3.5 以降）：アプリ内 **設定**（歯車）→ **API Configuration** → 無料モデル一覧の下の **Upgrade subscription**

<img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/apikey_2.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=675b83f90db7141057865610c7d4c9d6" alt="API Configuration と無料モデル一覧下の Upgrade subscription" style={{ width: '70%', maxWidth: '560px', display: 'block' }} width="502" height="774" data-path="assets/images/apikey_2.png" />

Web コンソールで **Subscription Plan** タブを開き、Lite / Pro / Max と月払い・年払いを選びます。

<img src="https://mintcdn.com/soloent/2KTENKv9UFaCgQsj/assets/images/payment2.png?fit=max&auto=format&n=2KTENKv9UFaCgQsj&q=85&s=9a69b496c7787844ef48c420bd9fe147" alt="ダッシュボードの Subscription Plan でプランと請求サイクルを選択" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="3038" height="1812" data-path="assets/images/payment2.png" />

## サブスクは解約・返金できる？権益が尽きたら？

ダッシュボードで有効プランに **Cancel subscription** が表示されます。確認すると解約されます。

* **当期の返金はありません**。権益は請求期間の終わりまで有効で、自動更新は止まります
* 枠を使い切った場合は上位プランへのアップグレード、または**追加クレジットの個別購入**が可能です（サブスクリプション未加入の場合は購入できません）

追加クレジットは当月の請求サイクルのみ有効で、**翌月へは繰り越されません**。更新やプラン変更時にリセットされます。

詳しくは [サブスクリプションの管理](/ja/subscription/manage-subscription) と [支払いを完了](/ja/subscription/make-the-payment)。

<img src="https://mintcdn.com/soloent/2KTENKv9UFaCgQsj/assets/images/payment6.png?fit=max&auto=format&n=2KTENKv9UFaCgQsj&q=85&s=425dd745b7a192ffaed08889a702ed41" alt="Web コンソールの Cancel subscription 画面" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="2340" height="1618" data-path="assets/images/payment6.png" />

## サードパーティの API キーはどう設定する

多くのプロバイダーは **OpenAI Compatible** です。設定の **API Provider** から選びます。

次の3つはすべて必須です：

* **Base URL**
* **API Key**
* **Model ID**

動かないときはまずこの3つを確認してください。購入前にプロバイダーへ確認を。

詳しくは [API 設定](/ja/quickstart/api-configuration)。

<img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/apikey_7.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=11322309fbc78d52a8c22359de78d50f" alt="API Provider で OpenAI Compatible を選択する画面" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="844" height="652" data-path="assets/images/apikey_7.png" />

## Agentパネルが希望の言語で表示されない

**v0.3.8** 以降、Agentパネルには2つの独立した言語設定があります。まず最新バージョンに更新してから、Agentパネル右上の設定アイコンをクリックし、一般設定から以下を設定できます：

* **Preferred Language**：AIが返信する際に使用する言語を制御します
* **Interface Language**：Agentパネル UI（メニュー、ボタンなど）の表示言語を制御します。English、简体中文、日本語、한국어、Españolに対応

メインのインターフェース言語を切り替えても右側のAgentパネルがまだ英語で表示される場合は、**Interface Language** が切り替わっているか確認してください。[言語設定](/ja/quickstart/language-settings) を参照。

## Agent がファイルを作らない / 保存しない / 毎回保存を求められる

次の2点を確認してください。

**1. 自動承認**\
**Agent 設定 → 自動承認**（相当）で、**Edit** によるプロジェクトファイル書き込みが許可されているか。オンなら直接書き込み可能、オフなら毎回確認が必要なことが多いです。 [自動承認](/ja/quickstart/auto-approve) を参照。

<img src="https://mintcdn.com/soloent/5L9WxA69eDjQqPG_/assets/images/approve.png?fit=max&auto=format&n=5L9WxA69eDjQqPG_&q=85&s=ffcde2026b31154d683a3884b093b7c3" alt="自動承認：プロジェクトファイルの読み取り・編集などのトグル" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="908" height="976" data-path="assets/images/approve.png" />

**2. Background Edit**\
**設定 → Feature Settings**（左の二重チェックアイコン）の **EDITOR** にある **Background Edit** は、**エディタのフォーカスを奪わず**にバックグラウンド編集を許可するかどうかです。自分で必ず内容を確認したい場合はオフにできます。

<img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/bgedit.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=ca8d1b3200cbea206397624274118d56" alt="Feature Settings の Editor セクションの Background Edit" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="632" height="1146" data-path="assets/images/bgedit.png" />

## Git のインストール（チェックポイント）

Windows ユーザーが SoloEnt を初めて起動したときに、このプロンプトが表示されることがあります。Git がインストールされていないことを示していますが、**通常の使用には影響しません**。

Git は会話中にチェックポイントを保存し、特定の状態に戻って再開できるようにするためのものです。Mac にはほとんどの場合 Git がプリインストールされていますが、Windows では手動インストールが必要です。チェックポイントの巻き戻しが不要であれば、このまま無視しても構いません。使いたい場合は [git-scm.com](https://git-scm.com) からインストールしてください。

<img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/git.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=631eb373319b9c565e890c683b609306" alt="SoloEnt パネルの Git / checkpoints に関するバナー" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="486" height="250" data-path="assets/images/git.png" />

## コンテキストウィンドウとは？新しいセッションを開くべきタイミングは？

各セッションにはコンテキスト長の上限があります。チャット上部のバーで使用量を確認できます——例えば **38.5k / 128.0k** は、上限128kに対して38.5kトークンを使用済みであることを示します。

<img src="https://mintcdn.com/soloent/Ec_zc8mkbXUI3ki4/assets/images/context.png?fit=max&auto=format&n=Ec_zc8mkbXUI3ki4&q=85&s=51fa48077dbe3fe4763f6a8fd9ebca94" alt="SoloEntチャット上部のコンテキスト進捗バー。38.5k使用、上限128.0k" style={{ width: '70%', maxWidth: '520px', display: 'block' }} width="850" height="344" data-path="assets/images/context.png" />

コンテキストの消費が多くなると、モデルが過去の内容を正確に把握できなくなり、長いタスクでは方向性を失いやすくなります。以下の場合に新しいセッションを開くことをお勧めします：

* 現在のタスクが完了し、新しい独立したタスクを始めるとき
* コンテキスト使用量が60〜70%程度になり、モデルが「忘れている」と感じるとき
* まったく別のトピックに切り替えるとき

**長編執筆の推奨方法**：プロジェクトで `/init` を使って `SOLOENT.md` を生成し、キャラクター・アウトライン・現在の進捗などの重要な情報を書き込んでおきましょう。新しいセッションを開くたびに、モデルは `SOLOENT.md` を読むことでプロジェクト全体を把握できるため、単一セッションのコンテキストに依存する必要がなくなります。適切に新しいセッションを開くことは、むしろモデルの集中力と実行力の維持に役立ちます。

詳しくは [SOLOENT.md ガイド](/ja/tips/SoloEnt)。

## なぜプロジェクトで SOLOENT.md が自動生成されなくなった

**v0.2.0** 以降、`SOLOENT.md` は**自動では作られません**。プロジェクトのどの段階でも `/init` で手動作成できます。セッションをまたいだコンテキストが不要な短い作品なら使わなくても構いません。
