1. 개요

Codex를 IDE와 나란히 사용하면서도 에이전트가 IDE 설정을 제대로 읽지 못하고, 내가 지금 보고 있는 파일이 무엇인지도 모르는 듯한 답변을 할 때가 있었다. 그래서 매번 파일 경로와 현재 선택한 코드, 수정하려는 위치를 프롬프트에 다시 적어야 했다.

이 문제는 Codex가 코드 저장소를 읽을 수 있는 것과 에디터의 현재 상태를 전달받는 것이 서로 다른 기능이라는 점을 놓쳐서 생겼다. CLI 세션에서 /ide를 사용하면 열린 파일, 현재 선택 영역처럼 IDE가 제공할 수 있는 컨텍스트를 다음 요청에 포함할 수 있다.

2. 저장소 컨텍스트와 IDE 컨텍스트는 다르다

Codex를 프로젝트 루트에서 실행하면 보통 저장소의 파일을 탐색하고 수정할 수 있다. 하지만 이것만으로는 IDE의 탭 상태나 커서가 있는 파일을 자동으로 알 수 없다.

구분 예시 Codex에 전달되는 방식
저장소 컨텍스트 프로젝트 파일, AGENTS.md, Git 변경 사항 작업 디렉터리를 기준으로 파일을 탐색
IDE 컨텍스트 현재 열린 파일, 선택한 코드, 활성 에디터 IDE 연동을 통해 별도로 전달

따라서 README.md를 열어 둔 채 “이 문서 설명을 고쳐줘”라고 말해도, IDE 컨텍스트가 연결되지 않았다면 Codex는 다른 파일을 찾거나 어느 파일을 뜻하는지 다시 물을 수 있다. 반대로 IDE 컨텍스트가 전달되면 현재 보고 있는 파일과 선택 영역을 출발점으로 요청을 이해할 수 있다.

3. /ide로 현재 에디터 상태 포함하기

Codex CLI 대화 입력창에서 아래처럼 입력한다.

/ide

필요하다면 같은 줄에 작업 의도도 덧붙일 수 있다.

/ide 지금 선택한 함수의 예외 처리를 보완해줘

공식 문서에서 /ide는 열린 파일, 현재 선택 영역, 그 밖의 IDE 컨텍스트를 다음 프롬프트에 포함하는 명령으로 안내한다. 즉 /ide는 프로젝트 설정을 전부 마법처럼 읽게 하는 옵션이라기보다, 지금 IDE에서 보고 있는 맥락을 명시적으로 가져오는 명령에 가깝다.

이제 “현재 선택한 부분에서 중복된 로직을 제거해줘”처럼 자연스럽게 요청할 수 있다. 파일명과 줄 범위를 매번 복사하는 횟수도 줄어든다.

4. 먼저 확인할 IDE 연동 상태

/ide가 유용하려면 사용하는 에디터에 Codex 연동이 활성화되어 있어야 한다. 공식 문서는 VS Code 및 호환 에디터에서는 Codex 확장을 설치하거나 활성화하도록 안내하며, Xcode와 JetBrains IDE에는 각각의 연동 방식을 제공한다.

확인 순서는 다음과 같다.

  1. IDE에서 Codex 확장을 설치하거나 활성화한다.
  2. IDE에서 열어 둔 프로젝트와 Codex CLI를 실행한 작업 디렉터리가 같은 프로젝트인지 확인한다.
  3. CLI 세션에서 /ide를 입력한 뒤, 열린 파일 또는 선택 영역을 기준으로 간단한 질문을 한다.

예를 들어 VS Code에서는 Codex 아이콘을 선택하거나 Command Palette에서 Codex: Open Codex Sidebar를 실행해 연동 상태를 확인할 수 있다. 확장이 비활성화됐거나 서로 다른 프로젝트를 열어 둔 상태라면 IDE 컨텍스트가 기대한 만큼 전달되지 않을 수 있다.

5. 매 요청마다 쓸지, 자동 반영할지

한 번만 현재 화면의 맥락이 필요하면 /ide가 적합하다. 반면 IDE 컨텍스트를 계속 반영하고 싶다면 /ide-context로 자동 IDE 컨텍스트 사용 여부를 켜거나 끌 수 있다.

상황 권장 명령 이유
선택한 코드 한 부분만 검토 /ide 다음 요청에 필요한 맥락만 명시적으로 전달
현재 파일을 기준으로 여러 번 대화 /ide-context IDE 컨텍스트 자동 반영 여부를 세션에서 관리
파일이 명확히 정해진 배치 작업 경로를 프롬프트에 직접 명시 현재 에디터 상태보다 작업 대상이 더 중요

자동 반영을 쓰더라도 파일 경로가 중요한 작업, 여러 파일을 동시에 바꾸는 작업, 배포나 삭제처럼 영향 범위가 큰 작업에서는 대상 파일과 기대 결과를 프롬프트에 분명히 적는 편이 좋다. IDE 컨텍스트는 설명을 줄여 주지만, 작업 의도를 대신 정의해 주지는 않는다.

6. 동작하지 않을 때 점검할 것

/ide를 입력했는데도 Codex가 현재 파일을 모르는 것 같다면 아래를 점검한다.

  • IDE 확장 또는 IDE의 Codex 연동이 실제로 활성화되어 있는지 확인한다.
  • IDE와 CLI가 같은 프로젝트를 가리키는지 확인한다.
  • 코드 일부를 선택한 뒤 /ide와 함께 짧고 구체적인 요청을 보낸다.
  • 한 번의 요청만 필요한지, 자동 IDE 컨텍스트가 필요한지에 따라 /ide와 /ide-context를 구분한다.

그리고 IDE 컨텍스트는 “사용 가능한” 정보만 포함한다. 열지 않은 파일의 내용, 다른 창의 설정, 아직 저장되지 않았거나 연동이 제공하지 않는 상태까지 모두 전달된다고 가정하면 안 된다. 필요한 설정 파일이나 오류 로그는 직접 언급하거나 첨부하는 편이 안전하다.

7. 정리

Codex가 현재 보고 있는 파일을 알지 못해 답답했다면, 먼저 IDE 연동과 /ide를 확인하면 된다. /ide는 열린 파일과 선택 영역을 다음 요청에 실어 주므로, 에디터 화면을 장황하게 설명하지 않고도 현재 코드에 집중한 대화를 시작할 수 있다.

계속 IDE 맥락을 반영하고 싶을 때는 /ide-context를 함께 사용한다. 다만 이것은 Codex가 IDE의 모든 설정과 상태를 자동으로 이해한다는 뜻은 아니다. IDE 컨텍스트, 저장소의 문서와 규칙, 그리고 명확한 작업 요청을 함께 제공할 때 가장 안정적으로 동작한다.

참고: OpenAI 공식 Codex IDE 확장 문서, OpenAI 공식 Developer commands 문서