글

9월, 2026의 게시물 표시

Databricks Unity Gateway CLI 설치와 코딩 에이전트 관리 가이드

이미지
Codex, Claude Code, Gemini CLI처럼 서로 다른 AI 코딩 도구를 팀에서 함께 쓰기 시작하면 문제는 모델 선택보다 운영에서 생깁니다. 누가 어떤 모델과 MCP 서버를 쓸 수 있는지, 로컬 설정이 최신 정책과 맞는지, 예산이 얼마나 남았는지, 실패한 도구 호출을 어디서 추적할지를 도구마다 따로 관리해야 하기 때문입니다. Databricks가 2026년 9월 24일 발표한 Unity Gateway CLI 는 이 문제를 다루는 명령줄 도구입니다. 개발자는 익숙한 코딩 에이전트를 계속 사용하고, 관리자는 모델·MCP 서버·스킬·비용 정책·추적 설정을 중앙에서 게시합니다. CLI 명령은 ug 이며, 공식 문서 기준으로 Codex, Claude Code, Gemini CLI, OpenCode, GitHub Copilot CLI, Pi를 실행할 수 있습니다. Cursor Agent는 모델 연결이 아니라 MCP와 스킬 설정 범위로 지원됩니다. 핵심만 먼저 보면: 개인이 무료 코딩 도구를 하나 더 설치하는 방식이 아니라, 이미 Databricks 워크스페이스와 Unity Catalog를 운영하는 조직이 여러 코딩 에이전트에 같은 통제 기준을 적용하는 도구입니다. Python 3.12 이상과 uv , 워크스페이스 접근 권한이 필요하며, 관리형 에이전트 구성과 통합 추적의 일부 기능은 아직 Beta 또는 Preview 조건이 있습니다. 개발자는 서로 다른 에이전트를 사용하지만 모델·도구·비용·추적 정책은 하나의 관리 경계에서 적용할 수 있습니다. Unity Gateway CLI가 해결하려는 문제 코딩 에이전트는 각자 설정 파일, 인증 방식, 모델 이름, MCP 등록 위치가 다릅니다. 개인 실험에서는 한 번 설정하면 끝날 수 있지만, 팀 단위에서는 다음과 같은 불일치가 생깁니다. 개발자마다 승인되지 않은 모델이나 MCP 서버를 추가해 권한 경계가 달라집니다. 새 모델이나 비용 정책을 적용하려면 여러 도구의 설정을 각각 바...

GitHub Copilot 앱 로컬 샌드박스 설정과 안전한 사용법

이미지
AI 코딩 에이전트가 파일을 고치고, 패키지를 설치하고, 테스트를 실행하는 범위가 넓어질수록 “어떤 명령을 승인할까”만으로는 안전을 관리하기 어렵습니다. 사람이 승인 창을 놓치거나 저장소 안의 악성 지시를 에이전트가 읽을 수도 있기 때문입니다. GitHub가 2026년 9월 23일 Copilot 앱에 추가한 로컬 샌드박스 는 이 문제를 운영체제 수준의 실행 경계로 줄이는 기능입니다. English: Read this guide in English 이 글에서는 로컬 샌드박스가 실제로 제한하는 대상, 프로젝트별 설정 순서, 파일·네트워크·자격증명을 나누는 방법, 정상 적용 확인, 작업이 막힐 때의 복구 순서를 설명합니다. 기능은 현재 공개 미리보기이며 기본값은 꺼짐입니다. 직접 테스트 결과를 주장하지 않고 GitHub 공식 문서에서 확인된 동작과 제약만 다룹니다. 핵심 요약: 승인보다 먼저 실행 범위를 줄인다 적용 대상: GitHub Copilot 앱의 로컬 저장소 및 working tree 세션 제어 영역: 파일 시스템, 외부 인터넷·로컬 네트워크, Git·GitHub CLI 자격증명 기본 상태: 프로젝트마다 별도 설정하며 기본적으로 비활성화 적용 시점: 새 세션 또는 기존 세션 재시작 이후 실패 방식: 운영체제가 정책을 강제하지 못하면 샌드박스 없이 조용히 실행하지 않고 오류로 중단 비용: 로컬 샌드박스는 Copilot 좌석에 추가 비용 없이 포함된다고 공식 문서가 안내 로컬 샌드박스는 작업 공간 바깥의 파일, 네트워크, 자격증명 접근을 각각 별도의 정책으로 제한합니다. 로컬 샌드박스와 working tree는 역할이 다르다 working tree는 여러 세션이 서로 다른 브랜치와 파일을 사용하도록 분리하는 장치입니다. 그러나 에이전트가 홈 폴더의 다른 파일을 읽거나, 로컬 네트워크 서비스에 접속하거나, 저장된 자격증명을 사용하는 것까지 막아 주지는 않습니다. 로컬 샌드박스는 바로 이...

