Claude Desktop Cowork 또는 Code mode가 Gateway에서 실패하면 어떻게 하나요?

Claude Desktop에서 BetterToken Gateway를 구성한 후 다음 symptoms는 보통 API Key 자체가 invalid하다는 뜻이 아닙니다.

• Cowork mode가 작동하지 않음
• Code mode에 Claude Code process exited with code 1이 표시됨
• 같은 API Key가 terminal의 Claude Code CLI에서는 작동함

이 issues는 보통 두 가지 별도 causes에서 발생합니다. desktop Gateway auth scheme가 provider와 일치하지 않거나 Claude Desktop의 bundled Claude Code version update가 아직 완료되지 않았습니다. 아직 Gateway를 구성하지 않았다면 Claude Desktop에서 BetterToken API 사용부터 시작하세요.

​

먼저 Cowork mode 해결

Root cause: Gateway auth scheme가 provider와 일치하지 않습니다. Claude Desktop Gateway settings에서 provider에 따라 auth scheme를 선택하세요.

• BetterToken API Key가 valid하면 Gateway auth scheme를 x-api-key로 설정
• BetterToken API Key가 valid하면 Gateway auth scheme를 bearer로 설정

올바른 scheme를 선택하면 Claude Desktop이 해당 group의 available models를 자동으로 fetch합니다. auth scheme가 잘못되면 Cowork mode의 Gateway authentication이 실패할 수 있습니다. 이 변경 후 Cowork mode는 보통 다시 작동합니다.

​

다음으로 Code mode exit errors 해결

Cowork는 작동하지만 Code mode의 </> tab에 여전히 Claude Code process exited with code 1이 표시된다면 Claude Desktop이 아직 이전 bundled Claude Code version을 사용하는지 확인하세요. Root cause: Claude Desktop이 background에서 더 새로운 Claude Code version을 downloading 중일 수 있습니다. download가 끝나기 전에는 Code mode가 이전 installed Claude Code version으로 fall back할 수 있습니다. 이전 version은 Code mode의 third-party Gateway usage와 compatible하지 않을 수 있으므로 process가 즉시 종료됩니다. 해결 방법:

​

빠른 참고