1995 Dev

전체 글 검색 결과

해당 글 247건

Claude Haiku 5.5 마이그레이션: 4.5에서 바꿀 설정과 400 오류

Claude Haiku 4.5 코드를 5.5로 옮길 때는 모델 ID와 요청 설정을 함께 바꿔야 합니다. Anthropic의 마이그레이션 가이드는 수동 thinking, 샘플링 파라미터, assistant prefill을 주요 수정 대상으로 꼽습니다. 이 글은 Claude API의 Messages 요청을 기준으로 설명합니다.먼저 구분할 용어용어이 글에서의 의미adaptive thinkingHaiku 5.5의 기본 thinking 모드effortoutput_config.effort로 지정하는 설정으로, Haiku 5.5의 기본값은 mediumassistant prefill마지막 assistant 메시지에 답변 앞부분을 넣어 이어 쓰게 하는 방식400 오류를 줄이는 요청 수정Claude API의 모델 ID는 ..

AI 2026. 10. 25. 10:00

Claude Code Review 설정: Quick Standard Deep 리뷰 레벨과 저장소별 적용법

Claude Code Review의 검토 깊이는 조직 기본값과 저장소별 리뷰 레벨로 조절합니다. Claude 조직 Owner가 Admin settings > Claude Code에서 설정하며, 개별 저장소에 Quick·Standard·Deep 중 다른 레벨을 지정할 수 있습니다.이 글은 Team·Enterprise 조직용으로 제공되는 GitHub PR 관리형 Code Review를 다룹니다. 세션에서 실행하는 /code-review와는 별도 서비스이며, ZDR·HIPAA·CMEK 사용 조직에는 가용성 제한이 있습니다. 아래 절차는 Anthropic 공식 가이드에 따른 설명으로, 실제 계정에서 설정하거나 유료 리뷰를 실행한 후기는 아닙니다.설정 전에 알아둘 용어설정 화면에서 헷갈리기 쉬운 항목은 다음과 같..

AI 2026. 10. 24. 11:37

Claude Opus 5.5 Fast mode 설정: speed 파라미터와 일반 모드 선택 기준

Claude API에서 모델을 claude-opus-5-5, 요청 최상위 필드를 speed="fast"로 지정하면 Fast mode가 켜집니다. 일반 속도로 돌아가려면 speed 설정을 빼면 됩니다. 이 글은 Messages API 설정을 다룹니다.Anthropic의 10월 15일 릴리스 노트에 따르면 Opus 5.5 Fast mode는 프리뷰를 벗어났습니다. 별도 접근 신청과 베타 헤더가 필요 없습니다.속도 설정을 읽는 데 필요한 용어아래 용어를 구분하면 ‘최대 2.5배’라는 설명을 실제 응답 시간과 혼동하지 않을 수 있습니다.용어의미OTPS초당 생성하는 출력 토큰 수TTFT요청 후 첫 토큰이 나올 때까지의 시간effort응답에 들이는 작업량을 조절하는 설정Anthropic은 Fast mode가 같은 ..

AI 2026. 10. 23. 08:30

Codex GPT-5.5 종료 대응: GPT-6.1 Sol 전환과 Astra 선택 기준

ChatGPT 계정으로 로그인한 Codex에서는 GPT-5.5 지원이 종료됐습니다. OpenAI의 2026년 10월 14일 종료 공지에 따른 시각은 19:00 UTC, 한국시간으로 10월 15일 오전 4시입니다. OpenAI API와 API 키로 인증한 Codex 세션은 이 종료 공지의 적용 대상이 아닙니다.전환할 때는 계정에서 사용할 수 있는 모델을 먼저 확인하고, 기존 gpt-5.5 지정값을 바꾸면 됩니다. 아래는 GPT-6.1 Sol로 옮기는 방법과 GPT-6 Astra를 함께 평가할 작업의 기준입니다.이 글에서 사용하는 주요 용어 정의용어정의인증 방식Codex에 ChatGPT 계정으로 로그인하는지, API 키를 사용하는지의 구분입니다.모델 기본값별도 모델 지정 없이 실행할 때 사용할 모델 설정입니..

AI 2026. 10. 23. 07:39

Claude API OpenTelemetry 연동하기: SDK·API 추적으로 느린 요청 찾기

Claude API의 SDK·API 추적을 연결하면 느린 요청을 모델 실행·도구 호출 구간으로 나눠 볼 수 있습니다. Anthropic이 10월 14일 발표한 OpenTelemetry export는 베타입니다. Python의 직접 Messages API 호출을 기준으로 설명합니다.먼저 구분할 용어용어이 글에서의 의미OpenTelemetry요청의 실행 구간과 속성을 수집·전송하는 표준 도구 체계span시작·종료 시각과 속성을 담은 실행 구간trace한 요청에 연결된 span들의 묶음OTLP수집기로 추적 데이터를 보내는 프로토콜SDK는 앱의 요청을, API는 서버의 모델 실행과 도구를 추적합니다. 양쪽 전송 설정이 필요합니다.1. Python 앱에서 SDK span 출력하기가상환경에 설치합니다. 기존 앱은 ..

AI 2026. 10. 22. 07:30

Claude Code 플러그인 마켓플레이스 활용 /plugin으로 팀 공통 도구 일괄 배포하기