Unity 공식 Codex·Claude Code 플러그인 설치와 활용 가이드

이미지
Unity 프로젝트에 AI 코딩 에이전트를 연결할 때 가장 곤란한 문제는 코드가 전혀 나오지 않는 것이 아니라, 예전 Unity 관습과 현재 API가 섞인 그럴듯한 코드 가 나오는 것입니다. Unity는 이 문제를 줄이기 위해 Claude Code와 Codex용 공식 플러그인을 공개했습니다. 일반 튜토리얼을 넓게 참조하게 두는 대신, Unity 기능 담당 팀이 작성한 스킬을 에이전트가 필요할 때 불러오게 하는 방식입니다. 이 글은 Unity 6 이상 프로젝트를 기준으로 설치 위치, 정상 설치 확인, Codex와 Claude Code의 차이, 실제 요청을 작성하는 법, 보안과 실패 복구 순서를 정리합니다. 직접 프로젝트를 실행한 후기가 아니라 2026년 9월 23일 확인한 Unity 공식 문서와 공개 자료를 바탕으로 설명합니다. 먼저 결론 Unity 공식 플러그인은 Asset Store 패키지가 아니라 코딩 에이전트에 설치하는 스킬 묶음입니다. Unity 6.0 이상이 필요하며, Codex판은 31개 스킬과 Unity CLI 중심이고 공식 안내상 MCP 서버가 아닙니다. Claude Code판은 29개 스킬과 Unity CLI를 제공하며 라이브 에디터 작업 흐름까지 안내합니다. 어느 쪽이든 변경 전 브랜치와 테스트 기준은 사용자가 준비해야 합니다. 무엇이 달라졌나: 모델 지식보다 작업 지침을 앞에 둔다 일반 코딩 에이전트는 인터넷에 축적된 여러 세대의 Unity 자료를 함께 학습했기 때문에, 이미 바뀐 렌더링 방식이나 오래된 UI 선택을 현재 프로젝트에 제안할 수 있습니다. 공식 플러그인은 이를 새로운 모델로 해결하지 않습니다. 대신 UI Toolkit, uGUI, 2D 타일맵, URP, Shader Graph, 오디오, 물리, 멀티플레이, 인앱결제, 현지화처럼 반복되는 작업마다 Unity 엔지니어가 정리한 지침을 제공합니다. 사용자가 “설정 화면을 만들어 줘”라고 요청하면 에이전트는 관련 UI 스킬을 불러오고, 프로젝트가 사용하는 UI 체계를 먼저...

WhatsApp Business Tools MCP 사용법: Codex·Claude로 비즈니스 메시징 설정하기

