Codex IDE 확장 기능

Codex IDE 확장은 VS Code, Cursor, Windsurf, 기타 VS Code 호환 에디터에서 Codex를 바로 사용할 수 있게 합니다. Codex CLI와 같은 에이전트를 사용하며 같은 구성을 공유합니다.

Codex에 프롬프트 보내기

에디터에서 Codex를 사용해 자연스럽게 채팅하고, 편집하고, 변경 사항을 미리 볼 수 있습니다. 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

추론 effort 조정

추론 effort를 조정하면 Codex가 응답하기 전에 생각하는 시간을 제어할 수 있습니다. 높은 effort는 복잡한 작업에 도움이 될 수 있지만 응답 시간이 길어집니다. 또한 더 많은 토큰을 사용하고, 특히 더 높은 역량의 모델에서는 사용량 제한을 더 빨리 소모할 수 있습니다.

위의 같은 모델 전환기를 사용해 각 모델에 대해 low, medium, high 중 하나를 선택합니다. medium으로 시작하고 더 깊이가 필요할 때만 high로 전환합니다.

승인 모드 선택

기본적으로 Codex는 Agent 모드에서 실행됩니다. 이 모드에서 Codex는 작업 디렉터리의 파일을 읽고, 편집하고, 명령을 자동으로 실행할 수 있습니다. Codex가 작업 디렉터리 밖에서 작업하거나 네트워크에 접근하려면 여전히 사용자 승인이 필요합니다.

채팅만 하거나 변경 전에 계획을 세우고 싶다면 채팅 입력 아래의 전환기로 Chat으로 바꿉니다.

Codex가 승인 없이 네트워크 접근을 포함해 파일 읽기, 편집, 명령 실행을 해야 한다면 Agent (Full Access)를 사용합니다. 이 모드는 주의해서 사용하십시오.

클라우드 위임

더 큰 작업을 클라우드의 Codex에 맡기고, IDE를 떠나지 않고 진행 상황을 추적하고 결과를 검토할 수 있습니다.

Codex용 클라우드 환경을 설정합니다.
환경을 선택하고 Run in the cloud를 선택합니다.

Codex가 main에서 실행되게 할 수도 있고, 새 아이디어를 시작할 때 유용합니다, 로컬 변경 사항에서 실행되게 할 수도 있습니다. 후자는 작업을 마무리할 때 유용합니다.

로컬 대화에서 클라우드 작업을 시작하면 Codex는 대화 컨텍스트를 기억하므로 중단한 지점에서 이어갈 수 있습니다.

클라우드 작업 후속 처리

Codex 확장은 클라우드 변경 사항 미리보기를 간단하게 만듭니다. 후속 작업을 클라우드에서 실행하도록 요청할 수 있지만, 많은 경우에는 변경 사항을 로컬에 적용해 테스트하고 마무리하는 것이 좋습니다. 로컬에서 대화를 계속할 때도 Codex는 시간을 절약하도록 컨텍스트를 유지합니다.

Codex cloud 인터페이스에서도 클라우드 작업을 볼 수 있습니다.

웹 검색

Codex에는 first-party 웹 검색 도구가 포함되어 있습니다. Codex IDE 확장의 로컬 작업에서는 Codex가 기본적으로 웹 검색을 활성화하고 웹 검색 캐시에서 결과를 제공합니다. 캐시는 OpenAI가 유지 관리하는 웹 결과 색인이므로, 캐시 모드는 live page를 가져오는 대신 미리 색인된 결과를 반환합니다. 이렇게 하면 임의의 live content에서 발생하는 프롬프트 인젝션 노출을 줄일 수 있지만, 웹 결과는 여전히 신뢰할 수 없는 것으로 취급해야 합니다. 샌드박스를 full access로 구성하면 웹 검색은 기본적으로 live result를 사용합니다. 웹 검색을 비활성화하거나 최신 데이터를 가져오는 live result로 전환하려면 설정 기본을 참고하십시오.

Codex가 무언가를 검색할 때마다 transcript나 codex exec --json 출력에 web_search 항목이 표시됩니다.

프롬프트에 이미지 드래그 앤 드롭

이미지를 프롬프트 작성 영역에 드래그 앤 드롭해 컨텍스트로 포함할 수 있습니다.

이미지를 놓을 때 Shift를 누르고 있습니다. 그렇지 않으면 VS Code가 확장이 drop을 받는 것을 막습니다.

이미지 생성

에디터를 떠나지 않고 Codex에게 이미지를 생성하거나 편집하도록 요청할 수 있습니다. UI 에셋, 레이아웃, 일러스트, 스프라이트 시트, 빠른 placeholder를 만들 때 유용합니다. 기존 에셋을 변형하거나 확장하고 싶다면 프롬프트에 참조 이미지를 추가합니다.

자연어로 요청하거나 프롬프트에 $imagegen을 포함해 이미지 생성 스킬을 명시적으로 호출할 수 있습니다.

내장 이미지 생성은 gpt-image-2를 사용하고 일반 Codex 사용량 제한에 포함됩니다. 이미지 품질과 크기에 따라 평균적으로 이미지 생성이 없는 유사한 턴보다 포함된 제한을 3-5배 빠르게 사용합니다.

더 큰 이미지 생성 batch에는 환경 변수에 OPENAI_API_KEY를 설정하고 Codex에게 API를 통해 이미지를 생성하도록 요청해 API 가격이 적용되게 합니다.