코드스페이스에서 시작하기
GenCode 는 GenOS 코드스페이스 안에서 바로 사용할 수 있는 AI 코딩 어시스턴트입니다. 이 문서는 코드스페이스에서 GenCode 를 처음 여는 방법을 안내합니다.
이용 대상
GenOS 코드스페이스를 사용하는 개발자는 추가 설정이 필요하지 않습니다. 서빙 주소·키·모델이 자동으로 구성되는 제로컨피그 방식이기 때문입니다.
조직에서 SSO 로그인 메뉴를 구성한 경우 SSO 로그인을 먼저 진행할 수 있습니다. 조직이 SSO 를 필수로 적용(강제)한 배포에서는 로그인 전 요청이 인증 오류(401)로 실패하므로 이 단계를 반드시 먼저 마쳐야 합니다. SSO 를 사용하지 않는 조직이라면 이 단계 없이 바로 다음 절차를 따르면 됩니다.
시작 절차
- 코드스페이스에 접속합니다.
- 좌측 활동바에서 GenCode 아이콘을 클릭합니다. 환경에 따라 GenCode 화면이 중앙 탭에 자동으로 열려 있는 경우도 있습니다.
- 화면 하단 입력창("Type your task here...")에 처리하고 싶은 작업을 입력합니다.
화면 위치 전환
GenCode 는 중앙 탭과 사이드바 중 원하는 위치에서 사용할 수 있습니다. 화면에 표시되는 "GenCode: 중앙 탭에서 열기" 또는 "사이드바에서 열기" 버튼을 눌러 언제든 위치를 전환할 수 있습니다.
막혔을 때
입력창 하단에는 현재 연결된 모델이 표시됩니다(예: openai-compat:qwen/qwen3-coder). 이
표시가 보이지 않거나 오류 배너가 나타나면 서빙 연결에 문제가 있는 것이므로
연결 실패 문서를 참고하세요.
제약
자동 구성은 GenOS 코드스페이스 환경에서만 적용됩니다. 조직이 SSO 를 필수로 적용(강제)한 배포에서는 로그인 전 요청이 인증 오류(401)로 실패합니다. 로그인 메뉴만 구성된 배포에서는 로그인 없이도 사용될 수 있습니다.
다음 단계
GenCode 화면을 열었다면 첫 작업 실행하기 에서 실제로 작업을 지시하고 결과를 확인하는 방법을 안내합니다.