이미지
WhatsApp Business Platform을 연결하려면 여러 Meta 화면에서 비즈니스, 앱, 전화번호, 템플릿, Webhook을 맞춰야 합니다. Meta가 2026년 9월 15일 발표한 WhatsApp Business Tools MCP 는 이 순서를 Claude Code, Codex, ChatGPT 안에서 대화형으로 진행하게 해 주는 원격 MCP 서버입니다. 현재 베타이자 단계적 출시 중이며 개발·테스트용입니다. 메시지 발송과 번호 등록처럼 상태를 바꾸는 작업은 여전히 사람이 권한, 대상, 비용을 확인해야 합니다. 이 글은 2026년 9월 22일 확인한 공식 문서를 바탕으로 안전한 연결 순서를 정리합니다. 먼저 결론 서버 주소는 https://mcp.facebook.com/whatsapp_business_tools 이며 Streamable HTTP와 OAuth를 사용합니다. 비즈니스와 WhatsApp 활성화 앱 모두에서 관리자 권한이 필요하고, Cloud API 서비스 약관 동의가 선행돼야 합니다. 계정·번호 조회부터 전화번호 인증, 템플릿 관리, Webhook 구성, 테스트 메시지까지 지원합니다. 처음에는 읽기 전용 조회로 연결을 검증하고, 변경 작업은 한 단계씩 승인하는 방식이 안전합니다. 대규모 운영 발송용이 아니며, 메시지 요금과 정책은 MCP와 별도로 WhatsApp Business Platform 기준을 확인해야 합니다. 무엇이 달라졌나: 콘솔을 없앤 것이 아니라 작업 순서를 묶었다 기존 방식에서는 앱을 만들고 비즈니스에 연결한 뒤, 전화번호 상태와 서비스 약관을 확인하고, 템플릿과 Webhook을 각각 다른 화면에서 구성해야 했습니다. 중간에 관리자 권한, 결제 수단, 비즈니스 인증이 빠지면 다음 단계에서 오류가 나타나 원인을 거슬러 올라가야 했습니다. WhatsApp Business Tools MCP는 이 순서를 에이전트가 읽을 수 있는 도구로 제공합니다. 사용자가 “내가 관리할 수 있는 비즈니스를 보여줘”라...

Step 5 Preview 사용법: 1M 컨텍스트 에이전트 API를 안전하게 시험하는 법

이미지
Step 5 Preview 는 StepFun이 2026년 9월 20일 공개한 에이전트 작업용 플래그십 모델이다. 100만 토큰 컨텍스트, 텍스트·이미지·영상 입력, 도구 호출을 앞세우지만, 긴 입력이 가능하다는 사실만으로 실제 업무 자동화가 안전해지는 것은 아니다. 이 글은 홍보용 벤치마크를 다시 나열하기보다 API를 작은 범위에서 연결하고, 비용·도구 실행·데이터 경계를 확인한 뒤 확대하는 방법에 집중한다. 핵심 요약 모델 ID는 step-5-preview , 컨텍스트는 최대 1M 토큰, 출력은 최대 64K 토큰이다. 표준 API와 Step Plan은 Base URL과 과금 체계가 다르다. 성공 응답만 보고 어느 채널에서 비용이 빠졌는지 판단하면 안 된다. 도구 호출은 모델이 요청을 만들 뿐이며, 실제 실행·권한·재시도·결과 검증은 애플리케이션이 맡는다. 공식 문서 사이에 프롬프트 캐시 지원 범위가 일치하지 않는다. 실제 응답의 사용량 필드와 콘솔 기록으로 확인해야 한다. Step 5 Preview에서 달라진 점 공식 발표에 따르면 Step 5 Preview는 총 600B, 토큰당 27B가 활성화되는 희소 MoE 구조다. 긴 소프트웨어 작업, 여러 자료를 묶는 전문 분석, 이미지와 영상을 포함한 조사 흐름을 주요 용도로 제시한다. 현재 제품과 API로 사용할 수 있고, 가중치 공개는 10월 15일로 예고됐다. 따라서 지금 당장 로컬 모델을 내려받아 운영하는 제품이 아니라, 우선 API 프리뷰를 검증하는 단계로 보는 편이 정확하다. 공식 발표의 코딩·금융·장기 실행 결과는 제조사가 설계한 평가와 사례다. 모델 선택의 출발점은 될 수 있지만 독자의 저장소, 문서, 권한 구조에서 같은 결과를 보장하지 않는다. 특히 장시간 에이전트 작업은 한 번의 정답보다 중간 상태 저장, 도구 오류 복구, 비용 상한, 사람이 중단할 수 있는 지점이 더 중요하다. 무엇을 지원하고 무엇은 애플리케이션이 맡나 항목 공식 지원 범위 도입 전 확인 입출력 텍스트·이미지·영...

