터미널에서 코드를 읽고 고치는 AI를 직접 제어하는 방법
터미널 창을 열고 opencode를 실행하면, AI가 프로젝트 구조를 파악하고 필요한 파일을 수정하는 과정을 실시간으로 지켜볼 수 있습니다. 낯선 코드베이스를 탐색하거나 변경 사항을 계획할 때, AI가 어떤 파일을 읽고 어떻게 바꿀지 미리 확인하고 승인할 수 있습니다. 이 도구는 오픈소스로 공개되어 있으며, 개발자가 터미널 환경에서 AI와 협업하는 방식을 직접 설정할 수 있게 합니다.
작업 성격에 맞는 두 가지 에이전트
도구는 Tab 키로 전환하는 두 가지 내장 에이전트를 제공합니다. 기본인 'build' 에이전트는 파일 수정과 명령 실행에 대한 전체 권한을 가진 개발용 모드입니다. 반면 'plan' 에이전트는 읽기 전용으로 동작하며, 파일 편집을 거부하고 bash 명령 실행 전에는 반드시 사용자의 허락을 구합니다. 낯선 코드베이스를 탐색하거나 변경 사항을 계획할 때 실수를 방지하기 위해 이 모드를 쓰면 좋습니다. 또한 복잡한 검색이나 다단계 작업을 처리하는 'general' 서브에이전트가 내부적으로 포함되어 있으며, 메시지 안에 @general을 입력해 직접 호출할 수도 있습니다.
설치 경로와 데스크톱 앱
터미널에서 바로 설치하려면 curl -fsSL https://opencode.ai/v2/install | bash 명령을 실행합니다. 설치 경로는 $OPENCODE_INSTALL_DIR 환경 변수를 통해 커스텀할 수 있으며, 지정하지 않으면 $HOME/.opencode/bin 같은 기본 경로에 설치됩니다. 0.1.x 이전 버전이 남아 있다면 설치 전에 제거하는 것이 좋습니다. 데스크톱 앱도 베타 버전으로 제공되며, macOS, Windows, Linux용 설치 파일을 공식 사이트에서 내려받을 수 있습니다.
사용 전 알아둘 점
이 도구는 오픈소스 프로젝트로, 커뮤니티의 기여를 통해 발전하고 있습니다. 데스크톱 앱은 아직 베타 단계이므로 안정성이 완전히 보장되지 않을 수 있습니다. 터미널 기반 도구이므로, AI가 실행하는 bash 명령이나 파일 수정에 대한 권한 관리가 중요하며, 특히 'plan' 모드를 활용해 민감한 작업 전 검토 과정을 거치는 것이 안전합니다. 프로젝트 이름에 'opencode'를 포함해 파생 작업을 만들 경우, README에 공식 팀과 무관함을 명시해야 한다는 규정이 있으므로 이 점도 유의해야 합니다. 공식 문서와 기여 가이드라인을 참고하여 설정을 조정하고, 커뮤니티 디스코드나 X.com을 통해 최신 정보를 확인하는 것이 좋습니다.
