error: option '--permission-mode <mode>' argument '<value>' is invalid

⚠️ 標準エラーに出て、終了コードは 1 です。 認証より前に弾かれるため、鍵の設定とは無関係です。

--permission-mode に渡した値が、用意されている名前のどれとも一致していません。

⭐ 正しい名前はメッセージ自体に全部書いてあります。

🔴 大文字小文字は区別されます

v2.1.238 で実測した結果です。綴りが合っていても、大文字小文字が違うと弾かれます。

⚠️ ask は最もよくある間違いです。 「たずねる」モードの名前は manual です。

1. 名前をそのまま写す

メッセージの Allowed choices are の後ろが、その版で使える名前の全てです。 版によって増減するので、記事や記憶ではなくメッセージを見てください。

claude --permission-mode acceptEdits -p "..."

Windows（PowerShell）

claude --permission-mode acceptEdits -p "..."

2. 使える名前をその場で確認する

claude --permission-mode "" -p "x" 2>&1 | head -1

⭐ わざと不正な値を渡すと、その版で使える名前が一覧で出ます。 覚えておく必要はありません。

Windows（PowerShell）

claude --permission-mode "" -p "x" 2>&1 | Select-Object -First 1

3. 毎回指定したくない場合は設定に書く

settings.json の permissions.defaultMode に書けば、起動のたびに渡す必要がなくなります。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

⚠️ 設定ファイルの JSON が壊れていると、警告なしに丸ごと捨てられます。 書いたのに効かない場合は、まず JSON として妥当かを確認してください。

Windows（PowerShell）

Get-Content "$env:USERPROFILE\.claude\settings.json" -Raw -Encoding utf8 | ConvertFrom-Json | Out-Null

macOS / Linux

python3 -c "import json,sys;json.load(open(sys.argv[1]))" ~/.claude/settings.json && echo OK

• 名前を記憶で書かない。 メッセージに出る一覧をその場で見る
• ask は存在しない。都度たずねるのは manual
• CI で使う値は、1回手元で通してから入れる。認証より前に弾かれるので、鍵が無くても検証できる
• 毎回同じ値を渡しているなら settings.json の permissions.defaultMode に移す