Qwen-Image-2.1 사용법: 투명 PNG·다중 이미지 편집과 라이선스 확인

이미지
Qwen-Image-2.1은 2026년 9월 20일 공개된 이미지 생성·편집 모델이다. 텍스트로 새 이미지를 만드는 기능과 기존 이미지를 고치는 기능을 하나의 체크포인트에 합쳤고, 투명 배경을 포함한 RGBA 출력과 최대 10장의 참조 이미지 입력을 지원한다. 다만 “오픈 웨이트”라는 표현만 보고 업무에 바로 투입하면 안 된다. 현재 가중치는 Qwen Research License가 적용되며, 연구와 평가 목적의 비상업적 사용만 허용된다. 이 글은 모델의 특징을 나열하는 데서 끝내지 않고, ComfyUI와 Diffusers에서 준비할 파일과 입력 위치, 투명 PNG를 확인하는 방법, 다중 이미지 편집 흐름, 라이선스 때문에 실제 업무에서 멈춰야 하는 지점을 순서대로 정리한다. 기존의 영상·음성 분석 모델이 궁금하다면 Qwen3.8-Omni-Flash 활용 가이드 도 함께 볼 수 있다. 핵심부터: 무엇이 달라졌나 하나의 모델로 생성과 편집: 텍스트 투 이미지와 이미지 조건 편집을 같은 QwenImage21Pipeline에서 처리한다. 투명 배경을 모델이 직접 출력: 64채널 RGBA VAE를 사용해 알파 채널이 포함된 이미지를 만들 수 있다. 결과는 PNG처럼 알파 채널을 보존하는 형식으로 저장해야 한다. 최대 10장 참조: 인물, 제품, 의상, 배경, 스타일 자료를 여러 장 넣어 한 장면으로 조합하거나 편집할 수 있다. 부분 수정 지시: 원, 칠한 표시, 별도 마스크로 고칠 영역을 지정할 수 있다. 기본 2K 출력: 공식 Diffusers 예제는 2048×2048과 여러 가로세로 비율을 제시하며, 기본 추론 단계는 40회다. 작업 기존에 흔한 흐름 Qwen-Image-2.1 흐름 확인할 점 투명 소재 생성 후 배경 제거·매팅 RGBA 출력을 직접 요청 알파 채널과 가장자리 품질을 별도 확인 여러 자료 조합 콜라주 제작 후 다시 생성 최대 10장 참조 이미지를 입력 각 참조의 역할을 프롬프트에 명시 부분 수정...

Plugin4Shell 대응 가이드: AI 코딩 에이전트 플러그인 점검과 패치

이미지
AI 코딩 에이전트의 플러그인은 단순한 프롬프트 묶음이 아니다. 훅, 실행 파일, MCP 서버, 셸 명령을 포함해 사용자의 파일과 자격증명에 접근할 수 있다. 2026년 9월 17일 AIR Security가 공개한 Plugin4Shell 은 이 배포 경로의 핵심 안전장치인 커밋 SHA 고정을 우회한다. 검토한 커밋을 지정했는데도 공격자가 다른 코드를 설치하게 만들 수 있고, 백그라운드 자동 업데이트가 켜져 있으면 이미 설치한 플러그인도 사용자 조작 없이 바뀔 수 있다는 내용이다. 이 글의 목적은 공격 코드를 재현하는 것이 아니라, 지금 설치된 에이전트와 플러그인을 어떻게 확인하고 패치하며 권한을 줄일지 정리하는 것이다. AIR의 공개 내용과 OpenAI·Anthropic의 플러그인 문서를 2026년 9월 20일 확인했다. 현재 버전은 이미 패치 기준보다 높을 수 있으므로 아래 숫자는 “최소 안전 기준”으로 읽고, 실제 설치 버전과 최신 안정판을 함께 확인해야 한다. 핵심 요약: 먼저 버전, 그다음 플러그인 Claude Code: AIR에 따르면 2.1.179에서 수정됐다. claude --version 으로 확인하고 그 미만이면 즉시 업데이트한다. OpenAI Codex: AIR와 공개 수정 PR에 따르면 0.146.0에서 해결됐다. codex --version 으로 확인하고 설치 방식에 맞춰 최신 안정판으로 올린다. GitHub Copilot: AIR 공개 시점에는 수정판이 없었다. 비필수 마켓플레이스 플러그인을 중지하고 공급자 공지를 확인해야 한다. Gemini CLI: AIR는 해당 도구가 패치되지 않으며 후속 환경으로 이전하라고 설명한다. 남아 있는 설치와 자동 실행 경로를 우선 분리한다. 공통: 패치만으로 과거 노출 여부를 알 수는 없다. 설치 목록, 업데이트 기록, 비밀정보 접근 흔적도 함께 검토한다. Plugin4Shell은 무엇을 우회했나 마켓플레이스는 보통 플러그인 저장소의 특정 커밋 SHA를 기록한다. 검토 당...

