Note

Automation

CodeQL

CodeQL은 GitHub Actions로 손쉽게 적용할 수 있는 코드 분석 도구입니다.
코드의 취약점을 찾아내고, 코드 품질을 더 향상시키는 데 도움을 줍니다. 원래는 PR 생성마다 CodeQL을 트리거하는 방식을 많이 채용했지만, 주기적 실행으로도 충분하다고 판단하여 조정 중입니다.

• Private 저장소에서는 유료 결제를 해야 사용 가능합니다.
• 권한 문제로 인해 내부 GITHUB_TOKEN을 사용할 경우 PR 생성 이벤트 등으로는 CodeQL이 트리거되지 않을 수 있습니다. 이는 의도된 사항이며, PAT을 사용하는 것을 권장합니다.¹

AI Code Assistant

Gemini CLI

Gemini CLI는 Google에서 터미널을 통해 Gemini를 사용하고 코딩 등의 작업에 활용할 수 있도록 지원하는 CLI 도구입니다.

현 시점 매일 1000번의 Request가 무료이기 때문에 비용 면에서 매우 매력적이지만,
다른 AI 서비스에 비해 성능이 떨어지고 무엇보다 기존 코드베이스를 지키지 않는 경우가 많아 사용이 어려웠습니다.

현재 Gemini CLI를 사용 중인 케이스는 다음과 같습니다.

1. 처음부터 PoC나 MVP를 만들 때: 지켜야 할 코드베이스가 없기 때문에 어느 정도 역할을 할 수 있습니다.
2. 매우 간단한 작업

그 외에도 Gemini CLI를 Claude Code에 MCP 서버로 연결해서 일부 작업을 Gemini에 위임하는 방법도 있다고 합니다.²

:::warning 주의할 점

최근에 Gemini CLI나 기타 AI 기능을 사용하면 Google에서 자체적으로 프로젝트를 만드는 것으로 보입니다.³
해당 프로젝트는 사용자가 관리할 수 없는 프로젝트입니다. 아직까지 과금이 되지는 않았지만, 유심히 관찰하고 있습니다.

:::

Claude Code

Claude Code는 Anthropic에서 제공하는 코딩 도구입니다.
현존하는 모든 AI 코딩 도구 중 가장 성능이 좋고, 그냥 써도 체감 효과가 큽니다.
저도 현재는 전방위적으로 Claude Code를 사용하고 있습니다.

아래는 추가적으로 유용하다고 생각하는 기능입니다.

1. ccusage
   • Claude Code 사용량을 추적합니다. 현재 세션의 사용량과 잔여 한도도 확인할 수 있습니다. Claude Code에서 직접 제공하는 기능은 아니지만 매우 유용합니다.
   • 다만, Claude Code 기록이 로컬에 기록되기 때문에 서로 다른 기기에서 사용할 경우 비용은 따로 계산됩니다.
2. Subagent
   • 자주 사용하는 시스템 프롬프트를 저장해 두고 호출하는 방식으로 사용할 수 있습니다.
   • 반복 작업이나 자동화에 효과적입니다. 개인적으로 업무에서 조금 더 유용했습니다.
   • 필요한 경우 다른 사람이나 팀원들에게 공유할 수도 있습니다.
   • 이 Repository에서 예시를 확인할 수 있습니다.

효과적이라 생각했던 것

• 복잡한 로그 분석
• 단순하고 명료한 반복 작업
• 테스트 코드 작성, TDD
• 문서와 설명 초안

직접 해야 한다고 느꼈던 것

• 지속적인 프롬프트 최적화
• 복잡하고, 고유해서 참고자료가 적은 비즈니스 로직
• 리팩토링, 구조 개선
  • 어느 정도 해 놓으면 AI에게 잔업을 맡길 수도 있습니다.
  • 고통스러운 작업이지만 해 두면 생산성이 올라간다고 생각합니다.

오픈소스 라이센스

오픈소스를 사용할 때는 반드시 라이선스를 확인하고, 해당 라이선스에 위반되는 내용이 없어야 합니다. 일반적으로 많이 사용되는 MIT, Apache 2.0 라이선스는 비교적 자유로운 사용이 가능하며, 소스코드 공개 의무가 없습니다.

반면, GPL 계열 라이선스는 프로그램을 배포할 경우 소스코드를 공개해야 하는 조건이 있습니다.
특히 AGPL 라이선스는 이에 더해 네트워크를 통해 서비스 형태로 제공하는 경우에도 소스코드를 공개해야 하므로 주의가 필요합니다.

대표적인 AGPL 기반 라이센스를 사용하는 오픈소스는 Ghostscript, Grafana, MongoDB가 있습니다. 보통 이러한 오픈소스가 필요할 경우, 사용자에게 직접 설치를 요구하고, 이를 CLI 등으로 호출하여 AGPL을 위반하지 않고 사용할 수 있습니다.

본인의 프로젝트가 오픈소스 라이센스를 올바르게 준수하고 있는지 확인하고 싶다면, OLIVE Platform을 사용해 보는 것을 추천합니다.
설정 파일을 통해 라이센스를 스캔하고, 보고서와 고지문까지 생성할 수 있습니다.