imprun engineering

작성일: 2025년 12월 30일카테고리: AI, Developer Tools, Usage Analysis키워드: Claude Code, Claude Max, AI Coding Assistant, Token Usage, Monthly Report요약2025년 12월 한 달간 Claude Code로 23억 토큰을 사용했다. API 환산 비용 $1,844, 일평균 $74 수준이다. 11월 측정 가능 기간(15~30일) 대비 일평균 사용량이 12배 증가했으며, 캐시 적중률 94%를 유지했다.측정 환경구독 플랜: Claude Max 20 ($200/월)측정 기간: 2025년 12월 1일 ~ 12월 31일측정 도구: ccusage활동일: 25일 (12/1, 12/2, 12/13, 12/20, 12/24~26 제외..

작성일: 2025년 12월 30일카테고리: Frontend Architecture키워드: Next.js, Feature-Sliced Design, Clean Architecture, FSD, 프론트엔드 아키텍처, 도메인 주도 설계요약Feature-Sliced Design(FSD)과 Clean Architecture는 서로 다른 방향에서 프론트엔드 아키텍처 문제를 해결한다. FSD는 "UI에서 도메인으로" 하향식 접근을, Clean Architecture는 "도메인에서 UI로" 상향식 접근을 취한다. 두 아키텍처를 결합하면 FSD의 명확한 레이어 구조와 Clean Architecture의 비즈니스 로직 분리라는 장점을 모두 취할 수 있다. 이 글에서는 Next.js 환경에서 두 아키텍처를 효과적으로 결합하..

작성일: 2025년 12월 29일카테고리: Claude Code, Developer Tools, Performance키워드: Claude Code, 토큰 최적화, MCP, 플러그인, 컨텍스트 관리요약Claude Code에서 /compact 실행 후에도 컨텍스트가 33% 사용 중이었다. /context 명령어로 분석한 결과, 불필요한 MCP 도구(22.6k 토큰)와 중복 플러그인이 원인이었다. 정리 후 10%로 줄였고, Plan 모드와 Phase 분리 패턴으로 효율적인 작업 방식을 정립했다.문제 상황왜 컨텍스트 관리가 중요한가Claude Code의 컨텍스트는 책상 위 공간과 같다. 책상이 좁으면 필요한 자료를 펼칠 수 없다. 컨텍스트가 부족하면 Claude가 코드를 분석하고 수정하는 데 필요한 정보를 담을..

작성일: 2025년 12월 28일 (Windows 패치 추가: 12월 29일)카테고리: Claude Code, Developer Tools, AI Coding키워드: Claude Code, LSP, Language Server Protocol, Serena, MCP, AI Coding, Windows요약Claude Code v2.0.74부터 LSP(Language Server Protocol)가 네이티브로 지원된다. 이전에는 Serena MCP 같은 외부 도구를 설치해야 했던 시맨틱 코드 분석 기능이 이제 플러그인 설정만으로 사용 가능하다. 이 글에서는 Serena MCP에서 Claude Code 네이티브 LSP로 전환하는 방법과 실제 사용 경험을 공유한다.문제 상황: 왜 LSP가 필요했나grep/glo..

작성일: 2025년 12월 28일카테고리: Git, AI Development, Workflow키워드: git worktree, Claude Code, multi-agent, 동시 개발, 브랜치 관리요약Claude Code를 여러 개 동시에 실행하면 개발 속도를 높일 수 있다. 하지만 같은 프로젝트 폴더에서 여러 에이전트가 작업하면 빌드 충돌과 파일 충돌이 발생한다.git worktree를 사용하면 이 문제를 해결할 수 있다. 하나의 저장소에서 여러 작업 디렉토리를 만들어 각 Claude Code 인스턴스가 독립적으로 작업하도록 구성한다. 이 글에서는 Claude Code로 worktree를 생성하고 멀티 에이전트 환경을 구축하는 방법을 소개한다.문제: 같은 폴더에서 멀티에이전트 충돌여러 에이전트를 동시..

작성일: 2025년 12월 25일카테고리: AI, Developer Tools, Claude Code키워드: CLAUDE.md, AGENTS.md, symlink, @import, Claude Code요약Claude Code의 공식 문서에서 @import 문법으로 AGENTS.md를 참조하라고 안내하고 있지만, 실제 개발 환경에서 Claude가 AGENTS.md를 읽지 않는 경우가 빈번하게 발생합니다. 이 글에서는 해당 문제의 원인을 분석하고, 심볼릭 링크를 활용한 현실적인 해결책을 공유합니다.문제 상황공식 가이드의 @import 문법Claude 공식 블로그와 Memory Documentation에서는 @path/to/file 문법으로 다른 마크다운 파일을 import할 수 있다고 안내합니다.# CLAU..

작성일: 2025년 12월 22일카테고리: Tools, AI, Warning키워드: Google Antigravity, Claude Code, Git, 작업 손실, AI 코딩 도구요약Google Antigravity와 Claude Code를 같은 작업 폴더에서 동시에 사용하던 중, Antigravity 업데이트 시 git checkout이 실행되어 Claude Code로 수정한 파일이 전부 초기화되는 사고가 발생했다. AI 코딩 도구를 동시에 사용할 때는 반드시 작업 폴더를 분리하거나, 수시로 커밋하는 습관이 필요하다.사고 경위상황동일한 Git 저장소 폴더를 VS Code에서 열고 작업Claude Code로 프론트엔드 에픽을 멀티 에이전트로 진행 중약 40개 파일이 수정된 상태로 누적동시에 Google ..

작성일: 2025년 12월 22일카테고리: Web, HTTP, Security키워드: HTTP Cookie, Session, Security, SameSite, HttpOnly, Secure요약HTTP는 본질적으로 무상태(Stateless) 프로토콜이다. Cookie는 이 무상태 프로토콜에서 상태를 유지하기 위해 1994년 Netscape에서 도입한 메커니즘이다. 이 글에서는 Cookie의 내부 동작 원리부터 보안 속성, 실무에서 마주치는 문제들과 해결 방안까지 깊이 있게 다룬다.Cookie의 탄생 배경HTTP의 무상태 특성HTTP 프로토콜은 각 요청이 독립적이다. 서버는 이전 요청에 대한 정보를 기억하지 않는다.GET /page1 HTTP/1.1Host: example.com(서버는 이 요청을 처리하고..

작성일: 2025년 12월 22일카테고리: Frontend, Next.js, Tailwind CSS키워드: Next.js, Tailwind CSS v4, shadcn/ui, next-themes, Dark Mode, CSS Variables요약shadcn/ui의 zinc 테마를 next-themes로 확장할 때 테마 전환이 동작하지 않는 문제가 발생한다. 근본 원인은 text-zinc-400 같은 하드코딩된 Tailwind 색상 클래스가 CSS 변수를 참조하지 않기 때문이다. 이 글에서는 올바른 테마 시스템 설정 방법과 자주 하는 실수, 그리고 색상 사용 가이드를 정리한다.문제 상황: 왜 테마가 깨지는가?전형적인 시나리오shadcn/ui로 Next.js 프로젝트 초기화 (zinc 테마 선택)next-th..

작성일: 2025년 12월 22일카테고리: Backend, Go, Troubleshooting키워드: Go, GORM, PostgreSQL, Troubleshooting, TimeZone요약GORM을 사용하면서 실제 프로덕션 환경에서 마주친 Edge Cases와 해결 방법을 정리한다. 타임존(KST/UTC) 불일치 문제, Zero Value 업데이트 함정, AutoMigrate와 init.sql의 권한 충돌, 그리고 Upsert, Hook 전파, 연결 끊김 등 실무에서 시간을 허비하기 쉬운 함정들을 다룬다.1. 타임존(TimeZone) 불일치 문제KST(Asia/Seoul) 환경에서 운영할 때 가장 흔하게 겪는 문제다.문제 상황// 한국 시간 2025-12-22 15:00:00에 레코드 생성user :=..

작성일: 2025년 12월 22일카테고리: Backend, Go, Architecture키워드: Go, GORM, Clean Architecture, Repository Pattern, PostgreSQL요약엔터프라이즈급 Go API Server를 구축할 때 GORM을 어떻게 활용해야 하는지 실제 프로젝트 사례를 통해 설명한다. Clean Architecture 기반의 계층 분리, Repository 패턴 구현, Custom Type을 활용한 JSONB 처리, 그리고 멀티테넌시와 감사 로그 설계까지 프로덕션 환경에서 검증된 패턴을 다룬다.프로젝트 구조Clean Architecture를 적용한 Go API Server의 표준 구조다.api/├── cmd/server/ # 애플리케이션..

작성일: 2025년 12월 22일카테고리: Backend, Go키워드: Go, GORM, ORM, PostgreSQL, Database요약GORM은 Go 생태계에서 가장 널리 사용되는 ORM(Object-Relational Mapping) 라이브러리다. 이 글에서는 GORM의 핵심 개념, 주요 기능, 그리고 실제 프로젝트에서의 활용 방법을 다룬다. 데이터베이스 연결부터 모델 정의, CRUD 작업, 관계 설정까지 실무에서 필요한 내용을 단계별로 설명한다.GORM이란GORM(Go Object Relational Mapper)은 Go 언어를 위한 풀 피처 ORM 라이브러리다. 개발자가 SQL을 직접 작성하지 않고도 Go 구조체를 통해 데이터베이스를 조작할 수 있게 해준다.주요 특징Auto Migration: ..

작성일: 2025년 12월 18일카테고리: Frontend, Claude Code, Design키워드: Claude Code, Plugin, Frontend Design, UI/UX, Anthropic요약Antigravity처럼 "AI가 만든 티가 나지 않는" UI를 Claude Code로도 만들 수 있다. Anthropic에서 제공하는 frontend-design 플러그인을 설치하거나, Frontend Aesthetics Cookbook의 프롬프트 기법을 적용하면 된다. 이 글에서는 두 가지 방법과 실제 적용 결과를 다룬다.문제: AI UI는 왜 다 비슷한가AI로 UI를 생성하면 대부분 비슷한 결과가 나온다.패턴예시폰트Inter, Roboto, Arial색상보라색/파란색 그라데이션레이아웃대칭, 균등 배..

작성일: 2025년 12월 18일카테고리: Authentication, Security, Backend키워드: Ory Kratos, Self-Service Flow, Session, Cookie, CSRF, Login요약Ory Kratos의 Self-Service Login Flow는 CSRF 방어, 세션 관리, SPA 지원을 위해 설계된 상태 기반 인증 플로우다. Flow 생성, 로그인 제출, 세션 확인의 3단계로 구성되며, 각 단계에서 보안 검증이 이루어진다. 이 글에서는 로그인 버튼을 누르면 발생하는 모든 요청과 응답을 추적하고, 세션 쿠키의 보안 속성과 에러 처리 방법을 다룬다.개요로그인 버튼을 눌렀을 때 뒤에서 무슨 일이 일어나는지 살펴보자.놀이공원 입장권 발급에 비유하면:번호표 받기: 창구에서..

작성일: 2025년 12월 18일카테고리: Authentication, Authorization, Security키워드: Ory, Kratos, Hydra, Oathkeeper, Keto, OAuth2, OIDC, Identity요약Ory는 4개의 독립적인 오픈소스 컴포넌트(Kratos, Hydra, Oathkeeper, Keto)로 구성된 인증/인가 시스템이다. 각 컴포넌트는 단일 책임 원칙을 따르며, 필요한 것만 선택적으로 사용할 수 있다. Kratos는 사용자 인증, Hydra는 OAuth2 토큰 발급, Oathkeeper는 API 인증 프록시, Keto는 권한 관리를 담당한다. 이 글에서는 각 컴포넌트의 역할과 동작 방식, 그리고 실전 적용 방법을 다룬다.왜 Ory인가?인증/인가 시스템을 구축할 ..

작성일: 2025년 12월 18일카테고리: Kubernetes, Networking, Architecture키워드: Gateway API, Ingress, Cross-Namespace Reference, ReferenceGrant, Kubernetes요약Kubernetes Gateway API는 Ingress의 한계를 해결하기 위해 처음부터 다시 설계된 API다. Role-Oriented Design을 통해 Infrastructure Provider, Cluster Operator, Application Developer 역할을 명확히 분리하고, Cross-Namespace Reference와 ReferenceGrant를 통해 멀티테넌시 환경에서 안전한 리소스 공유를 지원한다. 이 글에서는 Ingress..

작성일: 2025년 12월 18일카테고리: Kubernetes, Infrastructure, Design Pattern키워드: Kubernetes, Operator, Reconciliation, Controller, Idempotency, CRD요약Kubernetes의 핵심 철학인 "선언적 상태 관리"가 어떻게 동작하는지 Operator 패턴과 Reconciliation Loop를 통해 설명한다. kubectl apply가 왜 kubectl create보다 권장되는지, 멱등성(Idempotency)이 분산 시스템에서 왜 필수인지, 그리고 Operator 패턴이 어떤 문제를 해결하는지 다룬다.선언적 vs 명령적집안 온도 조절에 비유하면:명령적: "에어컨 켜. 10분 후에 꺼. 추우면 다시 켜."선언적: "..

작성일: 2025년 12월 18일카테고리: Backend, Protocol, Microservices키워드: gRPC, REST, Protocol Buffers, HTTP/2, Microservices, Streaming요약gRPC는 Google이 개발한 고성능 RPC 프레임워크로, Protocol Buffers와 HTTP/2를 기반으로 한다. REST와 비교하여 바이너리 직렬화로 60-70% 작은 메시지 크기, HTTP/2 멀티플렉싱으로 동시 요청 처리, 양방향 스트리밍 등의 장점이 있다. 이 글에서는 gRPC의 핵심 개념, REST와의 차이점, 4가지 통신 패턴, 실전 활용 가이드를 다룬다.gRPC란?gRPC는 Google이 개발한 고성능 원격 프로시저 호출(RPC) 프레임워크다.flowchart L..

작성일: 2025년 12월 18일카테고리: Architecture, Microservices, Backend키워드: API Gateway, Microservices, Routing, Authentication, Rate Limiting, Load Balancing요약API Gateway는 클라이언트와 백엔드 서비스 사이에 위치하여 모든 API 요청의 단일 진입점 역할을 한다. 라우팅, 인증, Rate Limiting, 로드밸런싱, 캐싱 등 공통 관심사를 중앙에서 처리하여 보안 강화, 운영 단순화, 유연한 확장을 가능하게 한다. 이 글에서는 API Gateway의 필요성, 핵심 기능, 동작 흐름, 주요 사용 사례를 다룬다.API Gateway란?API Gateway는 클라이언트와 백엔드 서비스 사이에 위치..

작성일: 2025년 12월 12일카테고리: Workflow Orchestration, Billing, SaaS키워드: Apache Airflow, Prefect, Dagster, Temporal, Billing System, SaaS, Workflow Orchestration, Usage-Based Pricing요약Apache Airflow, Prefect, Dagster, Temporal은 워크플로우 오케스트레이션에서 널리 사용되는 오픈소스 도구다. Airflow는 성숙한 생태계와 DAG 기반 스케줄링, Prefect는 Python 네이티브 개발자 경험, Dagster는 데이터 자산(Asset) 중심 접근 방식, Temporal은 내구성 실행(Durable Execution)과 Exactly-once ..

작성일: 2025년 12월 11일카테고리: AI, Design Tools, UI/UX키워드: Google Stitch, AI Design, UI Generation, Figma, Gemini요약Google Stitch는 텍스트 프롬프트나 이미지로 UI 디자인과 프론트엔드 코드를 생성하는 AI 도구다. Google I/O 2025에서 발표되었으며, Figma를 대체하기보다는 초기 디자인 단계를 가속화하는 보완 도구로 포지셔닝되어 있다. 현재 Google Labs에서 무료로 제공된다.출처: Google Developers Blog데모 영상텍스트 프롬프트로 UI를 생성하고, 변형을 탐색하고, Figma로 내보내는 전체 워크플로우를 보여준다.Stitch란?Google Labs의 실험적 프로젝트로, Gemini ..

작성일: 2025년 12월 11일카테고리: AI, Developer Tools, Claude Code키워드: Claude Code, Slack, Team Collaboration, AI Coding Assistant요약Claude Code가 Slack과 연동되었다. Slack에서 @Claude를 멘션하면 대화 컨텍스트를 기반으로 Claude Code 웹 세션이 자동 생성된다. GitHub PR 코드리뷰 기능이 GitHub 내에서 직접 동작하는 것과 달리, Slack 연동은 Claude Code for Web(claude.ai/code)을 통해 작업이 수행된다.출처: Claude 공식 블로그데모 영상프로덕션 버그 알림이 Slack에 올라오면, @Claude를 멘션하여 즉시 조사 및 수정 작업을 위임하는 시..

작성일: 2025년 12월 11일카테고리: AI, Developer Tools, Claude Code키워드: Claude Code, CLAUDE.md, Best Practices, AI Coding Assistant요약Anthropic 엔지니어링 블로그에 게시된 Claude Code 베스트 프랙티스 가이드를 정리했다. CLAUDE.md 설정, 도구 확장, 워크플로우 최적화, 다중 인스턴스 활용까지 실전 팁을 다룬다.1. CLAUDE.md 설정개념CLAUDE.md는 Claude가 대화 시작 시 자동으로 로드하는 프로젝트 설정 파일이다.포함할 내용프로젝트별 bash 명령어, 핵심 파일, 유틸리티 함수코드 스타일 가이드라인테스트 방법예상치 못한 동작 관련 주의사항배치 위치위치용도저장소 루트팀 공유 (체크인 권..

작성일: 2025년 12월 11일카테고리: AI, Developer Tools, Claude Code키워드: CLAUDE.md, Claude Code, Project Context, AI Configuration요약Claude 공식 블로그에 CLAUDE.md 파일 사용법 가이드가 올라왔다. CLAUDE.md는 프로젝트별 컨텍스트를 자동으로 Claude에게 전달하는 설정 파일이다. 매번 프로젝트 구조와 규칙을 반복 설명할 필요가 없어진다.CLAUDE.md란?저장소에 위치하는 특수 마크다운 파일로, Claude와의 모든 대화에 프로젝트 특정 맥락을 자동으로 포함시킨다.파일 배치 위치위치적용 범위저장소 루트해당 프로젝트, 팀과 공유상위 디렉토리모노레포 전체 설정홈 폴더 (~)모든 프로젝트에 적용파일 Impor..

작성일: 2025년 12월 11일카테고리: AI, Developer Tools, Usage Analysis키워드: Claude Code, Claude Max, AI Coding Assistant, Token Usage, Prompt Caching요약27일간 Claude Code로 12.7억 토큰을 사용했다. 프롬프트 캐싱 덕분에 API 환산 비용은 $952 수준이며, 캐싱이 없었다면 약 $6,000에 달했을 사용량이다.배경최근 한 개발자가 Claude Max 20 계정 4개를 사용해 5억 토큰을 소비했다는 글을 보았다. 나는 얼마나 사용하고 있는지 궁금해져서 ccusage로 측정해보기로 했다. 6월부터 Claude Code를 사용해왔지만, 이전에 문제 해결을 위해 로그를 삭제한 적이 있어서 측정 가능한 ..

작성일: 2025년 12월 6일카테고리: Authentication, Authorization, Architecture, Backend키워드: Ory Kratos, Ory Hydra, Ory Keto, Ory Oathkeeper, Zero Trust, OAuth2, ReBAC요약ImpRun v3 플랫폼은 Ory 스택 전체(Kratos, Hydra, Keto, Oathkeeper)를 통합하여 엔터프라이즈급 인증/인가 시스템을 구축했다. 각 컴포넌트가 명확한 역할을 담당하며, Zero Trust 아키텍처를 기반으로 웹 애플리케이션과 외부 API 클라이언트를 모두 지원한다. 이 글에서는 4개 Ory 컴포넌트의 조합 방식과 실제 구현 사례를 다룬다.Ory 스택 구성컴포넌트별 역할컴포넌트역할포트Ory Kratos..

Ory Oathkeeper를 활용한 Zero Trust IAP 구현 가이드작성일: 2025년 12월 6일카테고리: Authentication, Authorization, API Gateway, Security키워드: Ory Oathkeeper, Zero Trust, IAP, Identity Aware Proxy, Envoy, ext_authz요약Ory Oathkeeper는 Zero Trust Identity & Access Proxy로, 모든 요청에 대해 인증/인가를 수행하는 게이트키퍼 역할을 한다. Envoy Gateway와 연동하여 ext_authz 패턴으로 동작하며, Kratos 세션과 Hydra OAuth2 토큰을 모두 검증할 수 있다. 이 글에서는 ImpRun 프로젝트에서 Oathkeeper를 ..

작성일: 2025년 12월 6일카테고리: Authorization, Identity, Backend키워드: Ory Keto, ReBAC, Google Zanzibar, Authorization, Permission, OPL요약Ory Keto는 Google Zanzibar 논문을 기반으로 구현된 오픈소스 권한 관리 시스템이다. 전통적인 RBAC(Role-Based Access Control)의 한계를 넘어, Relationship-Based Access Control(ReBAC)을 통해 복잡한 권한 모델을 효율적으로 처리한다. 이 글에서는 Keto의 핵심 개념과 실제 프로젝트에서의 적용 방법을 다룬다.Google Zanzibar와 ReBACZanzibar의 배경Google Zanzibar는 Google 내..

Ory Kratos를 활용한 사용자 인증 시스템 구축: ImpRun 프로젝트 적용 사례작성일: 2025년 12월 6일카테고리: Authentication, Identity, Backend, Frontend키워드: Ory Kratos, Authentication, Identity Management, OAuth, OIDC, Session요약Ory Kratos는 클라우드 네이티브 환경을 위한 오픈소스 ID 관리 시스템이다. 자체적인 로그인/회원가입 UI를 제공하지 않고, API 기반으로 동작하여 프론트엔드에서 완전한 UI 커스터마이징이 가능하다. 이 글에서는 ImpRun 프로젝트에서 Kratos를 Next.js 프론트엔드와 Go 백엔드에 통합한 실제 구현 사례를 다룬다.Ory Kratos 개요Kratos란K..

작성일: 2025년 12월 6일카테고리: Authentication, OAuth2, Ory Stack키워드: Ory Hydra, OAuth2, OIDC, Kratos, Keto, Oathkeeper, API Gateway요약API Gateway 플랫폼에서 Ory Hydra를 OAuth2/OIDC 서버로 활용한 실제 구현 사례를 공유합니다. Hydra는 Ory 스택(Kratos, Keto, Oathkeeper)과 함께 사용되어, 사용자 인증은 Kratos가, 권한 관리는 Keto가, API 보호는 Oathkeeper가 담당하는 구조입니다. 이 글에서는 Docker 기반 배포, OAuth2 플로우 구현, 다른 Ory 서비스와의 통합 방법을 다룹니다.배경Ory 스택 소개Ory는 클라우드 네이티브 인증/인가 오..