최신 글문제 해결
시스템 지시를 깨지 않고 API 400 role 미지원 오류를 고치는 방법
role 미지원 오류는 실제 API가 받는 필드와 메시지 위치부터 맞춰야 합니다. Claude의 처음 지시는 최상위 system에, OpenAI의 지시는 해당 API가 지원하는 위치에 둡니다. 도구 호출 ID와 대화 기록을 보존한 뒤 지시 준수와 전체 작업까지 확인하세요.
9 분
실제 개발 판단을 위한 가이드
AI 모델·API 기술 가이드
AI 모델, API 통합, 개발 워크플로를 원문 출처와 재현 절차, 적용 경계로 정리해 빠르게 바뀌는 가격·할당량·기능·제한을 검증 가능한 판단으로 연결합니다.
- 1차 출처 우선
- 재현 절차와 실패 경계 제시
- 변동 정보에 검토 날짜 표시
- 글 424개
- 6개 언어
- 주제 12개
- 최근 업데이트 2026년 10월 6일
Claude Code
Claude Code API 설정: 키, settings.json, 모델, 게이트웨이 확인 순서
직접 API 키를 쓰려면 Claude Code를 실행할 터미널에 ANTHROPIC_API_KEY를 전달하고 대화형 승인 여부를 확인합니다. 설정이 적용되지 않으면 인증 방식, settings.json의 범위, 모델, 실행한 앱을 차례로 확인하세요.
10 분
Claude Code
Claude Code context, memory, MCP, Context7: 먼저 고장 난 레이어를 고치기
Claude Code가 규칙을 잊었을 때는 새 세션에서도 빠지는지 먼저 확인합니다. Context7 오류는 메모리를 늘리는 대신 설치 방식, 인증과 실제 문서 조회 결과를 차례로 점검해야 합니다.
8 분
Claude Code
Claude Code에서 OpenRouter와 DeepSeek 쓰기: 경로, 설정, 첫 오류 해결
OpenRouter 경유는 OpenRouter 키와 deepseek/deepseek-v4.1-flash를, DeepSeek 직접 연결은 DeepSeek 키와 deepseek-flash를 사용합니다. 두 경로의 설정, 모델 역할과 첫 오류 복구를 확인하세요.
9 분
Claude Code
Claude Code에서 top_p deprecated? 먼저 Opus 4.7 request contract부터 확인하세요
Claude Code에서 Opus 4.7의 top_p deprecated 오류가 나면 실제 모델과 연결 경로부터 확인하세요. 최종 요청의 샘플링 항목만 제거하고 메시지·도구·출력 제한은 보존한 뒤, 같은 경로에서 원래 작업이 완료되는지 확인해야 합니다.
7 분
Claude·Anthropic
Claude Sonnet 5.5 가격과 성능: Sonnet 5 대비 effort별 비용, 전환 방법
Claude Sonnet 5.5는 Sonnet 5와 단가가 같고 AA 기준 작업당 비용은 effort max에서만 51% 높습니다. thinking 끄기·강제 도구 호출은 400 오류를 냅니다.
14 분
Claude·Anthropic
Claude unable to authenticate 오류 해결: 로그아웃해도 될 때와 안 될 때
Temporarily unable to authenticate는 Anthropic 쪽 문제라 로그아웃하지 말고 기다립니다. Claude Code가 원인을 적은 오류일 때만 /login이 답입니다.
13 분
개발 도구·에이전트
Codex 토큰 교환 403 실패: 오류 문구별 로그인 복구 방법
Codex 로그인에서 403을 만나면 오류 끝부분부터 확인하세요. 국가·계정·정책 거부는 공식 확인으로, 콜백 실패는 기기 로그인이나 SSH 터널로 나누고, 복구 후 같은 호스트에서 실제 작업이 되는지 확인합니다.
9 분
모델 비교
Fable 5.5·Gemini 4·GPT-6.1 비교: 지금 쓸 수 있는 건 GPT-6.1 Sol뿐
2026년 10월 6일 기준 Claude Fable 5.5는 미발표, Gemini 4 Argon은 제한 공개, GPT-6.1 Astra는 출시 취소입니다. 지금 쓸 수 있는 건 Sol뿐입니다.
10 분
API 가이드
GPT-6.1 Sol 가격과 사용법: 모델 ID만 바꾸면 안 되는 이유
GPT-6.1 Sol은 GPT-6 Sol과 입출력 단가가 같고 캐시 입력만 절반입니다. 추론 강도 none과 Chat Completions 도구 호출이 빠져 모델 ID만 바꾸면 실패할 수 있습니다.
15 분
AI 이미지 생성
나노바나나 2.1 출시 현황: 구글 미발표, 플로우 노출 보고와 모델 비교
2026년 10월 6일 기준 구글은 나노바나나 2.1을 발표하지 않았고 모델 ID·가격도 없습니다. 플로우 노출·회수 보고뿐이라 지금 쓸 모델은 나노바나나 2·프로·GPT Image 2.5입니다.
12 분
AI 이미지 생성
Nano Banana 2 503 ‘Model is Overloaded’ 오류 해결: 재시도와 중단 기준
503 과부하 오류가 확인되면 지수 백오프와 지터를 적용하되, 시도 횟수와 총 대기 예산을 제한해야 합니다. 현재 Nano Banana 2 모델로 이미지를 생성하거나 편집하고, 이미지가 실제로 반환됐는지 확인하는 Python 예제를 제공합니다.
8 분
AI 이미지 생성
Nano Banana Pro에 `RESTRICTED by System Instructions`가 뜬다면 먼저 경로부터 확인하세요
Gemini 앱에서는 첫 이미지의 더보기에서 Pro로 다시 실행을 선택해야 합니다. 제한 문구가 뜨거나 이미지 대신 텍스트만 나오면 이용 조건과 실제 응답을 확인하고, 같은 Pro 경로에서 허용된 요청을 비교해 원인을 좁힙니다.
8 분
문제 해결
Nano Banana Pro에서 'Unsupported file URI type'이 뜨나? 먼저 Gemini 파일 경로부터 바로잡기
Gemini generateContent는 조건에 맞는 공개·서명 HTTPS URL을 받을 수 있습니다. Nano Banana Pro에서 파일 URI 오류가 나면 먼저 실제로 전송된 문자열과 요청 주소를 확인하고, URL·원본 바이트·업로드 URI 중 맞는 방식으로 이미지 입력을 고칩니다.
9 분
API 가이드
OpenAI API 연결 오류: APIConnectionError는 경로부터 확인하세요
APIConnectionError가 발생하면 키를 바꾸기 전에 같은 서버 프로세스의 연결 경로와 원래 예외를 확인하세요. DNS·인증서·프록시·엔드포인트에 맞는 수정과 Python·Node의 진단 설정, 같은 요청으로 복구를 확인하는 절차를 설명합니다.
10 분
API 가이드
OpenAI API quota exceeded 오류: 잔액·지출 한도 확인과 복구
OpenAI API에서 quota exceeded가 나오면 error.code부터 확인하세요. 크레딧 소진은 잔액을 추가하고, 강제 지출 상한은 권한 있는 담당자가 조정하며, 승인된 사용 한도는 증액 절차로 해결해야 합니다. 충전 후에도 같은 조직·프로젝트·모델의 요청이 성공해야 복구를 확인할 수 있습니다.
7 분
Claude·Anthropic
Claude API 529 overloaded_error 해결: 뜻과 SDK 재시도 설정
Claude API 529는 일시적인 서버 과부하입니다. Python SDK의 재시도 횟수와 요청 타임아웃을 설정하고, 앱의 전체 대기 시간·동시 요청 수를 관리한 뒤 같은 경로에서 복구를 확인하세요.
8 분
Claude·Anthropic
Claude API 500 api_error 해결: 재시도 설정과 요청 ID 확인
Claude API가 500 api_error를 반환하면 오류 응답과 요청 ID를 보존하고 SDK 재시도를 확인하세요. 제한된 백오프 후에도 실패할 때 작업 중단·연기와 지원 문의로 이어가는 절차를 안내합니다.
8 분
Claude Code
Claude Code API Error 500·529 해결: 끊긴 작업을 중복 없이 재개하기
Claude Code API Error 500은 장애 확인 후 1분 뒤 한 번 재시도합니다. 끊긴 작업은 완료된 일을 확인해 남은 단계만 잇고, 로그인 중이나 특정 대화만 실패하면 순서가 다릅니다.
14 분
Claude Code
Claude Code Hooks·Skills·슬래시 명령어 차이와 사용 예제
반복할 작업 절차는 스킬에 담고, 직접 시작하려면 /스킬이름으로 호출합니다. 특정 도구 실행 전후에 검사를 붙이려면 훅을 씁니다. 커스텀 명령어와 스킬의 통합부터 호출 제어, 권한의 범위, 작은 예제의 성공 판단까지 확인할 수 있습니다.
9 분
Claude Code
Claude Code Rate Limit Reached 해결: 사용량·컨텍스트·API 제한 구분하기
Claude Code의 Rate limit reached는 구독 한도, 서버 일시 제한, API 키 429, 1M 컨텍스트 권한 중 하나입니다. 원문으로 종류를 가리고 세션을 닫지 말고 이어가세요.
11 분
Claude Code
Claude Code 토큰 사용량 확인·감사: /usage와 5시간·주간 한도 계획
Claude Code 남은 사용량은 /usage의 5시간·주간 막대와 초기화 시각으로 확인합니다. 두 한도는 동시에 줄어드니 무거운 병렬 작업은 주간 잔량을 기준으로 배분하세요.
14 분
Claude·Anthropic
Claude Rate Exceeded 오류: 재시도 전에 제한 소유자부터 확인하기
Claude API Error: Rate limit reached가 곧 한도 소진은 아닙니다. 최신 Claude Code 메시지로 플랜, 1M 권한, API 키, 게이트웨이 중 막힌 곳을 찾으세요.
5 분
모델 비교
Gemini 4 Argon·Opus 5.5·GPT-6.1 Sol 비교: 작업당 비용 6배 차이
Gemini 4 Argon은 2026년 10월 1일 기준 제한 공개라 호출할 수 없습니다. 지금 쓸 수 있는 Opus 5.5와 GPT-6.1 Sol 중 과제당 비용은 Sol이 가장 낮습니다.
12 분