본문으로 건너뛰기
실제 개발 판단을 위한 가이드

AI 모델·API 기술 가이드

AI 모델, API 통합, 개발 워크플로를 원문 출처와 재현 절차, 적용 경계로 정리해 빠르게 바뀌는 가격·할당량·기능·제한을 검증 가능한 판단으로 연결합니다.
  • 1차 출처 우선
  • 재현 절차와 실패 경계 제시
  • 변동 정보에 검토 날짜 표시
  • 글 430개
  • 6개 언어
  • 주제 12개
  • 최근 업데이트 2026년 10월 7일

API별 지시 위치를 구분해 400 역할 오류를 수정하는 안내 그림
최신 글문제 해결

시스템 지시를 깨지 않고 API 400 role 미지원 오류를 고치는 방법

role 미지원 오류는 실제 API가 받는 필드와 메시지 위치부터 맞춰야 합니다. Claude의 처음 지시는 최상위 system에, OpenAI의 지시는 해당 API가 지원하는 위치에 둡니다. 도구 호출 ID와 대화 기록을 보존한 뒤 지시 준수와 전체 작업까지 확인하세요.

9 분
함수 호출 요청을 앱에서 검증하고 실행한 뒤 같은 call_id의 결과를 반환해 최종 답변으로 이어가는 흐름
API 가이드

Chat Completions 함수 호출을 Responses API로 이전하는 Python 검증 절차

Responses API 이전은 모든 함수 호출을 앱에서 검증·실행하고, 원래 call_id로 결과를 반환한 뒤 최종 답변까지 받아야 끝납니다. Python 비동기 예제로 전체 루프를 먼저 오프라인에서 확인하고, 업무 결과가 불명확하면 재실행을 멈춥니다.

8 분
ChatGPT의 파일 전달 경로와 Codex·Claude Code의 로컬 파일 권한을 비교한 기존 개념도
개발 도구·에이전트

ChatGPT Agent 로컬 파일 접근: Work·Codex·Claude Code 권한 차이

문서 한 개는 업로드로, 현재 저장소와 미커밋 변경은 해당 컴퓨터의 로컬 작업으로 처리합니다. ChatGPT Work의 로컬 연결 조건과 Codex·Claude Code의 읽기·수정·명령 실행 권한을 확인하세요.

13 분
Claude Code에서 작업에 맞는 첫 MCP를 선택하는 경로
Claude Code

Claude Code MCP 추천: 용도별 첫 서버 선택과 설치 확인

PR과 이슈가 필요하면 GitHub, 버전별 문서가 필요하면 Context7, 브라우저 동작 확인은 Playwright, 운영 오류 조사는 Sentry가 첫 후보입니다. 이미 쓰는 도구로 충분한지 확인한 뒤, 필요한 서버 하나를 연결하고 실제 조회 결과까지 확인하세요.

10 분
Claude Code의 승인 생략 플래그와 권한 모드 선택을 설명하는 안내 그림
Claude Code

Claude Code --dangerously-skip-permissions 사용법과 승인 생략의 범위

claude --dangerously-skip-permissions로 실행하면 bypassPermissions가 선택됩니다. 일반적인 도구 승인 요청은 생략하지만 명시적 ask 규칙과 일부 보호 절차는 남습니다. 편집 승인만 줄이려면 acceptEdits, 승인 없이 허용된 작업만 수행하려면 dontAsk를 먼저 검토하세요.

11 분
Claude Code에서 MCP 도구 정의와 호출 결과에 컨텍스트 공간을 나누는 개념도
Claude Code

Claude Code MCP 컨텍스트 과부하: 원인 찾기와 큰 출력 줄이기

MCP 서버 수를 줄이기 전에 컨텍스트가 언제 늘어나는지 확인하세요. 도구 검색은 정의 로딩을 늦추고, 필터링과 분할 조회는 큰 반환값을 줄입니다. 정리한 뒤에도 같은 기록에 접근하고 필요한 작업을 끝낼 수 있어야 합니다.

8 분
Claude Code 상태 표시줄을 설정하는 방법 비교
Claude Code

Claude Code statusline 설정: 스크립트 예제와 문제 해결

개인용 상태 표시줄은 /statusline으로 만들 수 있습니다. 동작을 직접 관리하려면 statusLine에 스크립트 실행 명령을 지정합니다. 모델명·현재 폴더·Git 브랜치·컨텍스트 사용률·세션 비용 추정치를 표시하는 예제와 빈 화면의 확인 순서를 제공합니다.

10 분
Codex CLI 작업량, 청구 방식, 토큰 비용과 예산을 연결한 안내 그림
개발 도구·에이전트

Codex CLI 토큰 비용: 하루 API 지출 계산과 긴 작업 예산

OpenAI API 키로 쓰는 Codex CLI는 일반 입력·캐시 읽기·캐시 쓰기·출력을 각각 계산합니다. 모델 단가와 하루 요청 수를 대입해 예상 지출을 구한 뒤, 확인된 사용액과 남은 작업량으로 계속할지 결정하세요.

12 분
Gemini 3 Pro Image의 일반 요청과 비동기 Batch 이미지 생성을 비교한 개념도
API 가이드

Gemini 3 Pro Image Batch API: 반값 요금과 이미지 회수까지

Gemini 3 Pro Image의 Batch 요금은 같은 작업의 Standard 요금 대비 50%입니다. 다만 이미지 출력 단가가 최종 비용 전부는 아닙니다. 총비용 계산부터 JSONL 요청 작성, 이미지 저장, 실패 요청만 다시 처리하는 흐름까지 연결합니다.

7 분
Grok Voice Agent API의 접속 주소, 인증과 음성 서비스 선택을 보여 주는 안내 그림
API 가이드

Grok Voice Agent API 가이드: 웹소켓 접속부터 음성 입출력까지

Grok Voice Agent API는 wss://api.x.ai/v1/realtime에서 양방향 음성 대화를 제공합니다. 서버에서는 API 키, 브라우저에서는 단기 토큰으로 인증합니다. WAV 파일을 전송하고 응답을 재생 가능한 파일로 저장하는 예제로 시작한 뒤 자동 발화 감지와 중단 처리를 연결할 수 있습니다.

11 분
Imagen 4에서 Nano Banana로 이전할 때 API 경로와 전환 절차를 구분하는 기존 설명도
AI 이미지 생성

Imagen 4 종료 후 Nano Banana로 API를 옮기는 방법

Gemini Developer API의 현재 대체 모델은 Nano Banana 2.1입니다. Firebase에서는 지원 표를 별도로 확인하고, 모델 ID뿐 아니라 요청 설정과 이미지 저장 처리까지 옮겨야 합니다.

11 분
작업의 독립성과 검토 여력에 따라 소규모 팀의 에이전트 운영 방식을 고르는 안내도
개발 도구·에이전트

소규모 팀의 멀티 에이전트 코딩: Worktree 분리부터 검토·병합까지

소규모 팀은 먼저 구현 하나와 검토 흐름을 정하고, 서로 기다리지 않아도 끝낼 수 있는 작업만 병렬로 나누는 편이 좋습니다. 작업자마다 폴더와 브랜치를 분리하고, 합친 코드의 동작을 확인한 뒤 한 번에 한 변경씩 병합하세요.

13 분