Codex로 시작하는 개발 환경 가이드 (vs code 및 cursor 확장앱)
Codex란 무엇인가요?
Codex는 OpenAI에서 만든 프로그래밍 지원 에이전트로, 코드를 읽고 수정하고 실행할 수 있어요. 버그를 잡거나 낯선 코드도 빠르게 이해할 수 있고, 더 빠르게 프로젝트를 진행할 수 있도록 도와줍니다.
Codex를 설치하려면 어떻게 하나요?
Codex는 VS Code 및 그 변형 IDE(Insiders, Cursor, Windsurf 등)에 설치할 수 있어요. 확장 마켓에서 Codex를 찾아 설치하거나, 공식 다운로드 링크를 사용할 수 있습니다. macOS와 Linux에서 가장 안정적으로 작동하며, Windows는 "Windows Subsystem for Linux"로 사용하는 것이 좋아요.
사이드바에서 Codex 확장 이용하기
설치한 Codex 확장은 IDE의 사이드바에서 확인할 수 있습니다. VS Code에선 아이콘을 드래그해 오른쪽 사이드바로 옮길 수 있어요.
Cursor와 같은 다른 에디터에서는 설정에서 "activity bar" 방향을 바꾼 뒤 Codex를 옮기면 됩니다.
vs code 설정 - Workbench › Activity Bar: Orientation 을 Vertical 로 설정.
그 후 코덱스 아이콘을 끌어서 커서 채팅창이 있는 오른쪽에 끌어다 놓으면 됨.
Codex에 로그인하기
설치 후에는 ChatGPT 계정으로 로그인해야 제대로 쓸 수 있어요. ChatGPT 요금제가 있다면 추가 셋업 없이 바로 이용 가능합니다. 별도의 API 키로도 Codex를 쓸 수 있는데, 이때는 추가 설정이 필요합니다.
확장 프로그램 업데이트 방법
Codex 확장 프로그램은 자동으로 최신 버전으로 업데이트돼요. 수동으로도 IDE의 확장 페이지에서 직접 업데이트를 확인할 수 있습니다.
키보드 단축키로 빠르게 Codex 활용하기
Codex의 기능들은 원하는 대로 키보드 단축키로 지정해 편리하게 쓸 수 있어요. Codex 채팅창의 설정 아이콘을 눌러 "Keyboard shortcuts"을 확인하고 원하는 동작에 단축키를 할당해보세요.
파일을 똑똑하게 참조하는 방법
프로젝트에서 열려 있는 파일이나 선택한 코드를 이용해 더 짧은 프롬프트로 Codex를 사용할 수 있습니다. 예시처럼 파일을 태그해 요청할 수 있습니다.
Use @example.tsx as a reference to add a new page named "Resources" to the app that contains a list of resources defined in @resources.ts모델 선택과 방식 변경
기본적으로 GPT-5 모델이 사용되지만, 코딩 작업에 맞게 최적화된 GPT-5-Codex로 쉽게 바꿀 수 있습니다. 채팅 입력창 아래 모델 전환 스위치에서 선택할 수 있어요.
응답 정밀도(Reasoning Effort) 조정하기
Codex가 답변할 때 얼마나 깊게 생각할지 정할 수 있습니다. 단순 작업은 빠르게 처리할 수 있고, 복잡한 작업은 더 상세히 분석하기 위해 "높음" 설정을 사용할 수 있어요. 모델 전환 스위치에서 '낮음/보통/높음' 중 선택하세요.
Codex 작동 모드와 승인 방식
Codex에는 작업 자동 승인 모드(Agent), 수동 승인과 계획 중심 모드(Chat), 그리고 완전한 자유가 주어지는 모드(Agent Full Access)가 있어요. 보안을 위해 기본적으로 작업 디렉토리 내에서는 자동으로 실행되며, 디렉토리 밖이나 인터넷 접근은 승인을 받아야 해요.
더 깊은 내용과 공식 문서
Codex VS Code 확장은 오픈소스 CLI와 연결되어 있습니다. 고급 설정이나 자세한 기술 문서는 공식 GitHub 저장소에서 확인할 수 있습니다.
출처 및 참고 : Codex IDE extension