Claude Code v2.1.154 업데이트 후 타사 API 호환성 문제 해결법

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code v2.1.154에서 추가된 'mid-conversation-system' 기능이 OpenAI 호환 API와 충돌하여 발생하는 400 에러 해결법을 공유한다.

배경

작성자가 Claude Code v2.1.154 업데이트 후 DeepSeek 등 OpenAI 호환 API를 사용하는 환경에서 400 에러가 발생하는 문제를 겪고, 원인 분석과 해결책을 커뮤니티에 공유했다.

의미 / 영향

AI 도구의 업데이트가 타사 API와의 호환성을 깨뜨릴 수 있음을 보여준다. 개발 환경에서는 자동 업데이트를 제어하고, 설정 파일을 통해 기능을 세밀하게 조정하는 것이 중요하다.

커뮤니티 반응

많은 사용자가 동일한 문제를 겪고 있으며, 작성자의 해결책(다운그레이드 및 설정 수정)이 실질적인 도움이 된다는 반응이다.

주요 논점

01중립다수

Claude Code의 새로운 기능이 Anthropic API에는 적합하지만 타사 API와는 호환성 문제가 발생하므로, 환경에 맞는 설정이 필요하다.

합의점 vs 논쟁점

합의점

v2.1.154 버전의 메시지 구조 변경이 타사 API와의 호환성 문제를 야기했다.
v2.1.153으로 다운그레이드하면 문제가 즉시 해결된다.

실용적 조언

Claude Code v2.1.154에서 타사 API 연동 오류 발생 시 v2.1.153으로 다운그레이드할 것.
자동 업데이트를 비활성화하여 예기치 않은 버전 변경을 방지할 것.
설정 파일에서 `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`를 수정하여 호환성을 맞출 것.

섹션별 상세

Claude Code v2.1.154 업데이트 이후 DeepSeek 등 OpenAI 호환 API를 사용하는 환경에서 400 에러가 발생한다. 에러 메시지는 'Failed to deserialize the JSON body messages[1].role: unknown variant system'으로, 메시지 배열 중간에 시스템 역할이 포함되어 발생하는 문제이다.

bash

npm i -g @anthropic-ai/claude-code@2.1.153

문제가 발생한 최신 버전을 이전 버전으로 다운그레이드하는 명령어

json

"env": { "ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES": "thinking,adaptive_thinking,text_editor" }

~/.claude/settings.json 파일에 추가하여 mid-conversation-system 기능을 비활성화하는 설정

원인은 Anthropic의 새로운 기능인 'mid-conversation-system'이 대화 중간에 `role: "system"`을 삽입하는 방식 때문이다. 대부분의 OpenAI 호환 API는 대화 시작 시점에만 시스템 프롬프트를 허용하거나, 대화 중간에 시스템 역할을 삽입하는 구조를 지원하지 않아 요청을 거부한다.

가장 빠른 해결책은 이전 버전인 v2.1.153으로 다운그레이드하고 자동 업데이트를 끄는 것이다. `npm i -g @anthropic-ai/claude-code@2.1.153` 명령어로 설치할 수 있으며, 이를 통해 기존 API 연동을 정상화할 수 있다.

다른 방법으로는 `~/.claude/settings.json` 파일의 `env` 설정에서 `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` 값을 수정하는 것이다. `mid-conversation-system` 기능을 제외하고 설정하면 Claude Code가 메시지 중간에 시스템 역할을 삽입하지 않아 호환성 문제가 해결된다.

실무 Takeaway

Claude Code v2.1.154 이후 버전에서 타사 API 연동 시 400 에러가 발생하면, 해당 버전의 'mid-conversation-system' 기능이 원인일 가능성이 높다.
API 호환성 문제가 해결될 때까지 v2.1.153으로 다운그레이드하고 자동 업데이트를 비활성화하여 안정성을 확보할 수 있다.
설정 파일(`~/.claude/settings.json`)을 수정하여 특정 기능을 비활성화함으로써, 최신 버전을 유지하면서도 API 호환성 문제를 회피할 수 있다.

언급된 도구

Claude Code중립

AI 코딩 에이전트

DeepSeek중립

OpenAI 호환 API 제공 모델