- Cowork モードが動作しない
- Code モードに
Claude Code process exited with code 1と表示される - 同じ API Key がターミナルの Claude Code CLI では動作する
まず Cowork モードを解決する
原因:Gateway auth scheme がプロバイダーと一致していません。 Claude Desktop の Gateway 設定で、プロバイダーに応じた認証方式を選択します。- BetterToken API Key が有効な場合は、Gateway auth scheme を
x-api-keyに設定する - BetterToken API Key が有効な場合は、Gateway auth scheme を
bearerに設定する
1
サードパーティ推論設定を開く
macOS のメニューバーで Developer → Configure Third-Party Inference… を選択します。
2
認証方式を変更する
プロバイダーに応じて Gateway auth scheme を選択します。Claude プロバイダーには
x-api-key、GPT プロバイダーには bearer を使用します。3
設定を保存する
Apply locally をクリックしてローカル Gateway 設定を保存します。
次に Code モードの終了エラーを解決する
Cowork は動作する一方で Code モードの</> タブに Claude Code process exited with code 1 と表示され続ける場合は、Claude Desktop が古いバンドル版 Claude Code を使用していないか確認してください。
原因:Claude Desktop が新しい Claude Code バージョンをバックグラウンドでダウンロードしている場合があります。ダウンロードが完了する前は、Code モードがインストール済みの古い Claude Code バージョンにフォールバックすることがあります。古いバージョンは Code モードでのサードパーティ Gateway 使用と互換性がない場合があり、プロセスが直ちに終了します。
解決方法:
1
新しい Claude Code バージョンのダウンロード完了を待つ
バックグラウンドの Claude Code 更新が完了するよう、しばらく Claude Desktop を開いたままにします。
2
Claude Desktop を完全に終了する
Cmd+Q を使用してアプリを完全に終了します。ウィンドウを閉じるだけでは不十分です。
3
再度開いて新しい Code セッションを開始する
Claude Desktop をもう一度開き、Code モードに移動して新しいセッションを開始します。
ログに、Claude Desktop が古い Claude Code バージョン(例:
2.1.111)へフォールバックし、より新しいバージョン(例:2.1.119)の準備ができていないことが示される場合は、新しいバージョンのダウンロード完了を待ってからアプリを再起動してください。