이 글에서 사용하는 주요 용어 정의용어정의플러그인스킬·에이전트·훅·MCP를 묶은 확장 패키지마켓플레이스플러그인 목록과 소스 경로를 정의한 카탈로그extraKnownMarketplaces마켓플레이스 소스를 프로젝트에 선언하는 설정 키도입팀 단위로 AI 코딩 에이전트를 도입할 때 환경이 다르면 컨벤션 검사나 도구 활용에 편차가 생깁니다. 개인별 수동 설정은 동일한 작업을 반복하게 만듭니다.Anthropic의 Claude Code 마켓플레이스 레퍼런스에 따르면, Claude Code는 /plugin 대화형 명령과 마켓플레이스 카탈로그로 도구 일괄 배포를 지원합니다. 스킬과 플러그인의 차이를 짚고, 사내 저장소를 프로젝트 설정에 연결해 팀원에게 자동 배포하는 절차를 정리합니다.단독 스킬과 플러그인 마켓플레이스의..

AI 2026. 10. 21. 15:30

CLAUDE.md와 AGENTS.md 차이 코딩 에이전트 지침 우선순위와 실전 작성법

이 글에서 사용하는 주요 용어 정의용어정의CLAUDE.mdClaude Code 세션 시작 시 컨텍스트에 주입되는 전용 프로젝트 지침 파일AGENTS.md여러 코딩 에이전트가 공통으로 참조할 수 있도록 설계된 벤더 중립적 오픈 표준 지침 파일컨텍스트 주입에이전트가 작업을 시작하기 전 지침 문서의 내용을 프롬프트 컨텍스트로 불러오는 과정폴백(Fallback)주 지침 파일이 없을 때 지정된 대체 지침 파일을 자동으로 탐색해 로드하는 동작도입코딩 에이전트가 프로젝트에 처음 투입될 때 빌드 명령, 패키지 매니저, 테스트 규칙을 모르면 프로젝트 규칙과 맞지 않는 코드를 만들거나 빌드 오류를 일으킬 수 있습니다. 이를 방지하기 위해 저장소 루트에 지침 문서를 배치합니다.현재 널리 쓰이는 지침 파일 규격은 Claude..

AI 2026. 10. 21. 07:29

Codex에서 GitHub 연동하기 ㅡ PR 자동 코드 리뷰부터 codex review 설정까지

이 글에서 사용하는 주요 용어 정의용어정의OpenAI Codex코드베이스 문맥을 이해하고 코드 작성과 리뷰 작업을 보조하는 AI 시스템Pull Request (PR)작업 브랜치의 코드 변경 사항을 기준 브랜치에 병합하기 전 검토를 요청하는 절차@codex reviewGitHub PR 댓글에서 Codex 에이전트를 직접 호출해 코드 분석을 요청하는 멘션 명령어AGENTS.mdAI 에이전트가 저장소 코드를 분석하고 리뷰할 때 준수해야 할 프로젝트 규칙 정의 파일코드 리뷰는 소프트웨어 품질을 유지하는 핵심 단계이지만 리뷰어 일정에 따라 병목이 발생하기 쉽습니다. 일반적인 린터나 포맷터만으로는 런타임 결함이나 아키텍처 오류를 짚어내기 어렵습니다.OpenAI Codex의 GitHub 연동 기능은 저장소 전체 구조..

AI 2026. 10. 20. 22:49

Claude Code MCP 서버 연동하기 ㅡ 설치부터 GitHub DB 연결까지 (Windows 트러블슈팅 포함)

이 글에서 사용하는 주요 용어 정의용어정의MCPAI와 외부 도구를 잇는 개방형 프로토콜stdio표준 입출력 스트림 기반 프로세스 통신.mcp.json팀원과 도구 설정을 공유하는 설정 파일외부 도구와 에이전트를 잇는 MCPAnthropic에 따르면 Claude Code는 MCP로 외부 리소스와 통신하며 도구를 호출합니다. Windows 환경에서 GitHub·DB 연동과 트러블슈팅을 정리합니다.> 코드 검증 안내: 본문에 수록된 모든 CLI 명령어 및 JSON 설정 코드는 공식 문서 규격에 따라 작성된 미실행 예제 코드이며, 실제 환경에서의 동작을 직접 검증하지 않았습니다. 독자의 환경과 버전에 맞춰 확인 후 사용하시기 바랍니다.Claude Code MCP 관리 명령어와 설정 구조설정 스코프는 세 가지로 나..

AI 2026. 10. 20. 18:47

Claude Code Hooks 설정: PreToolUse로 특정 셸 명령 실행 차단하기

이 글에서 사용하는 주요 용어 정의용어정의PreToolUse도구 인자 확정 후 실제 실행 직전에 호출되는 훅 이벤트훅(Hooks)특정 시점에 외부 검사 스크립트를 실행하는 확장 기능종료 코드 2도구 실행을 취소하고 stderr를 피드백하는 차단 신호Fail-Closed오류나 타임아웃 시 작업을 즉시 차단하는 안전 원칙도입Claude Code는 자율적인 개발 작업을 지원하지만, 예기치 못한 상황에서 rm -rf나 git reset --hard 같은 파괴적인 셸 명령어를 실행할 위험이 있습니다.이를 방지하기 위해 도구 실행 직전 외부 검사 로직을 호출하는 PreToolUse 훅의 설정과 차단 메커니즘을 정리합니다.PreToolUse 훅의 동작 원리와 설정 위치PreToolUse 이벤트는 도구 인자 확정 후 ..

AI 2026. 10. 20. 07:25