Claude Desktop：Cowork・Code 接続障害
BetterToken を Gateway として接続した後に起きる Claude Desktop Cowork の失敗と Code モードのエラーを解決します。
Claude Desktop で BetterToken Gateway を設定した後、次の症状は通常、API Key 自体が無効であることを意味しません。
- Cowork モードが動作しない
- Code モードに
Claude Code process exited with code 1と表示される - 同じ API Key がターミナルの Claude Code CLI では動作する
Gateway をまだ設定していない場合は、Claude Desktop で BetterToken API を使用するから始めてください。
まず Cowork モードを解決する
Claude Desktop で使用できるのは Claude モデルのみです。これは Claude Desktop クライアントの制限です。
API Key が正しくコピーされ、有効期限内であることを確認します。この Gateway 設定には x-api-key を使用し、保存して Claude Desktop を再起動してください。
Claude Desktop ガイドに従い、Gateway、Base URL https://bettertoken.ai、BetterToken API Key、Gateway auth scheme x-api-key を設定します。Apply locally で保存し、Claude Desktop を完全に再起動してください。
次に Code モードの終了エラーを解決する
Cowork は動作する一方で Code モードの </> タブに Claude Code process exited with code 1 と表示され続ける場合は、Claude Desktop が古いバンドル版 Claude Code を使用していないか確認してください。
原因：Claude Desktop が新しい Claude Code バージョンをバックグラウンドでダウンロードしている場合があります。ダウンロードが完了する前は、Code モードがインストール済みの古い Claude Code バージョンにフォールバックすることがあります。古いバージョンは Code モードでのサードパーティ Gateway 使用と互換性がない場合があり、プロセスが直ちに終了します。
解決方法：
新しい Claude Code バージョンのダウンロード完了を待つ
バックグラウンドの Claude Code 更新が完了するよう、しばらく Claude Desktop を開いたままにします。
Claude Desktop を完全に終了する
Cmd+Q を使用してアプリを完全に終了します。ウィンドウを閉じるだけでは不十分です。
再度開いて新しい Code セッションを開始する
Claude Desktop をもう一度開き、Code モードに移動して新しいセッションを開始します。
クイックリファレンス
| 症状 | よくある原因 | 解決方法 |
|---|---|---|
| Cowork | Gateway auth scheme | API Key が正しくコピーされ、有効期限内であることを確認します。この Gateway 設定には x-api-key を使用し、保存して Claude Desktop を再起動してください。 |
Code モードに Claude Code process exited with code 1 と表示される | Claude Desktop が古い Claude Code バージョンへフォールバックしている | 新しいバージョンのダウンロード完了を待ち、Cmd+Q で完全に終了してから再度開く |
