1995 Dev

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

Claude Code Skills 만들기 SKILL.md로 반복 작업을 명령으로 등록하기

파일을 검토할 때마다 같은 요청을 붙여 넣는다면 SKILL.md에 지시를 저장하고 /이름으로 호출할 수 있습니다. 이 글에서는 지정한 파일의 검토 메모를 만드는 review-note 스킬을 작성합니다. Claude Code를 이미 사용하는 독자를 위한 예제입니다.Anthropic의 Claude Code Skills 문서에 따르면 스킬은 설정과 작업 지시를 담은 파일로 구성됩니다. 여기서 ‘명령 등록’은 저장한 지시를 불러온다는 뜻이며, 결과가 매번 같은 프로그램을 만드는 것은 아닙니다.1. 저장 위치 정하기스킬을 쓸 범위에 따라 아래 경로 중 하나를 선택합니다. ~는 사용자 홈 디렉터리를 뜻합니다.범위파일 경로여러 프로젝트에서 개인적으로 사용~/.claude/skills/review-note/SKILL...

AI 2026. 10. 19. 07:17

Claude Code 유휴 시간 압축 설정 /config에서 Idle compaction 켜고 끄기

Claude Code의 유휴 시간 대화 압축은 /config → Idle compaction에서 끄거나 다시 켤 수 있습니다. Anthropic의 v2.1.302 릴리스 노트에 이 설정 항목의 추가가 명시돼 있습니다.잠시 작업을 멈춘 사이 대화가 압축돼 설정 위치를 찾고 있다면 이 항목을 확인하세요. 아래는 공식 문서에 따른 안내이며, 실제 설정 화면에서 조작을 테스트한 절차는 아닙니다./config에서 끄고 다시 켜기Claude Code 공식 Commands 문서에서 /config는 설정 화면을 여는 명령입니다. 운영체제의 터미널 명령줄이 아니라 Claude Code 대화 입력란에 입력합니다.1. 대화 입력란에 /config를 입력해 설정 화면을 엽니다.2. 설정 목록에서 Idle compaction ..

AI 2026. 10. 18. 14:22