Codex CLI - /ide로 IDE 컨텍스트 연결하기

게시 2026/08/28

By eta_kyung

9 분읽는 시간

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에는 각각의 연동 방식을 제공한다.

확인 순서는 다음과 같다.

IDE에서 Codex 확장을 설치하거나 활성화한다.
IDE에서 열어 둔 프로젝트와 Codex CLI를 실행한 작업 디렉터리가 같은 프로젝트인지 확인한다.
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 문서