Claude Code AGENTS.md 사용법: 여러 코딩 에이전트 지침 하나로 관리하기

이미지
Claude Code 2.1.277부터 프로젝트에 CLAUDE.md 가 없으면 AGENTS.md 를 대신 읽을 수 있다. Codex, Cursor, Gemini CLI처럼 AGENTS.md를 쓰는 도구와 Claude Code를 함께 사용하는 팀이라면 비슷한 지침 파일을 두 벌 유지하던 부담을 줄일 수 있는 변화다. 다만 “파일 이름만 바꾸면 모든 환경에서 똑같이 작동한다”는 뜻은 아니다. 어떤 파일이 우선하는지, 하위 폴더 지침이 언제 붙는지, 직접 로드가 지원되지 않는 환경은 무엇인지 알아야 안전하게 옮길 수 있다. 이 글은 2026년 9월 19일 확인한 공식 릴리스·메모리 문서·내장 플러그인 설명을 바탕으로 설정과 이전 방법을 정리한다. 기능은 9월 18일 v2.1.277에 포함됐다. 관련 Hacker News 토론은 확인 시점에 605점과 214개 댓글을 기록했지만, 이는 관심의 근거이지 품질 평가는 아니다. 무엇이 바뀌었나: AGENTS.md가 기본 대체 파일이 됐다 AGENTS.md 는 빌드 명령, 테스트 순서, 코드 스타일, 보안 주의사항처럼 코딩 에이전트가 작업 전에 알아야 할 내용을 적는 일반 Markdown 파일이다. 사람용 소개 문서인 README를 길게 만들지 않으면서 여러 코딩 에이전트가 같은 저장소 규칙을 읽도록 하는 것이 목적이다. AGENTS.md 공개 사이트는 6만 개가 넘는 오픈소스 프로젝트가 이 형식을 사용한다고 안내한다. Claude Code의 새 기본값은 CLAUDE.md 또는 CLAUDE.local.md가 프로젝트 경로에 있으면 기존 파일만 읽고, 둘 다 없을 때 AGENTS.md를 읽는 방식 이다. 따라서 기존 Claude Code 프로젝트의 동작을 갑자기 바꾸지 않으면서, AGENTS.md만 있는 저장소에 들어갔을 때 별도 복사본 없이 지침을 받을 수 있다. 이는 CLAUDE.md 폐지나 완전한 파일 병합이 아니라 ‘우선순위가 있는 대체 읽기’다. CLAUDE.md가 있으면 우선하고, 없을 때 AGENTS....

UN System Data Commons 사용법: 공공 통계를 찾고 MCP로 검증하는 법

