터미널에서 사용할 수 있는 무료 자율 코딩 에이전트를 만들었습니다 — API 키는 직접 준비하세요
요약
사용자의 API 키를 활용하여 비용 부담 없이 터미널에서 실행할 수 있는 자율 코딩 에이전트 'Codeably'를 소개합니다. 자연어 명령을 통해 코드 작성, 테스트 생성, 리팩토링 및 AI 코드 리뷰를 수행하며 다양한 LLM 제공업체를 지원합니다.
핵심 포인트
- 사용자 API 키를 직접 사용하여 추가 구독 비용 없이 이용 가능
- Observe-Think-Act-Verify-Done 루프를 통한 자율적 작업 수행
- Groq, Gemini, Ollama 등 다양한 모델 제공업체 지원
- 터미널 기반의 간편한 CLI 명령 및 채팅 UI 제공
저는 AI 코딩 도구에 매달 20달러를 지불하는 것에 지쳤습니다. 그래서 직접 만들었습니다.
Codeably는 여러분의 터미널에서 실행되는 자율 코딩 에이전트 (autonomous coding agent)입니다. 여러분의 API 키를 직접 가져와 사용하므로, 실행 비용은 0달러입니다.
기능
여러분이 평이한 영어로 작업을 설명하면, 에이전트가 무엇을 해야 할지 파악하고 실행합니다:
codeably "express 앱에 JWT 인증 추가하기"
codeably "src/utils.js의 모든 함수에 대한 단위 테스트 (unit tests) 작성하기"
codeably "모든 데드 코드 (dead code)를 찾아서 제거하기"
codeably "payment.js의 레이스 컨디션 (race condition) 수정하기"
codeably clean # 스캔 + 데드 코드 자동 제거
codeably review # git 변경 사항에 대한 AI 코드 리뷰
codeably chat # 전체 터미널 채팅 UI 열기
이 도구는 작업이 완료될 때까지 관찰(Observe) → 생각(Think) → 행동(Act) → 검증(Verify) → 완료(Done)의 루프를 실행합니다.
지금 바로 사용해 보세요 (설치 불필요)
npx codeably "여기에 작업 입력"
또는 전역(globally)으로 설치하세요:
npm install -g codeably
7개의 제공업체 — 대부분 무료 티어 (free tiers) 제공
여러분의 키를 연결하기만 하면 됩니다. 사용 가능한 목록은 다음과 같습니다:
| 제공업체 (Provider) | 모델 (Model) | 무료 티어 (Free tier) |
|---|---|---|
| Groq | Llama 3.3 70B | ✅ 하루 14,400회 요청 무료 |
| Gemini | Gemini 2.0 Flash | ✅ 하루 1,500회 요청 무료 |
| Ollama | CodeLlama (로컬) | ✅ 무제한 무료 오프라인 |
| OpenRouter | 100개 이상의 모델 | ✅ 무료 모델 사용 가능 |
| Anthropic | Claude Sonnet 4 | 가입 시 5달러 크레딧 |
| Mistral | Mistral Large | 무료 체험 크레딧 |
| OpenAI | GPT-4o | 사용량만큼 지불 (pay per use) |
저는 개인적으로 일상 업무에 Groq를 사용합니다. 빠르고 무료이며, Llama 3.3 70B 모델은 코딩 실력이 정말 뛰어납니다.
⚡ codeably 대신 cb 입력하기
한 번의 명령으로 설정하는 단축키:
macOS / Linux / WSL:
bash install-shortcut.sh
source ~/.zshrc
cb "작업 내용"
Windows PowerShell:
.\install-shortcut.ps1
. $PROFILE
cb "작업 내용"
터미널 채팅 UI
codeably chat
# 또는
cb chat
터미널에서 바로 전체 채팅 UI를 엽니다:
╭────────────────────────────────────────────────────────────╮
│ >/< codeably chat │
│ groq · llama-3.3-70b-versatile │
│ type /help for commands │
╰────────────────────────────────────────────────────────────╯
❯ explain how async/await works
Async/await는 Promise (프로미스)를 기반으로 구축된 문법적 설탕 (syntactic sugar)입니다...
❯ /switch ← 대화 도중 제공자 (provider) 전환
❯ /history ← 대화 기록 보기
❯ /save ← 채팅을 파일로 저장
❯ /clear ← 새로 시작
❯ _
마크다운 렌더링 (markdown rendering), 대화 기록, 그리고 /switch를 통한 실시간 제공자 전환을 지원합니다.
30개의 도구
파일 I/O, 셸 명령 (shell commands), git 작업, 코드 검색, 데드 코드 탐지 (dead code detection) — 총 30개의 도구. 주요 기능은 다음과 같습니다:
patch_file — 안전한 문자열 치환 (전체 재작성 없음)
grep_replace — 여러 파일에 걸친 찾기 및 바꾸기
git_commit — 모든 변경 사항을 스테이징하고 메시지와 함께 커밋
confirm_delete — 무엇인가를 삭제하기 전에 항상 확인 요청
detect_language — 프로젝트의 스택을 자동 감지
run_script — 여러 줄의 bash 스크립트 작성 및 실행
안전 우선
Codeably는 사용자의 명시적인 승인 없이 파일을 삭제할 수 없습니다. 모든 삭제는 confirm_delete를 거칩니다:
⚠ 삭제 확인 필요
이유: 사용되지 않는 파일, 임포트(import) 감지되지 않음
삭제할 파일:
- src/old-utils.js
- src/deprecated/auth.js
이 2개의 파일을 삭제하시겠습니까? [y/N]:
구축 방식
프레임워크 없음. LangChain 없음. 마법 같은 요소 없음.
약 900줄의 순수 Node.js (vanilla Node.js). 7개의 모든 제공자와 호환되는 하나의 OpenAI 호환 클라이언트. 단순한 루프. 30개의 도구 정의.
codeably/
├── codeably.js ← CLI 진입점 + 모든 명령
├── runtime/
│ ├── agent.js ← 관찰-생각-행동 (Observe-Think-Act) 루프
│ ├── client.js ← 통합 LLM 클라이언트
│ └── context.js ← 코드베이스 스냅샷
├── tools/
│ └── index.js ← 30개 도구 전체
└── ui/
├── renderer.js ← 터미널 UI
└── chat.js ← 터미널 채팅 UI
실제 예시
bash# 기능 추가
codeably "add rate limiting — 100 req/min per IP"
codeably "add input validation to all API endpoints"
codeably "add TypeScript types to all files in src/"
정리
codeably clean
codeably "remove all console.log from src/"
codeably "migrate from callbacks to async/await in api.js"
테스트
codeably "auth routes에 대한 통합 테스트 (integration tests) 작성해줘"
codeably "React 컴포넌트에 에러 경계 (error boundary) 테스트를 추가해줘"
리팩터링 (Refactor)
codeably "400줄짜리 UserController를 더 작은 파일들로 분할해줘"
codeably "모든 하드코딩된 문자열을 상수 (constants) 파일로 추출해줘"
리뷰 + 문서화 (Review + docs)
codeably review
codeably docs
이것을 만든 이유
내가 시도해 본 모든 AI 코딩 도구들은 동일한 문제를 가지고 있었습니다. 모델에 직접 접근할 수 있음에도 불구하고, 그 모델을 사용하기 위해 구독료를 지불하고 있다는 점입니다. 도구는 그저 래퍼 (wrapper)일 뿐입니다.
그래서 제가 직접 그 래퍼를 작성했습니다. 약 일주일 정도 걸렸습니다. 이제 저는 이것을 매일 사용하며, Groq의 무료 티어 (free tier)만으로도 충분하기 때문에 비용이 전혀 들지 않습니다.
목표는 언제나 명확했습니다: 당신의 키를 직접 가져오고 (bring your own key), 당신의 에이전트를 소유하는 것.
GitHub: https://github.com/adamyasingh-05/Codeably
설치: npm install -g codeably
피드백을 환영합니다 — 어떤 기능이 추가된다면 여러분의 워크플로우 (workflow)에 더 유용할까요?
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기