Kimi K2로 내 서버 개발을 맡겨봤다 — CLI 협업 최적화 가이드
요즘 AI 코딩 어시스턴트를 로컬이 아닌 실서버 터미널에서 돌리는 분들이 늘고 있습니다. 저도 운영 중인 블로그 서버에 Kimi Code CLI를 붙여서 몇 주간 함께 개발해봤는데, 그 과정에서 정리한 실전 협업 노하우를 공유합니다.
1. Kimi Code CLI란?
Kimi Code CLI는 서버 터미널 환경에서 실행되는 AI 코딩 어시스턴트입니다.
작업 기준 디렉토리(예: /home/xxx/web/xxx.com/public_html)를 지정하면, 그 아래의 파일을 직접 읽고 수정할 수 있습니다.
기본 동작 방식은 이렇습니다.
- 자연어로 요청하면 코드, 명령, 문서 작업을 수행합니다.
- 파일은
ReadWriteEdit도구로 직접 수정합니다. - 서버 명령은
Bash도구로 실행합니다. - 코드 탐색은
GlobGrep으로 빠르게 찾습니다. - 긴 작업은
Agent로 하위 작업자에게 위임할 수 있습니다.
한마디로 "서버 안에 상주하는 개발 파트너"라고 보면 됩니다.
2. 실제로 어떤 작업을 시킬 수 있나?
코드 개발
- 신규 기능 작성, 기존 기능 수정, 리팩토링
- 버그 원인 분석 및 수정
- PHP 문법 검사(
php -l), 간단한 실행 테스트 - CSS/JS 캐시 버전 관리
- DB 마이그레이션 파일 검토와 작성
코드 탐색과 분석
Grep: 특정 문자열이나 패턴 검색Glob: 파일 목록 조회Read: 파일 내용 읽기- 탐색 전용 Agent : 대규모 코드베이스 분석
문서화
- README, 매뉴얼, 설계 문서 작성과 갱신
- 주석, PHPDoc, CHANGELOG 작성
- 변경 이력과 체크리스트 정리
서버 운영 자동화
- 로그 확인, 권한 확인, 백업 스크립트 실행
- Cron으로 정기 작업 예약 (매일 백업, 캐시 갱신, 로그 정리 등)
- 백그라운드 작업 관리
Git (조회 위주)
git status git log git diff 같은 상태 확인은 자유롭게 시킬 수 있습니다.
단, commit push reset rebase 같은 변경 작업은 명시적 승인 없이는 실행하지 않도록 약속해두는 게 안전합니다.
3. 자주 쓰는 서버 워크플로우
PHP 문법 검사
php -l admin/write.php
php -l admin/settings.php여러 파일을 한 번에 검사할 수도 있습니다.
for f in admin/*.php themes/xxx/*.php; do php -l "$f"; done파일과 문자열 검색
# 파일 이름 검색
find admin -name "*.php"
# 내용 검색
grep -R "var(--text-inverse)" admin/assets themes/xxx/style.css
# Git 상태 확인
git status
git diff --statCSS/JS 캐시 버전 관리
파일을 수정하면 반드시 ?v= 뒤 숫자를 올려야 브라우저가 새 파일을 불러옵니다.
이걸 빼먹으면 "수정했는데 왜 안 바뀌지?"의 90%가 여기서 나옵니다.
<link rel="stylesheet" href="assets/admin.css?v=22">
<link rel="stylesheet" href="themes/xxx/style.css?v=16">로그 확인
sudo tail -f /var/log/apache2/error.log
tail -f /home/xxx/web/xxx.com/public_html/data/app.log4. 장점 정리
| 장점 | 설명 |
|---|---|
| 빠른 탐색 | 수백 개 파일 중에서도 검색 도구로 즉시 찾아냅니다. |
| 동시 수정 | 여러 파일을 한 번에 읽고 수정할 수 있습니다. |
| 반복 작업 자동화 | 문법 검사, 캐시 버전 갱신, 정규식 일괄 교체를 자동 처리합니다. |
| 24시간 가동 | 피로 없이 긴 작업도 이어갈 수 있습니다. |
| 문서화 동반 | 코드 수정과 동시에 매뉴얼과 설계 문서를 갱신합니다. |
| 다양한 언어 | PHP, JavaScript, CSS, SQL, Python 등을 다룹니다. |
5. 한계도 분명히 있다
| 한계 | 설명 |
|---|---|
| 물리 서버 접근 불가 | 물리적 재부팅, OS 레벨 설정 변경은 못합니다. |
| 디렉토리 제한 | 작업 디렉토리 외부 파일은 원칙적으로 접근하지 않습니다. |
| 인터넷 제한 | 검색과 페이지 조회만 가능하고, 로그인 필요 사이트는 접근 불가입니다. |
| 긴 작업 분리 필요 | 30분 이상 작업은 Agent나 백그라운드로 나눠야 합니다. |
| 브라우저 확인 불가 | UI 변경 후 실제 렌더링은 사람이 직접 확인해야 합니다. |
| 전략 판단 한계 | "어떤 기능을 만들까"는 사람이 결정하고, AI는 구현을 돕는 역할입니다. |
| 민감 정보 차단 | .env, SSH 키, 비밀번호 파일은 읽을 수 없습니다. |
6. 협업 품질을 끌어올리는 6가지 팁
① 요청은 구체적으로
- ❌ "UI 좀 예쁘게 해줘"
- ✅ "글 관리 페이지의 테이블 행 구분선을 더 진하게 해줘. 파일은 admin/assets/admin.css야."
② 완료 기준을 함께 제시
"수정 후 php -l이 통과하고, 모바일에서도 버튼이 잘 보여야 해" 처럼
끝난 상태를 정의해주면 결과물 품질이 확 달라집니다.
③ 작업 단위를 작게
한 번에 3~5개 메뉴 정도씩 끊어서 요청하는 것이 품질이 높습니다.
④ 캐시, 테스트, 문서를 세트로
- CSS/JS 수정 후 →
?v=숫자 올리기 요청 - PHP 수정 후 →
php -l검증 요구 - 기능 변경 시 → 매뉴얼 문서 갱신도 함께 요청
⑤ 불확실하면 바로 질문
"이 기능이 이미 있는지 모르겠어" 라고 하면 AI가 먼저 탐색한 뒤 답합니다. 추측 코딩을 막는 가장 쉬운 방법입니다.
⑥ 긴 작업은 백그라운드로
대량 데이터 처리나 긴 마이그레이션은 백그라운드로 돌리고 결과만 보고받으세요.
7. 복붙해서 쓰는 요청 템플릿
[목표]
OOO 기능을 추가/수정하고 싶다.
[파일/메뉴]
admin/xxx.php, admin/assets/admin.css
[완료 기준]
1. php -l 통과
2. 모바일/PC 모두 정상 표시
3. manual.md에 설명 추가
[참고]
* 현재는 이렇게 동작한다.
* 이렇게 바꾸고 싶다.이 템플릿 하나만 써도 재작업 횟수가 눈에 띄게 줄어듭니다.
8. 위험 작업은 반드시 확인 절차를
아래 작업은 AI가 자동 실행하지 않고 반드시 사용자 확인을 받도록 규칙을 정해두세요.
git commitgit pushgit resetgit rebaserm -rf등 대량 삭제- DB 테이블 삭제와 초기화
- 외부 API 키와 비밀번호 변경
- 서비스 재시작, 방화벽 변경
실서버에서 AI와 협업할 때 가장 중요한 안전장치입니다.
마무리
AI 코딩 어시스턴트는 "시키면 다 해주는 마법"이 아니라 잘 브리핑하면 잘 일하는 동료에 가깝습니다. 핵심은 세 가지입니다.
- 구체적인 요청 + 완료 기준
- 작은 작업 단위 + 즉시 검증
- 위험 작업은 사람이 최종 승인
이 세 가지만 지켜도 서버 개발 생산성이 확실히 달라집니다. 여러분도 서버에 AI 파트너 하나 들여보시는 건 어떨까요?
댓글 0