claude は、認証情報が無くても有効にできる相手にする

枠を取るには登録を空にする必要があるのに、claude は「認証情報が無いと有効に
できない」相手として定義されていた。案内どおり登録を削除すると、そこで二度と
有効にできなくなる —— 手順そのものが成立していなかった。

登録は任意にする。空ならコンテナの中でサインインした結果を CLI が自分で使い、
入っていればそちらを環境変数で置く。止める条件は「接続を試す」が通っていない
ことだけになる。

設定の案内を二択に書き直す。枠まで見たいならサインインして登録しない、
会話だけでよいならトークンを登録する(そのトークンでは枠は出ない)。
失敗したときの文面にも戻し方の順番を入れる —— 削除すると無効になるので、
削除・接続を試す・有効にする、の順で戻すことになる。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: claude

app/providers.py

@@ -147,11 +147,25 @@ class Provider:
         id="claude",
         label="Claude Code CLI",
         url="http://chiezo-bridge-claude:7013/v1",
-        credential=CRED_REQUIRED,
+        # **無くても動く。** 登録が空なら、コンテナの中でサインインした結果を CLI が
+        # 自分で使う（`bridge/cli_bridge.py` の `apply_credential`）。
+        # **required にしてはいけない** —— 枠を取るには登録を空にする必要があるのに、
+        # 空にすると二度と有効にできなくなる（実際に詰んだ）。
+        credential=CRED_OPTIONAL,
         billing="Claude のサブスクリプション（定額）",
         model_required=False,
-        setup="ブリッジのコンテナ **chiezo-bridge-claude** を立ててから、手元の端末で\n"
+        setup="ブリッジのコンテナ **chiezo-bridge-claude** を立ててから、"
+        "**どちらか一方**を選んでください。\n"
+        "\n"
+        "**枠（使用量）まで見たいなら、コンテナの中でサインインします。**\n"
+        "ここは**登録しないまま**にしてください ——\n"
+        "`docker exec -it chiezo-bridge-claude claude` を実行して `/login`。\n"
+        "**登録があるとそちらが優先される**ので、登録したままサインインしても枠は出ません。\n"
+        "サインイン結果を残すため、`/srv/bridge/home` を名前付きボリュームにしておくこと。\n"
+        "\n"
+        "**会話だけでよいなら、トークンを登録します。** 手元の端末で\n"
         "`claude setup-token` を実行し、発行されたトークンをここに登録してください。\n"
+        "この長期トークンは推論だけに絞られているので、**枠は出せません**。\n"
         "\n"
         "**コンテナ名はこのとおりにすること**（Chiezo はこの名前で呼びに行きます）。\n"
         "compose があるなら docker-compose.yml の該当サービスのコメントを外すだけです。\n"

bridge/cli_bridge.py

@@ -1760,9 +1760,10 @@ def _usage_reason(raw: str) -> str:
         # 壊れているのか、そもそも出せない頼み方をしているのかが読めない。
         return ("枠のパネルではなく、会話を始めずに終わった締めの集計が返っています。"
                 "登録してある `claude setup-token` の長期トークンは推論だけに"
-                "絞られていて、枠を出せません —— コンテナの中で 1 回サインインし"
+                "絞られていて、枠を出せません。コンテナの中でサインインし"
                 "(`docker exec -it <ブリッジのコンテナ> claude` で `/login`)、"
-                "管理画面の登録を空にしてください。")
+                "管理画面で登録を「削除」してください —— 削除すると無効になるので、"
+                "そのあと「接続を試す」→「有効にする」の順に戻します。")
     return text[:REASON_MAX]
 
 

docs/ai.md

@@ -838,15 +838,21 @@ Current week (Fable): 0% used · resets Sep 20, 6am (UTC)
 **枠まで欲しいときは、コンテナの中で 1 回サインインします。**
 
 ```bash
-# 管理画面（/admin/ai）で claude の登録を空にしてから
 docker exec -it chiezo-bridge-claude claude      # /login
 ```
 
+そのうえで管理画面（`/admin/ai`）の claude の行で **登録を「削除」** します。
+**削除すると無効になる**ので、**「接続を試す」→「有効にする」の順**に戻してください
+（`claude auth status` がコンテナのサインインを見るので通ります）。
+
 登録が空のときだけ、ブリッジは CLI 自身のサインイン結果に任せます（Antigravity と
 同じ形）。登録があるとそちらを環境変数で置くので、**登録したままサインインしても
 枠は出ません**。**`/srv/bridge/home` を名前付きボリュームにしておいてください**——
 無いと、コンテナを作り直すたびにサインインが消えます。
 
+**claude は「認証情報が無くても有効にできる」相手です**（`CRED_OPTIONAL`）。
+required にすると、枠を取るために登録を空にした瞬間、二度と有効にできなくなります。
+
 会話のほうはどちらでも動きます。枠が要るかどうかで選んでください。
 
 **「取れない」と書いてある理由は、疑ってから消してください** ——あのときも口が

tests/test_ai_usage.py

@@ -982,3 +982,28 @@ def test_windows_without_a_length_keep_their_place_at_the_end(self, env):
         assert [w.label for w in usage.ordered([first, second, short])] == [
             "5 時間", "session", "week",
         ]
+
+
+class TestClaudeDoesNotNeedARegisteredToken:
+    """登録が無くても有効にできる。**required にすると詰む** —— 枠を取るには
+    登録を空にする必要があるのに、空にすると二度と有効にできなくなる。
+    """
+
+    def test_a_registered_token_is_optional(self, env):
+        from app import providers
+
+        spec = providers.get("claude")
+
+        assert spec.credential == providers.CRED_OPTIONAL
+
+    def test_it_can_be_enabled_without_one(self, env):
+        """止めているのは「接続を試す」が通っていないことだけであってほしい。"""
+        from app import settings_store
+        from app.views import ai_settings
+
+        with make_client(env, ReplyLLM()):
+            settings_store.set_verified("claude", True)
+            row = next(r for r in ai_settings._rows() if r["spec"].id == "claude")
+
+        assert row["has_credential"] is False
+        assert row["can_enable"] is True