터미널에서 자연어로 코드를 읽고 고치고 명령을 실행해주는 중국어 주석 기반 AI 코딩 에이전트 CLI
중간맛 분석
CodeAgent는 터미널에서 자연어 지시로 파일을 읽고 고치고, 명령을 실행하고, 웹 자료를 찾아오는 AI 코딩 에이전트 도구다. 에 따르면 git 후 uv sync로 의존성을 설치하고, DeepSeek/OpenAI/Anthropic/OpenRouter/ZhipuAI 중 하나의 키를 환경변수나 설정 파일(~/.codeAgent/settings.json)에 넣으면 uv run python main.py로 바로 실행할 수 있다. 위험한 명령 실행 전 승인 패널, MCP 외부 도구 연동, 대화 기록에서 재사용 가능한 스킬을 뽑아내는 자기학습 파이프라인, 서브에이전트·팀 모드·워크플로우 엔진 같은 협업·자동화 기능, 분급 컨텍스트 압축 등을 갖추고 있다. Windows를 우선 지원하고 Linux도 동작하며, macOS는 이론상 동작하나 검증이 충분하지 않다고 명시되어 있다.
이런 레포예요
이럴 때 쓰면 좋아요
- 개발자가 터미널에서 자연어로 코드 읽기·수정·명령 실행을 맡기고 싶을 때
- AI 에이전트 개발을 공부하려는 사람이 중국어 주석으로 쓰인 전체 구현을 교재처럼 읽을 때
- 반복되는 작업을 '기술'로 저장해 다음에 재사용하고 싶은 사용자
핵심 기능
대안 대비 차별점
Claude Code와 비슷한 터미널 경험을 중국어 주석으로 처음부터 직접 구현한 오픈소스 에이전트로, 코드 자체가 Agent 개발 학습 자료로 쓰일 수 있다는 점이 다르다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.11 이상
- uv 패키지 매니저
- DeepSeek/OpenAI/Anthropic/OpenRouter/ZhipuAI 중 하나의 API 키
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/Harvil1/codeAgent.git && cd codeAgent && uv sync && uv run python main.py
uv가 없다면: brew install uv
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- uv 패키지 매니저를 설치한다 (Windows는 PowerShell, macOS/Linux는 curl 스크립트 중 자신의 환경에 맞는 것 하나만 실행)\n
bash\n# Windows (PowerShell)\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n\n# macOS / Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n\n2. 저장소를 내 컴퓨터로 복제하고 의존성을 설치한다\nbash\ngit clone https://github.com/Harvil1/codeAgent.git\ncd codeAgent\nuv sync\n\n\n3. 사용할 LLM 제공사의 API 키를 환경변수로 설정한다 (해당하는 것 하나만)\nbash\n# 예: DeepSeek, OpenAI, Anthropic, OpenRouter, ZhipuAI 중 하나\nexport DEEPSEEK_API_KEY=여기에_키_입력\n\n\n4. 프로그램을 실행한다 (대화형 모드 또는 최근 세션 이어서 시작)\nbash\nuv run python main.py # 대화형 모드\nuv run python main.py -c # 최근 세션 자동 복원\n
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try Harvil1/codeAgent
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「LLM 도구·RAG」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/Harvil1/codeAgent)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기