1. OpenCode가 뭐야?
OpenCode는 터미널에서 사용하는 AI 코딩 도구(CLI)다.
ChatGPT처럼 대화하지만, 내 로컬 프로젝트 폴더 안에서:
- 코드 생성
- 코드 수정
- 파일 생성
- 리팩토링
- 설명 요청
같은 작업을 바로 수행할 수 있다.
즉,
웹에서 쓰는 GPT →
내 프로젝트 폴더 안에서 직접 코드 작업하는 AI
라고 이해하면 쉽다.
2. 설치 방법 (Windows 기준)
1단계: Git Bash 또는 PowerShell 열기
- Windows 검색 →
Git Bash - 또는
PowerShell
붙여넣기 단축키
- Git Bash:
Shift + Insert - PowerShell:
Ctrl + V
2단계: 설치 명령어 실행
아래 명령어 복사해서 붙여넣기:
curl -fsSL https://opencode.ai/install | bash설치가 완료되면 터미널에서:
opencode라고 입력했을 때 실행되면 성공.
3. Provider 연결하기 (제일 중요)
OpenCode는 AI 모델과 연결해야 작동한다.
이걸 Provider라고 한다.
예시 Provider:
- OpenAI
- Anthropic
- 로컬 LLM (Ollama 등)
OpenAI 연결 예시
1단계: OpenAI API Key 발급
- https://platform.openai.com 접속
- API Key 생성
2단계: 환경변수 등록 (Windows PowerShell)
setx OPENAI_API_KEY "여기에_내_API키"터미널을 완전히 닫았다가 다시 열기
3단계: Provider 설정
opencode config또는
opencode connect여기서 OpenAI 선택
4. 기본 사용법
1️⃣ 프로젝트 폴더로 이동
예:
cd D:\UnrealProject\MyGame그 다음:
opencode이제 이 폴더 안에서 AI가 작업한다.
2️⃣ 대화 방식 사용
예:
이 프로젝트에 C++로 점프 기능 추가해줘또는
이 코드 리팩토링해줘또는
현재 폴더 구조 설명해줘5. OpenCode로 가능한 것
코드 생성
- C++
- Unreal C++
- Python
- React
- 서버 코드 등
파일 생성
- 헤더 파일 자동 생성
- 클래스 구조 생성
- README 작성
코드 수정
- 기존 코드 읽고 수정
- 버그 수정
- 최적화
6. OpenCode의 한계
❌ 자동으로 Unreal Editor를 조작하진 못함
- 에디터 버튼 클릭 불가
- 블루프린트 직접 수정 불가
❌ 인터넷 검색 자동으로 하지 않음 (기본 설정)
- 로컬 파일 기반 작업
7. OpenCode vs ChatGPT 차이
| 구분 | ChatGPT | OpenCode |
|---|---|---|
| 위치 | 웹 | 내 PC 터미널 |
| 파일 접근 | 불가능 | 가능 |
| 코드 직접 수정 | 복붙 필요 | 직접 수정 |
| 프로젝트 단위 작업 | 어려움 | 가능 |
8. 실전 예시 (언리얼 C++ 기준)
예시 1
ACharacter 상속받은 클래스에 더블 점프 기능 추가해줘예시 2
이 프로젝트에서 B01으로 시작하는 StaticMesh 자동으로 배열로 모으는 코드 만들어줘9. OpenCode는 어떤 개념인가?
이건 이런 개념이다:
- LLM (Large Language Model)
- CLI 기반 AI Agent
- 로컬 코드 어시스턴트
즉,
GPT를 내 프로젝트 안으로 끌고 들어온 것
이라고 보면 정확하다.
10. 추천 사용 흐름
- 기능 설계는 ChatGPT에서 정리
- 실제 코드 생성/수정은 OpenCode
- Unreal Editor에서 테스트
- 다시 OpenCode로 수정
이 방식이 가장 효율적이다.
11. 초보자가 헷갈리는 부분 정리
Q: Bash는 폴더마다 하나인가?
아니다.
터미널은 하나고, cd로 이동하는 것이다.
Q: GPT랑 뭐가 다른 거야?
GPT는 대화
OpenCode는 프로젝트 직접 수정
Q: Unreal C++도 가능?
가능.
헤더/CPP 구조 이해하고 생성도 잘한다.
마무리 정리
OpenCode는:
- AI를 터미널에서 쓰는 도구
- 로컬 프로젝트 직접 수정 가능
- 코딩 생산성을 크게 올려줌
- 특히 C++/언리얼 프로젝트에 매우 강력함
응애 개발자