대부분의 AI 코딩 어시스턴트(AI coding assistants)는 사용자를 하나의 모델과 하나의 워크플로(workflow)에 종속시킵니다. Codient는 다른 접근 방식을 취합니다. 이는 Claude, ChatGPT, Gemini, DeepSeek를 실제 웹 세션(web sessions)을 통해 구동하는 커맨드 라인 도구(command-line tool)입니다. 따라서 이미 보유하고 있는 계정을 사용하고, 작업별로 모델을 전환하며, 코드베이스(codebase)에서 무엇이 변경될지에 대해 완전한 제어권을 유지할 수 있습니다.

두 가지 파트로 구성되어 제공됩니다:

• codient — 핵심 Python CLI
• codient-vscode — CLI를 에디터 명령어로 감싸는 VSCode 확장 프로그램(extension)

프로젝트 사이트: codient.ir

왜 Codient인가?

코드를 유료 API를 통해 라우팅하는 대신, Codient는 AI의 웹 UI를 대상으로 실제 브라우저 세션(Selenium을 통해)을 자동화합니다. 이는 다음을 의미합니다:

• 기존의 Claude / ChatGPT / Gemini / DeepSeek 로그인을 그대로 사용 — API 키가 필요 없음
• 서로 다른 계정을 위해 **별도의 Chrome 프로필(Chrome profiles)**을 유지할 수 있음 (예: 업무용 Claude 계정 vs 개인용 계정)
• 모든 변경 사항은 전체 롤백 히스토리(rollback history)와 함께 자동으로 백업됨
• 멀티 파일 컨텍스트(Multi-file context) 및 멀티 라운드 후속 요청(multi-round follow-up requests)이 자동으로 처리됨

핵심 기능

• 🤖 멀티 모델 지원: Claude, ChatGPT, Gemini, DeepSeek
• 📂 멀티 파일 프로젝트 분석
• 💾 자동 백업 기능이 포함된 안전한 덮어쓰기 모드
• 🔄 파일 히스토리 및 한 번의 명령으로 수행하는 롤백(rollback)
• 📊 변경 사항을 확정하기 전 시각적인 HTML diff 보고서 제공
• 🐛 전체 프롬프트/응답 로깅을 포함한 디버그(Debug) 모드
• 🌐 HTTP/SOCKS5 프록시(proxy) 지원
• 👤 여러 개의 격리된 Chrome 프로필
• 🔁 AI가 더 많은 파일이 필요할 때 자동 수행되는 멀티 라운드 대화 (최대 5라운드)

작동 방식

CLI 명령
   ↓
Python 엔진
...

CLI 설치하기

요구 사항: Python 3.8 이상, Google Chrome, 그리고 이에 일치하는 ChromeDriver.

git clone https://github.com/hamidsamak/codient.git
cd codient

...

어디에서나 codient를 실행할 수 있도록 PATH에 추가하세요:

mkdir -p ~/.local/bin
cat > ~/.local/bin/codient << EOF
#!/bin/bash
...

WSL Ubuntu를 사용 중이신가요? Chrome/ChromeDriver가 작동하도록 설정하는 전용 WSL 설정 가이드가 있습니다.

첫 로그인

모델을 사용하기 전에, 브라우저 세션을 열고 한 번 로그인하세요. 이 세션은 향후 실행을 위해 저장됩니다:

codient --browser --model claude
codient --browser --model gemini
codient --browser --model chatgpt
...

CLI 사용하기

기본 사용법 (기본 모델은 DeepSeek입니다):

codient "Fix this code" file1.py file2.py

특정 모델 선택:

codient --model claude "Fix this code" app.py

자동 백업과 함께 변경 사항을 직접 적용:

codient --overwrite "Refactor this code" main.py

--context를 사용하여 읽기 전용 참조 파일을 전달하세요. -- 뒤에 오는 모든 것은 수정 가능한 대상입니다:

codient "Improve architecture" --context utils.py config.py -- main.py

--overwrite를 건너뛰면, Codient는 파일을 건드리는 대신 시각적인 HTML diff 보고서를 생성하고 브라우저에서 자동으로 엽니다.

멀티 라운드 대화 (Multi-round conversations)

AI가 작업을 완료하기 위해 더 많은 파일을 확인해야 하는 경우, Codient는 해당 요청을 감지하고 로컬에서 파일을 찾습니다. 만약 파일을 찾을 수 없다면 사용자에게 경로를 요청합니다. AI가 필요한 모든 것을 확보할 때까지 이 과정은 최대 5라운드까지 반복됩니다. --non-interactive 모드(CI 또는 VSCode 확장 프로그램에 유용)에서는 누락된 파일이 자동으로 건너뛰어지며, AI는 사용자에게 프롬프트를 보내는 대신 파일을 처음부터 새로 생성하도록 지시받습니다.

프로필 (Profiles)

다른 계정이나 목적을 위해 별도의 로그인을 유지하세요:

codient --browser --profile work
codient --profile work "Fix this code" app.py
codient --list-profiles

백업 및 롤백 (Backup & rollback)

수정되는 모든 파일은 수정되기 전에 백업됩니다:

codient --rollback main.py
codient --rollback main.py --timestamp 20250101123000

VSCode 확장 프로그램 사용하기

이 확장 프로그램은 동일한 CLI 엔진을 기반으로 하는 얇은 프론트엔드 (front-end)입니다. 설치 후, 명령 팔레트 (Ctrl+Shift+P / Cmd+Shift+P)를 열고 다음을 사용하세요:

• Codient: Ask AI — 자동 백업과 함께 파일을 직접 분석하고 편집합니다.
• Codient: Preview Changes — 위와 동일하지만, 파일을 건드리는 대신 HTML diff (차이점)를 생성합니다.
• Codient: Open Browser Session — 활성 프로필을 위한 지속적인 로그인 세션을 엽니다.
• Codient: Switch Profile — Chrome 프로필 간을 대화형으로 전환하거나, 즉석에서 새 프로필을 생성합니다.

설정 가능한 항목:

확장 프로그램 로컬 빌드하기

npm install -g @vscode/vsce
vsce package
code --install-extension codient-*.vsix

마무리

Codient는 아직 초기 단계이며 활발히 개발 중인 프로젝트입니다. 피드백, 이슈 제보, 그리고 Star는 언제나 환영합니다. 여러 AI 코딩 어시스턴트 (AI coding assistants)를 사용하면서 모든 도구에 걸쳐 일관된 CLI/에디터 워크플로우 (workflow)를 원하신다면, 한 번 사용해 보세요:

• CLI: github.com/hamidsamak/codient
• VSCode 확장 프로그램: github.com/hamidsamak/codient-vscode
• 사이트: codient.ir

설치부터 사용법까지 전체 과정을 다루는