고정 헤더 영역
상세 컨텐츠
본문
728x90
OpenCode 설치 및 세팅 완벽 가이드
OpenCode는 AI 기반 코딩 어시스턴트 도구로, 다양한 AI 모델을 CLI 환경에서 활용할 수 있게 해주는 강력한 플랫폼입니다. 이 가이드에서는 OpenCode의 설치부터 GPT, Google Gemini 연동, 그리고 oh-my-opencode 플러그인 설정까지 전 과정을 다룹니다.
1. OpenCode 설치
OpenCode 설치는 간단한 스크립트 실행으로 완료됩니다.
curl -fsSL https://opencode.ai/install | bash
설치가 완료되면 터미널에서 opencode 명령어를 사용할 수 있게 됩니다.
2. OpenCode 실행 및 기본 설정
설치 후 다음 명령어로 OpenCode CLI 환경에 접속합니다.
opencode
CLI 환경에 진입하면 다양한 명령어를 사용할 수 있습니다.
3. AI 모델 연동하기
3.1 GPT 연동
OpenCode CLI 환경에서 다음 명령어를 실행합니다.
/connect
이 명령어를 실행하면 웹 페이지가 열리며, GPT API 인증 과정을 진행할 수 있습니다. 웹 페이지에서 인증을 완료하면 GPT 모델을 사용할 준비가 완료됩니다.
3.2 Google Gemini 연동
Gemini를 연동하려면 몇 가지 추가 단계가 필요합니다.
1단계: Config 파일 위치 확인
opencode debug paths
이 명령어로 opencode.json 설정 파일의 위치를 확인할 수 있습니다.
2단계: 플러그인 추가
opencode.json 파일을 열고 "plugin": 섹션에 다음 내용을 추가합니다.
"plugin": {
"opencode-gemini-auth@latest"
}
3단계: 재시작 및 인증
파일을 저장한 후 OpenCode를 종료하고 다시 접속합니다.
opencode
이제 Google 웹 페이지 인증이 가능해집니다. 인증 프로세스를 완료하면 Gemini 모델을 사용할 수 있습니다.
4. oh-my-opencode 설치 및 설정
oh-my-opencode는 OpenCode의 기능을 확장하는 플러그인으로, 여러 서브 에이전트를 활용한 강력한 워크플로우를 제공합니다.
4.1 설치
OpenCode CLI 환경에서 다음 명령어를 실행합니다.
Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md
GitHub 저장소: https://github.com/code-yeongyu/oh-my-opencode
4.2 주의사항: Cloud 사용 관련
중요: Cloud 기능은 API 요금제를 사용하지 않는다면 비활성화하는 것이 좋습니다. 예상치 못한 과금이 발생할 수 있으므로 주의가 필요합니다.
4.3 서브 에이전트 설정
설치가 완료되면 oh-my-opencode.json 파일을 수정하여 서브 에이전트의 모델을 설정할 수 있습니다.
권장 설정:
- Sisyphus: GPT-5.2 Codex 버전 사용
- Oracle: GPT-5.2 버전 사용
설정 파일 예시:
{
"subAgents": {
"sisyphus": {
"model": "gpt-5.2-codex"
},
"oracle": {
"model": "gpt-5.2"
}
}
}
설정 완료 후 OpenCode를 종료하고 다시 시작하면 변경사항이 적용됩니다.
5. 유용한 기능 및 팁
5.1 플랜 모드
OpenCode에서 Tab 키를 누르면 플랜 모드로 전환됩니다. 플랜 모드는 복잡한 작업을 단계별로 계획하고 실행하는 데 유용합니다.
5.2 프로젝트 초기화
새로운 프로젝트에서 OpenCode를 사용할 때는 init 명령어로 프로젝트 룰을 먼저 정의하는 것이 좋습니다.
init
이를 통해 프로젝트의 코딩 스타일, 파일 구조, 컨벤션 등을 AI가 인식하고 더 일관된 결과물을 생성할 수 있습니다.
6. 마치며
OpenCode는 AI 기반 개발 워크플로우를 크게 향상시킬 수 있는 도구입니다. GPT와 Gemini를 함께 활용하고, oh-my-opencode 플러그인으로 기능을 확장하면 더욱 강력한 코딩 어시스턴트를 만들 수 있습니다.
초기 설정에 시간을 투자하면 장기적으로 개발 생산성을 크게 높일 수 있으니, 각 단계를 꼼꼼히 따라 설정해보시기 바랍니다.
참고 자료:
728x90
반응형
