aichat을 활용하면 OpenAI API를 쉽게 연동하여 사용할 수 있습니다. 이 가이드는 설치부터 기본적인 사용법까지 단계적으로 안내합니다. 특히 맥OS 환경을 기준으로 하여 CLI에서 실무 활용을 중점적으로 다룹니다.
aichat 설치 및 기본 설정 과정
1. aichat 설치
최초로 해야 할 작업은 aichat 프로그램을 설치하는 것입니다. Homebrew를 활용하여 간단하게 설치할 수 있습니다. 아래의 명령어를 터미널에 입력하여 설치를 진행합니다.
brew install aichat
설치가 완료되면 설치가 정상적으로 되었는지 확인하는 것이 좋습니다. 다음 명령어를 입력하여 aichat의 버전을 확인할 수 있습니다.
aichat --version
2. OpenAI API Key 설정
OpenAI API를 사용하기 위해서는 API 키를 설정해야 합니다. 이 과정은 가장 중요한 단계입니다. 아래 방법 중 하나를 선택하여 API 키를 설정하면 됩니다.
방법 A: 환경변수 설정 (권장)
다음 명령어를 통해 API 키를 환경 변수로 설정합니다. 이를 통해 aichat이 API 키를 인식할 수 있게 됩니다.
export OPENAI_API_KEY="sk-xxxx"
이 설정을 영구적으로 적용하고 싶다면 다음 명령어를 사용하여 ~/.zshrc 파일에 추가합니다.
echo 'export OPENAI_API_KEY="sk-xxxx"' >> ~/.zshrc
source ~/.zshrc
OpenAI 모델 설정 및 기본 사용법
3. OpenAI 모델 지정
aichat은 provider와 model의 조합으로 작동합니다. 기본 설정을 위해 아래의 명령어를 입력하여 OpenAI를 provider로 설정합니다.
aichat config set provider openai
모델을 지정하는 방법은 다음과 같습니다. 예를 들어, gpt-4.1-mini 모델을 지정할 수 있습니다.
aichat config set model gpt-4.1-mini
설정이 제대로 되었는지 확인하려면 아래 명령어를 입력합니다.
aichat config list
4. 기본 사용법
aichat의 가장 간단한 사용법은 단발성 질문을 하는 것입니다. 아래 예시처럼 명령어를 입력하여 AI에게 질문해 보세요.
aichat "Explain WMAPE with a simple example"
대화형 모드에서도 활용할 수 있습니다. 다음과 같이 입력하면 대화가 시작됩니다.
aichat
이후 AI와의 대화를 진행할 수 있습니다.
CLI에서의 고급 활용법
5. stdin 파이프 사용
aichat은 stdin 파이프를 통해 강력하게 활용될 수 있습니다. 예를 들어, 로그 파일을 분석할 때 다음과 같이 사용할 수 있습니다.
cat error.log | aichat "이 로그의 원인과 해결책 설명"
또한, 코드 리뷰 및 SQL 성능 분석에도 활용할 수 있습니다.
git diff | aichat "코드 리뷰해줘. 성능/가독성 위주"
cat query.sql | aichat "이 SQL 성능 병목 분석"
6. 실무에서 유용한 옵션들
aichat 사용 시 다양한 옵션을 활용하여 보다 효과적인 결과를 얻을 수 있습니다.
시스템 프롬프트 지정:
aichat -s "You are a senior data engineer" "Explain Iceberg compaction strategy"출력 짧게 설정:
aichat -s "Answer briefly" "Explain L1 vs L2 loss"형식 유지:
aichat --format "Summarize this document"
프롬프트 템플릿화 및 비용 관리
7. 프롬프트 템플릿화
자주 사용하는 프롬프트를 템플릿으로 만들어 두면 효율적입니다. 아래와 같은 alias 예시를 통해 쉽게 설정할 수 있습니다.
alias llm-review='aichat -s "You are a senior reviewer. Be strict."'
alias llm-explain='aichat -s "Explain step by step in simple terms."'
alias llm-fix='aichat -s "Fix bugs and improve code quality."'
이후 아래와 같이 간편하게 사용할 수 있습니다.
git diff | llm-review
cat dag.py | llm-explain
8. 비용 및 토큰 관련 팁
aichat은 사용한 토큰의 양을 직접 보여주지 않기 때문에 OpenAI 대시보드에서 사용량을 확인해야 합니다. 긴 로그나 파일을 처리할 경우 다음과 같이 요약할 수 있습니다.
tail -n 200 error.log | aichat "요약"
문제 해결 및 추천 조합
9. 자주 발생하는 문제
사용 중에 발생할 수 있는 몇 가지 일반적인 문제를 미리 알고 대비하는 것이 좋습니다.
No API key provided: 이 경우 OPENAI_API_KEY 환경변수를 확인해야 합니다.
echo $OPENAI_API_KEY모델 오류 발생 시, 아래 명령어로 모델을 재설정합니다.
aichat config set model gpt-4.1-mini
10. 추천 실전 조합
실무에서 자주 사용하는 조합을 아래와 같이 정리할 수 있습니다.
로그 분석:
kubectl logs pod | aichat "원인 분석 + 조치"Spark SQL 최적화:
cat query.sql | aichat "Spark 기준으로 최적화 포인트"Iceberg 테이블 설계 리뷰:
cat ddl.sql | aichat "Iceberg 테이블 설계 리뷰"
이 가이드를 통해 aichat을 보다 효과적으로 활용할 수 있기를 바랍니다. 다양한 실전 예제를 통해 필요한 작업을 간편하게 수행해 보세요.