Ani Code 소개
Ani Code는 단순한 AI 코딩 보조 도구를 넘어, API 테스트, QA 자동화, 보안 점검, 지속적인 문맥 관리를 통합 지원하는 오픈소스 Claude Code 대안입니다. 다양한 AI 백엔드(OpenRouter, OpenAI, Anthropic Claude, Google Gemini, Mistral)를 지원하며, 프로젝트에 적합한 모델을 자유롭게 선택할 수 있습니다.
기존 GitHub Copilot이나 Claude Code가 코드 자동완성과 문법 보조에 집중된 반면, Ani Code는 **테스트 자동화와 품질 보증(QA)**을 핵심 목표로 삼고 있습니다. 이를 통해 개발자가 코드 작성뿐 아니라 배포 전 단계까지 품질 관리 전 과정을 자동화할 수 있도록 지원합니다.
특히 Ani Code의 가장 큰 특징은 **컨텍스트 엔지니어링(Context Engineering)**입니다. 이는 AI가 프로젝트 문맥을 이해하고 유지할 수 있도록 context/ 폴더에 구조화된 문서를 관리하는 방식으로, 단순한 일회성 코드 보조를 넘어 장기적인 프로젝트 지능화를 가능하게 합니다.
다른 Coding Assistant와의 차별점은 다음과 같습니다:
- QA 중심 설계: 단위 테스트, E2E 테스트, 보안 스캔, CI/CD 통합을 자동으로 지원
- Agent Memory: AGENT_MEMORY.md 파일을 통해 AI가 프로젝트 히스토리를 기억하고 지속적으로 학습
- 애니메이션 감성 UI: 친근한 콘셉트로, 단순한 엔터프라이즈 툴이 아닌 ‘코딩 센파이’ 느낌의 인터페이스 제공
- Zero-Config 실행: 복잡한 설정 없이 바로 사용 가능, 필요 시 TypeScript로 자동 마이그레이션 지원
Ani Code의 활용 예시
-
신규 프로젝트: 초기화(
ani init) → 테스트 생성(ani generate-tests) → 버그 스캔(ani bug-scan) -
기존 프로젝트:
ani migrate-ts로 Javascript 프로젝트를 TypeScript로 전환 및 자동 보안 점검 적용 -
일상 개발:
ani run-tests --watch로 변경 코드를 모니터링하고 실시간 테스트 작성 및 PR 전ani bug-scan --pr실행 -
대규모 프로젝트:
context/domains/구조를 활용해 서비스 단위 문맥 관리
Ani Code의 QA 기능
Ani Code의 QA 시스템은 6가지 핵심 명령어로 구성되어 있습니다.
-
add-playwright: Playwright 기반의 E2E 테스트 환경을 자동 설치 및 구성합니다.
playwright.config.js생성tests/e2e/디렉토리에 샘플 테스트 추가package.json에 테스트 스크립트 등록
-
bug-scan: 보안 취약점 및 코드 품질 문제를 자동 탐지합니다.
- ESLint 규칙 위반 확인
npm audit기반 의존성 보안 검사- 새 함수에 대한 테스트 누락 여부 확인
- 결과는
context/BUG_REPORT.md에 저장
-
run-tests: 단위 테스트, E2E 테스트, Playwright 테스트를 통합 실행합니다. 결과는
context/AGENT_MEMORY.md에 기록되어 AI 문맥에 반영됩니다. -
generate-tests: 프로젝트 전반에 대한 테스트 코드를 자동 생성합니다.
- Jest 단위 테스트
- Playwright 기반 E2E 테스트
- GitHub Actions 워크플로우(
.github/workflows/test.yml) - 커버리지 리포트
-
migrate-ts: JavaScript 프로젝트를 TypeScript로 자동 변환합니다.
tsconfig.json생성- .js → .ts 변환
- 타입 검사 및 ESLint 규칙 적용
-
bg-agent: 코드 변경을 실시간 감시하면서 자동으로 새로운 테스트를 생성합니다.
- 새로운 Express 라우트 감지
- React 컴포넌트 변경 감지
- DB 스키마 변경 시 테스트 자동 갱신
테스트 시나리오 (TEST_SCENARIO.md 기반)
Ani Code는 단순한 QA 도구가 아니라, 실제 프로젝트 환경에 맞춘 완성형 테스트 시나리오를 제공합니다.
E-commerce API 백엔드 예제
-
1단계: 프로젝트 초기화: 예제 프로젝트 디렉토리를 만들고 의존성을 설치한 뒤, Ani Code를 초기화합니다:
mkdir ecommerce-api && cd ecommerce-api npm init -y npm install express cors helmet morgan dotenv bcryptjs jsonwebtoken npm install -D jest supertest @types/node typescript ts-jest nodemon ani init -
2단계: 테스트 생성: Jest 단위 테스트, Playwright 테스트, GitHub Actions CI/CD 설정 등을 자동으로 생성합니다:
ani generate-tests --ci --e2e --playwright -
3단계: 보안 검사: 다음 명령어로 보안 검사를 시작합니다. 결과는
context/BUG_REPORT.md에 기록됩니다:ani bug-scan --local -
4단계: 지속적 테스트: 코드 변경 시 자동으로 새로운 테스트를 작성하도록 합니다:
ani bg-agent --watch -
5단계: 전체 테스트 실행: 단위 테스트 및 통합 테스트, E2E 테스트를 모두 실행합니다:
ani run-tests
위와 같은 단계들을 통해 생성된 테스트 구조는 다음과 같습니다:
ecommerce-api/
├── .github/workflows/test.yml
├── jest.config.js
├── tests/
│ ├── unit/
│ │ ├── models/user.test.js
│ │ └── controllers/auth.test.js
│ └── e2e/
│ ├── auth.spec.js
│ └── products.spec.js
├── playwright.config.js
└── coverage/
- 단위 테스트 (auth.test.js) 사용자 등록 기능 검증, 중복 이메일 방지
- E2E 테스트 (auth.spec.js) 회원가입 → 로그인 전체 플로우 자동화
Ani Code의 컨텍스트 엔지니어링 기능
Ani Code는 QA 기능 외에도 컨텍스트 엔지니어링을 통해 AI가 프로젝트를 지속적으로 이해하도록 설계되었습니다.
컨텍스트 문서 구조: Ani Code가 생성 및 관리하는 문서와 내용은 다음과 같습니다:
- PROJECT.md: 프로젝트 개요, 상태, 로드맵
- ARCHITECTURE.md: 시스템 설계, 주요 서비스, DB 구조
- DEVELOPMENT.md: 설치, 빌드, 배포, 디버깅 가이드
- CONVENTIONS.md: 네이밍 규칙, API 설계 규칙, 스타일 가이드
- AGENT_MEMORY.md: AI 에이전트가 학습한 프로젝트 특이점 저장
관리 전략
- 주간(Weekly):
AGENT_MEMORY.md업데이트 - 월간(Monthly): 컨텍스트 파일 리뷰 및 최적화
- 분기별(Quarterly: 전체 구조 리팩토링
성능 최적화
- 캐시 구간(
<!-- CACHE BREAKPOINT -->)을 활용한 불필요 토큰 낭비 방지 - 문서 중복 방지 및 요약(Summarization) 기법 적용
- 대규모 코드베이스(100k+ 라인)도 처리 가능한 계층적 문맥 구조 지원
라이선스
Ani Code 프로젝트는 MIT 라이선스로 공개 및 배포되고 있습니다. 상업적 사용과 수정, 배포가 자유롭게 허용됩니다.
Ani Code GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 