Claude Desktop: Cowork·Code 오류
BetterToken을 Gateway로 연결한 후 발생하는 Claude Desktop Cowork failures와 Code mode errors를 해결하세요.
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에서는 작동함
아직 Gateway를 구성하지 않았다면 Claude Desktop에서 BetterToken API 사용부터 시작하세요.
먼저 Cowork mode 해결
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 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가 즉시 종료됩니다.
해결 방법:
새로운 Claude Code version download 완료 대기
background Claude Code update가 완료되도록 Claude Desktop을 잠시 열어 두세요.
Claude Desktop 완전 종료
Cmd+Q로 app을 완전히 종료하세요. window만 닫지 마세요.
다시 열고 새 Code session 시작
Claude Desktop을 다시 연 다음 Code mode로 가서 새 session을 시작하세요.
빠른 참고
| 증상 | 일반적인 root cause | 해결 방법 |
|---|---|---|
| Cowork | Gateway auth scheme | API Key가 정확히 복사되었고 만료되지 않았는지 확인하세요. 이 Gateway 설정에는 x-api-key를 사용하고 저장한 뒤 Claude Desktop을 다시 시작하세요. |
Code mode에 Claude Code process exited with code 1이 표시됨 | Claude Desktop이 이전 Claude Code version으로 fall back함 | 새로운 version의 download가 끝날 때까지 기다리고 Cmd+Q로 완전 종료한 다음 다시 열기 |
