CodebuffAI/codebuff

English | 简体中文

Codebuff는 자연어 지시를 통해 코드베이스를 편집하는 오픈 소스 AI 코딩 어시스턴트 (AI coding assistant)입니다. Freebuff는 무료이며 광고 기반 버전으로, 구독, 크레딧, 설정이 필요 없습니다.

모든 작업에 하나의 모델을 사용하는 대신, Codebuff는 프로젝트를 이해하고 정밀한 변경을 수행하기 위해 함께 작동하는 전문화된 에이전트 (agents)들을 조율합니다.

Codebuff는 실제 작업을 시뮬레이션하는 여러 오픈 소스 리포지토리 (open-source repos)에 걸친 175개 이상의 코딩 작업에 대한 평가 (evals)에서 Claude Code를 61% 대 53%로 앞섭니다.

Codebuff에게 "내 API에 인증을 추가해줘"라고 요청하면, 다음과 같은 에이전트들을 호출할 수 있습니다:

• 아키텍처를 이해하고 관련 파일을 찾기 위해 코드베이스를 스캔하는 File Picker Agent
• 어떤 파일이 어떤 순서로 변경되어야 하는지 계획하는 Planner Agent
• 정밀한 편집을 수행하는 Editor Agent
• 변경 사항을 검증하는 Reviewer Agent

이러한 멀티 에이전트 (multi-agent) 접근 방식은 단일 모델 (single-model) 도구와 비교했을 때 더 나은 컨텍스트 (context) 이해, 더 정확한 편집, 그리고 더 적은 오류를 제공합니다.

설치:

npm install -g codebuff

실행:

cd your-project
codebuff

그 다음 Codebuff에게 원하는 것을 말하기만 하면 나머지는 Codebuff가 처리합니다:

• "사용자 등록 과정의 SQL 인젝션 (SQL injection) 취약점을 수정해줘"
• "모든 API 엔드포인트 (endpoints)에 속도 제한 (rate limiting)을 추가해줘"
• "더 나은 성능을 위해 데이터베이스 연결 코드를 리팩터링 (Refactor)해줘"

Codebuff는 적절한 파일을 찾고, 코드베이스 전체에 걸쳐 변경을 수행하며, 아무것도 망가지지 않았는지 확인하기 위해 테스트를 실행합니다.

자신만의 에이전트를 구축하기 시작하려면, Codebuff를 실행하고 /init 명령어를 실행하세요:

codebuff

그 다음 CLI 내부에서:

/init

이렇게 하면 다음 항목들이 생성됩니다:

knowledge.md # Codebuff를 위한 프로젝트 컨텍스트 (Project context)
.agents/
└── types/ # TypeScript 타입 정의 (TypeScript type definitions)
...

에이전트 동작을 최대한 제어할 수 있는 에이전트 정의 파일을 작성할 수 있습니다.

도구 (tools), 생성될 수 있는 에이전트, 그리고 프롬프트 (prompts)를 지정하여 워크플로 (workflows)를 구현하세요. 더 프로그래밍적인 제어를 위해 TypeScript 제너레이터 (generators)도 제공합니다.

예를 들어, 여기 git-committer가 있습니다.

현재 Git 상태를 기반으로 Git 커밋을 생성하는 에이전트입니다. 변경 사항을 분석하기 위해 git diff와 git log를 실행하지만, 의미 있는 커밋 메시지를 작성하고 실제 커밋을 수행하는 제어권은 LLM (Large Language Model)에 넘긴다는 점에 주목하세요.

export default {
id: 'git-committer',
displayName: 'Git Committer',
...

SDK 패키지를 설치하세요 -- 이는 CLI codebuff 패키지와는 다르다는 점에 유의하세요.

npm install @codebuff/sdk

클라이언트를 임포트(Import)하고 에이전트를 실행하세요!

import { CodebuffClient } from '@codebuff/sdk'
// 1. 클라이언트 초기화
const client = new CodebuffClient({
...

SDK에 대한 자세한 내용은 여기에서 확인하세요.

구독을 원하지 않으시나요? Freebuff는 Codebuff의 무료 버전입니다 — 구독도, 크레딧도, 설정도 필요 없습니다. 그저 설치하고 코딩을 시작하세요.

npm install -g freebuff
cd your-project
freebuff

Freebuff는 광고 기반으로 운영되며, 빠르고 고품질의 지원에 최적화된 모델을 사용합니다. 내장된 웹 리서치(Web research), 브라우저 사용(Browser use) 기능 등을 포함하고 있습니다. 자세한 내용은 Freebuff README에서 확인하세요.

커스텀 워크플로우 (Custom workflows): TypeScript 제너레이터 (generators)를 사용하면 AI 생성과 프로그래밍 방식의 제어를 결합할 수 있습니다. 에이전트는 하위 에이전트 (subagents)를 생성하고, 조건에 따라 분기하며, 다단계 프로세스를 실행할 수 있습니다.

OpenRouter의 모든 모델: Anthropic의 모델으로 제한되는 Claude Code와 달리, Codebuff는 Claude와 GPT부터 Qwen, DeepSeek 등과 같은 특화된 모델까지 OpenRouter에서 사용 가능한 모든 모델을 지원합니다. 작업에 따라 모델을 전환하거나 플랫폼 업데이트를 기다리지 않고 최신 모델을 사용할 수 있습니다.

게시된 모든 에이전트 재사용: 기존에 게시된 에이전트들을 조합하여 도움을 받으세요. Codebuff 에이전트는 새로운 MCP (Model Context Protocol)입니다!

SDK: Codebuff를 여러분의 애플리케이션에 구축하세요. 커스텀 도구를 만들거나, CI/CD와 통합하거나, 제품에 코딩 지원 기능을 내장할 수 있습니다.

/init 명령어를 사용하여 특화된 워크플로우를 가진 자신만의 에이전트를 만드세요:

codebuff
/init

이렇게 하면 사용자가 맞춤 설정할 수 있는 .agents/ 디렉토리에 커스텀 에이전트 구조가 생성됩니다.

우리는 커뮤니티의 기여를 ❤️ 환영합니다. 버그를 수정하거나, 에이전트 (agents)를 미세 조정하거나, 문서 (documentation)를 개선하는 것 모두 포함됩니다.

기여하고 싶으신가요? 시작하려면 기여 가이드 (Contributing Guide)를 확인하세요.

테스트 스위트 (test suite)를 실행하려면:

cd cli
bun test

**대화형 E2E 테스트 (interactive E2E testing)**를 위해서는 tmux를 설치하세요:

# macOS
brew install tmux
# Ubuntu/Debian
...

포괄적인 테스트 문서 (testing documentation)에 대해서는 cli/src/tests/README.md를 참조하세요.

도움을 주실 수 있는 몇 가지 방법:

• 🐛 버그 수정 (Fix bugs) 또는 기능 추가
• 🤖 특화된 에이전트 (specialized agents) 생성 및 에이전트 스토어 (Agent Store)에 게시
• 📚 문서 (documentation) 개선 또는 튜토리얼 작성
• 💡 GitHub Issues에 아이디어 공유

CLI: npm install -g codebuff

SDK: npm install @codebuff/sdk

Freebuff (free): npm install -g freebuff

문서 (Documentation): codebuff.com/docs

커뮤니티 (Community): Discord

이슈 및 아이디어 (Issues & Ideas): GitHub Issues

기여 (Contributing): CONTRIBUTING.md - 기여를 시작하려면 여기서부터 시작하세요!

지원 (Support): support@codebuff.com