이미지
UN System Data Commons 는 여러 UN 기관의 통계를 한 지식 그래프 안에서 찾을 수 있게 만든 공개 데이터 플랫폼이다. 2026년 9월 17일 공개된 새 data.un.org는 자연어 검색을 제공하고, 기반 기술인 Google Data Commons는 MCP 서버를 통해 에이전트가 통계를 탐색하도록 지원한다. 핵심은 “질문만 하면 정답이 나온다”가 아니다. 지표 이름, 지역, 연도, 단위, 원출처를 함께 확인하는 수고를 줄이는 도구에 가깝다. 이 글은 웹 검색으로 빠르게 자료를 찾는 방법과 MCP 클라이언트에서 반복 조사를 구성하는 방법을 구분해 설명한다. 공식 문서를 기준으로 설치 위치와 완료 확인, 비용·보안·데이터 공백, 세 가지 활용 예시까지 정리했다. 무엇이 달라졌나 기존 국제 통계 조사는 기관별 사이트와 서로 다른 표 형식, 지역 명칭을 오가야 했다. 새 UN System Data Commons는 이를 연결된 지식 그래프로 묶어 장소, 시계열, 지표의 관계를 탐색하게 한다. 공개 화면에서는 질문을 자연어로 입력하고 관련 지표의 차트, 표, 단위, 출처를 함께 볼 수 있다. Google의 발표에 따르면 여러 UN 기관의 데이터가 단계적으로 연결되며, 향후에도 범위가 확대될 예정이다. 따라서 “UN의 모든 통계가 이미 들어 있다”고 가정하면 안 된다. 현재 검색되는 범위와 각 결과의 원출처를 확인해야 한다. 실제 공개 검색 화면도 일부 지역이 보고 누락 때문에 빠질 수 있고, 비교 차트가 가장 최근의 동일 연도만 쓰지 않을 수 있음을 안내한다. 분산된 통계는 지표·지역·시점·출처 관계가 연결된 뒤 검색 가능한 결과로 정리된다. 웹 포털과 MCP는 같은 도구가 아니다 구분 data.un.org 웹 검색 Data Commons MCP 적합한 일 질문 한두 개, 차트 확인, CSV 다운로드 여러 지역·지표의 반복 조회, 에이전트·앱 연결 시작 조건 브라우저 MCP 클라이언트와 무료 Data Commons API 키 확인해...

Paper2Agent 사용법: 논문과 연구 코드를 검증된 MCP로 바꾸는 법

이미지
연구 논문을 읽고 “내 데이터에도 이 방법을 적용해 보고 싶다”고 생각한 뒤 실제 실행까지 가는 길은 길다. 공식 코드 저장소를 찾고, 맞는 버전의 실행 환경을 만들고, 노트북의 예제 값을 내 입력값으로 바꾸고, 결과가 논문과 일치하는지 확인해야 한다. Paper2Agent 는 이 간격을 줄이기 위해 논문과 연구 코드를 에이전트가 읽을 수 있는 스킬과 실행 가능한 MCP 도구로 변환하는 공개 프로젝트다. 다만 “PDF를 넣으면 언제나 믿을 수 있는 연구 에이전트가 완성된다”는 제품은 아니다. 2026년 9월 16일 Nature 에 정식 게재된 논문도 불완전한 코드, 부족한 문서, 해결할 수 없는 환경 문제 때문에 상당수 저장소가 변환에 실패할 수 있다고 밝힌다. 이 글은 9월 19일 기준 공식 저장소와 논문을 바탕으로, Codex 또는 Claude Code에서 Paper2Agent를 설치하고 어디까지 맡길지 판단하는 순서를 정리한다. 핵심 요약 논문만 있으면 검색 가능한 paper skill , 코드 저장소가 있으면 검증된 도구를 담은 MCP server 를 만든다. Codex 설치 경로는 ~/.agents/skills/paper2agent , Claude Code는 ~/.claude/skills/paper2agent 다. 좋은 결과의 핵심은 “논문 전체를 알아서 처리해 줘”가 아니라 대상 논문·공식 저장소·튜토리얼·출력 폴더·자원 제한을 명확히 주는 것이다. 생성된 도구는 논문의 결론을 보증하지 않는다. 실행 로그, 원본 예제와의 비교, 입력 범위, 라이선스와 민감정보 경계를 사람이 검토해야 한다. Paper2Agent가 만드는 것은 하나가 아니다 현재 저장소의 최상위 스킬은 입력에 따라 두 작업으로 갈라진다. Paper2Skill 은 본문 PDF, 보충자료, 표와 그림을 구조화된 읽기 패키지로 바꾼다. 이 경로는 논문에 적힌 명령이나 코드를 실행하지 않고, 페이지별 검토와 출처 추적에 초점을 둔다. Paper2MCP 는 Python...