Chat On Steroids 설정 방법 및 ChatGPT 로컬 연동 가이드

브라우저에서 열어 둔 ChatGPT 대화창과 로컬 개발 환경 사이를 오가며 코드를 복사하고 붙여넣는 작업은, 프로젝트 규모가 조금만 커져도 금방 피로가 쌓이는 루틴이다. 답변으로 받은 코드를 편집기에 옮기고, 터미널에서 테스트를 돌리고, 그 결과를 다시 대화창에 붙여넣는 왕복이 하루에도 수십 번 반복된다. Chat On Steroids(이하 CoS)는 이 왕복을 없애기 위해 나온 오픈소스 데스크톱 앱으로, MCP(Model Context Protocol)를 매개로 ChatGPT의 대화가 로컬 파일과 터미널에 직접 닿을 수 있게 만든다. 이 글에서는 CoS를 처음 설치하는 시점부터 실제 개발 워크플로에 적용하기까지의 과정을 로컬 연동 구조에 대한 이해와 함께 정리한다.

ChatGPT가 내 PC의 파일을 직접 다루게 하려면 무엇이 필요한가

ChatGPT에서 로컬 프로젝트 폴더를 바로 읽을 수 없는 이유

브라우저에서 실행되는 ChatGPT는 샌드박스 안에서 동작하는 웹 애플리케이션이다. 사용자의 디스크에 어떤 폴더가 있는지, 그 안에 어떤 파일이 들어 있는지는 브라우저 보안 모델상 원천적으로 알 수 없는 정보다. 그래서 지금까지의 워크플로는 사람이 직접 파일 내용을 복사해서 대화창에 붙여넣는 수밖에 없었다. 손님이 주방에 직접 들어갈 수 없는 레스토랑과 비슷한 구조다. 요리(코드 수정)를 아무리 잘해도, 재료(파일)를 주방 밖에서 안으로 날라다 줄 사람이 없으면 요리 자체가 시작되지 않는다.

Chat On Steroids를 설치하면 정확히 무엇이 달라지는가

CoS는 이 '재료를 나르는 사람' 역할을 로컬 데스크톱 앱으로 구현한 프로젝트다. 앱을 설치하고 승인한 폴더를 지정하면, ChatGPT 대화 안에서 그 폴더의 파일을 읽고, 패치를 적용하고, 터미널 명령까지 실행할 수 있게 된다. 대화가 진행되는 곳은 여전히 브라우저의 ChatGPT지만, 실행의 손발은 로컬 컴퓨터에 붙는 구조다.

 

비용 결제 없는 핵심 이점

• API 비용 절감: 별도의 Codex API 토큰을 결제할 필요 없이, 이미 사용 중인 ChatGPT 구독 쿼터 범위 내에서 로컬 프로젝트 작업을 수행합니다.
• 멀티 에이전트 분담 및 맥락 유지: 복잡한 개발 작업을 여러 에이전트에 나누어 부여할 수 있으며, 새 대화 세션으로 전환해도 기존 작업 컨텍스트를 그대로 보존합니다.

 

MCP를 이용한 ChatGPT 로컬 연동 구조 먼저 이해하기

이 연결을 가능하게 하는 프로토콜이 MCP(Model Context Protocol)다. MCP는 모델이 외부 도구나 데이터 소스에 접근할 때 쓰는 표준화된 통신 규격으로, CoS는 이 규격에 맞춰 로컬 컴퓨터 안에 작은 서버를 띄운다. ChatGPT는 이 서버를 커스텀 앱으로 등록해 두고, 대화 중 파일을 읽거나 명령을 실행해야 할 때마다 이 서버에 요청을 보낸다. 통역사를 사이에 둔 회의와 비슷한 구조다. ChatGPT는 자연어로 "이 파일을 고쳐줘"라고 말하고, MCP 서버가 그 말을 로컬 파일 시스템이 이해할 수 있는 구체적인 명령으로 통역해서 대신 실행해 주는 셈이다.

Chat On Steroids 설치 전에 확인할 것

Windows, macOS, Linux에서 설치 방법이 다른 부분

CoS는 Electron 기반으로 만들어져 Windows, macOS, Linux용 패키지가 모두 배포된다. Windows는 x64와 ARM64(Snapdragon, Surface Pro X 계열) 설치 파일이 따로 제공되고, macOS는 Intel과 Apple Silicon용 dmg·zip이 나뉘어 있으며 macOS 13 Ventura 이상을 요구한다. Linux는 Debian·Ubuntu 계열이면 deb 패키지를, 그 외에는 AppImage를 권장하는데, 배포판에 따라 사용자 네임스페이스가 막혀 있으면 AppImage 실행 시 --no-sandbox 옵션이 붙어야 하는 경우가 있다. macOS 빌드는 퍼블리셔 서명과 공증(notarization)을 받지 않은 상태이므로, 설치 전 저장소가 제공하는 SHA-256 체크섬으로 다운로드한 파일을 직접 검증하는 절차를 거치는 편이 안전하다.

ChatGPT Developer Mode와 Custom MCP App 확인하기

CoS를 쓰려면 ChatGPT 계정에서 Developer Mode를 켤 수 있어야 하고, 커스텀 MCP 앱을 등록할 수 있는 계정이어야 한다. Developer Mode는 Settings → Apps → Advanced settings 경로에서 활성화하며, 이 메뉴가 보이지 않는 계정이라면 CoS를 연결할 수 없다. 설치 전에 이 설정 화면부터 열어 옵션이 실제로 존재하는지 확인해 두는 편이 좋다.

Chrome과 ChatGPT 웹 환경 준비하기

브라우저 쪽 요구사항은 Chrome 116 이상, 또는 그에 준하는 최신 Edge다. CoS의 Companion Extension이 크롬 확장 프로그램 형태로 배포되기 때문에, 확장 프로그램을 개발자 모드로 직접 로드할 수 있는 브라우저 환경이 미리 준비돼 있어야 한다.

처음부터 모든 권한을 켜도 될까?

권장되지 않는다. CoS는 새로 설치하면 기본적으로 Core 권한이 켜진 상태로 시작하고, Windows에서는 Desktop 권한까지 기본으로 켜져 있다. 반면 읽기 전용 모드는 꺼져 있는 초기값이다. 즉 아무 설정도 건드리지 않으면 파일 쓰기와 명령 실행이 곧바로 가능한 상태로 첫 연결이 이루어진다. 처음에는 승인 폴더를 좁게 잡고 읽기 전용에 가깝게 시작한 뒤, 필요할 때마다 권한을 한 단계씩 넓히는 방식이 안전하다.

Chat On Steroids 설치 및 프로젝트 폴더 연결

운영체제에 맞는 설치 파일 선택하기

GitHub 릴리즈 페이지에서 운영체제와 CPU 아키텍처에 맞는 설치 파일을 내려받는다. 함께 제공되는 SHA256SUMS.txt로 체크섬을 대조하는 절차는 특히 macOS와 Linux처럼 서명되지 않은 빌드에서 건너뛰지 않는 편이 좋다.

Workspace에서 프로젝트 폴더 추가하기

앱을 실행한 뒤 Settings → Workspace 메뉴에서 ChatGPT가 접근할 프로젝트 폴더를 승인한다. 이 폴더가 이후 모든 파일 도구의 기준 경로가 된다. 회사 건물의 출입증 시스템과 비슷하다. 출입증이 있다고 모든 층을 다닐 수 있는 게 아니라 등록된 층에만 태그가 반응하는 것처럼, CoS의 파일 도구도 승인된 폴더 바깥의 경로는 아예 인식하지 못한다.

ChatGPT에 허용할 로컬 기능 확인하기

같은 화면에서 Core, Desktop, Plugins 세 커넥터 중 무엇을 켤지, 각 커넥터 안에서 어떤 세부 도구를 허용할지를 확인한다. 파일 생성, 편집, 이동, 삭제 권한은 각각 별도로 켜고 끌 수 있게 나뉘어 있다.

Read-only 모드와 파일 수정 권한의 차이

Read-only 모드를 켜면 파일 쓰기, 명령 실행, 데스크톱 제어, 클립보드 쓰기가 한꺼번에 차단된다. 도서관 열람실에 비유할 수 있다. 책을 자유롭게 펼쳐서 읽을 수는 있지만 대출은 안 되는 상태, 즉 내용을 보고 참고할 수는 있어도 실제로 무언가를 바꿔서 가져갈 수는 없는 상태다. 코드 리뷰나 구조 파악처럼 '보기만' 하면 되는 작업에는 이 모드만으로 충분하다.

ChatGPT 로컬 연동의 핵심인 MCP Tunnel 설정

OpenAI Secure MCP Tunnel 방식으로 연결하기

CoS가 기본으로 권장하는 연결 경로는 OpenAI의 Secure MCP Tunnel이다. 절차는 네 단계로 나뉜다. 먼저 OpenAI Platform의 Tunnels 설정 화면에서, ChatGPT에서 쓰는 것과 같은 워크스페이스에 터널을 하나 만든다. 그다음 Restricted API Key를 발급하는데, 이때 부여하는 권한은 Tunnels: Read와 Tunnels: Use 두 가지로 제한한다. 발급받은 터널 ID와 키를 CoS에 입력하고 Connect를 누르면, 마지막으로 ChatGPT의 Developer Mode에서 Tunnel 타입의 커스텀 앱을 만들고 노출된 액션을 검토해 활성화하는 순서로 마무리된다.

Restricted API Key에 필요한 권한은 무엇인가

여기서 핵심은 전체 권한을 가진 마스터키가 아니라 딱 그 용도로만 쓰이는 제한된 키를 발급한다는 점이다. 호텔 프런트에서 마스터키 대신 딱 하나의 층만 열리는 카드키를 새로 만들어 주는 것과 같은 개념이다. 이 API 키가 유출되더라도 할 수 있는 일은 터널을 읽고 쓰는 것뿐이며, 계정의 다른 리소스에는 접근할 수 없다.

Tunnel ID와 API Key를 Chat On Steroids에 입력하기

CoS의 Settings → Setup 화면에 터널 ID와 방금 발급한 API 키를 입력하고 Connect를 누르면 로컬 MCP 서버와 OpenAI 터널이 연결된다. 릴리즈 패키지에는 체크섬이 검증된 tunnel-client가 함께 포함되어 있어 별도로 설치할 필요는 없다.

ChatGPT Developer Mode에서 Core 앱 추가하기

ChatGPT 쪽에서는 Developer Mode 안에서 커스텀 앱으로 Tunnel 타입을 선택하고, 방금 연결한 터널을 지정해 Core 앱을 추가한다. 이 단계에서 노출되는 액션 목록을 검토해 실제로 활성화해야 대화 중에 도구로 나타난다. Core, Desktop, Plugins는 서로 다른 커넥터이므로, 쓰려는 통로마다 이 등록 절차를 각각 반복해야 한다.

연결은 됐는데 MCP 도구가 보이지 않을 때 확인할 것

터널 연결 자체는 성공했는데 Core의 Actions 목록이 비어 있다면, ChatGPT 쪽 플러그인 화면에서 read(그리고 로컬 명령 실행을 허용했다면 exec_command)가 실제로 나열되는지부터 확인한다. 저장된 터널 ID가 지금 접속한 ChatGPT 워크스페이스와 일치하는지 점검하고, 그래도 목록이 비어 있으면 작업이 실행 중이지 않은 상태에서 CoS 쪽 터널을 재연결한 뒤 플러그인 액션을 다시 불러온다. CoS의 Home 화면에 있는 Run checks 기능을 쓰면 확장 프로그램 페어링, 터널 상태, HTTP 요청 수신 여부, tools/list 응답이 비어 있지 않은지를 각각 따로 점검해 준다.

Chrome Companion Extension으로 ChatGPT 브라우저 연결하기

Companion Extension이 MCP 연결과 다른 이유

MCP 터널이 ChatGPT와 로컬 CoS 서버 사이의 통신 경로를 여는 역할이라면, Companion Extension은 지금 브라우저에서 보고 있는 ChatGPT 탭이 어느 로컬 세션에 속하는지를 확인하는 역할이다. 콘서트장 입구에서 손목밴드로 입장객을 구분하는 것과 비슷하다. 티켓(터널 연결)이 있다고 다 통과되는 게 아니라, 손목밴드(익스텐션 페어링)로 지금 이 사람이 어느 좌석의 손님인지까지 확인이 돼야 안내가 정확해진다.

Open extension folder로 확장 프로그램 폴더 열기

CoS 안에서 Open extension folder 버튼을 누르면 압축이 풀린 확장 프로그램 파일이 들어 있는 폴더가 열린다.

Chrome Developer Mode에서 Load unpacked 사용하기

chrome://extensions 페이지에서 오른쪽 위의 Developer mode를 켠 뒤, Load unpacked를 선택해서 방금 열린 폴더를 지정하면 확장 프로그램이 설치된다.

확장 프로그램 설치 후 자동 페어링 확인하기

설치가 끝나면 별도의 로그인 절차 없이 자동으로 페어링이 이루어진다. 브라우저에서 열려 있는 ChatGPT 대화와 로컬 CoS 세션이 이 시점부터 서로를 인식한다.

ChatGPT 페이지를 새로고침해야 하는 경우

앱을 업데이트한 뒤에는 확장 프로그램 재로드와 ChatGPT 쪽 앱 새로고침이 서로 다른 두 단계라는 점을 기억해 둘 필요가 있다. 둘 중 하나만 하고 넘어가면 버전이 어긋나 도구 목록이 이상하게 표시되는 경우가 생긴다.

ChatGPT에서 로컬 파일을 실제로 사용하는 방법

프로젝트 전체 구조를 ChatGPT에게 분석시키기

프로젝트 안에서 대화를 열면, 별도의 AGENTS.md 파일이 없어도 그 프로젝트의 정확한 가상 폴더 경로가 모델의 기본 지시문에 자동으로 포함된다. 이 폴더가 기본 작업 위치로 설정되고, 필요한 경우 권한이 허용하는 범위 안에서 다른 위치로도 작업 범위를 넓힐 수 있다.

특정 파일만 찾아서 읽게 만들기

대화 중 특정 파일명이나 경로를 언급하면 Core 커넥터의 read 도구가 해당 파일을 승인 폴더 기준으로 찾아 읽어 온다.

파일 수정 전후의 요청 방식 비교

연동 전에는 파일 내용을 사람이 직접 복사해서 붙여넣고, 답변으로 돌아온 코드를 다시 손으로 옮기는 두 번의 수작업이 필요했다. 연동 후에는 "이 함수를 고쳐줘"라는 요청만으로 파일을 읽는 것부터 패치를 적용하는 것까지 한 번의 대화 흐름 안에서 끝난다.

여러 파일을 한 번에 수정할 때 주의할 점

CoS의 파일 수정 도구는 V4A라는 패치 형식을 쓰는데, 여러 파일을 한꺼번에 고칠 때는 실제 적용 전에 예행 검사(dry run)를 먼저 돌려 본다. 다만 디렉터리 전체 삭제나 임의의 바이너리 파일 쓰기는 이 패치 연산 범위에 포함되지 않는다는 점은 미리 알아 두는 편이 좋다.

테스트 코드까지 로컬에서 실행시키기

Core 커넥터가 명령 실행 권한까지 갖고 있다면, 수정한 코드에 대해 테스트 명령을 직접 실행시키고 그 출력을 대화 안에서 바로 확인할 수 있다.

코드로 비교하는 ChatGPT 로컬 연동 전후

연동 전: 코드를 직접 복사해서 ChatGPT에 전달하는 방식

연동 전 워크플로는 편집기에서 파일을 열고, 관련 부분을 선택해 복사하고, 브라우저로 전환해 대화창에 붙여넣는 과정이 매 요청마다 반복된다. 파일이 여러 개로 나뉜 프로젝트라면 이 과정 자체가 상당한 시간을 잡아먹는다.

연동 후: ChatGPT가 로컬 프로젝트를 직접 확인하는 방식

연동 후에는 "src 폴더 안의 인증 로직을 점검해줘"처럼 자연어로 범위만 지정하면, 어떤 파일을 열어야 할지는 모델이 read 도구를 통해 스스로 판단한다. 사람은 최종 결과와 적용된 패치만 검토하면 된다.

단순 코드 질문과 로컬 프로젝트 작업의 차이

문법을 묻거나 알고리즘 하나를 설명받는 수준의 질문은 로컬 연동 없이도 충분하다. 반면 여러 파일에 걸친 리팩터링이나 실제 프로젝트 컨텍스트가 필요한 작업은 로컬 연동이 있을 때와 없을 때의 체감 차이가 크다.

작은 파일 수정과 대규모 프로젝트 수정의 차이

파일 하나짜리 수정은 굳이 로컬 연동이 없어도 큰 불편이 없다. 반면 수십 개 파일에 걸친 변경이라면, 매번 손으로 옮기는 대신 CoS가 직접 각 파일을 순회하며 패치를 적용하는 쪽이 압도적으로 효율적이다.

 

비용 및 쿼터 차이 비교

• 기존 워크플로: API 토큰 단위 결제로 인해 사용량이 늘어날수록 비용 부담이 커지거나 Codex 쿼터를 빠르게 소모함.
• CoS 활용 시: 기존 ChatGPT 구독 가입 쿼터를 그대로 사용하므로 추가 API 비용 발생 없이 프로젝트 자동화 구동 가능.

터미널까지 연결했을 때 달라지는 개발 방식

ChatGPT에서 npm 명령 실행하기

Core 커넥터의 명령 실행 도구를 통해 npm install이나 npm run build 같은 명령을 대화 안에서 바로 실행시킬 수 있다.

테스트와 빌드를 직접 실행시키기

코드 수정 직후 곧바로 테스트를 돌려 결과를 확인하는 흐름이 가능해지면서, 수정과 검증 사이의 간격이 크게 줄어든다.

실행 결과를 다시 ChatGPT가 분석하게 만들기

터미널 출력이나 에러 로그를 사람이 다시 옮겨 적을 필요 없이, 실행 결과가 그대로 대화 컨텍스트에 포함되어 다음 수정 제안으로 이어진다.

개발 서버를 실행할 때 발생하는 문제

개발 서버처럼 계속 떠 있어야 하는 프로세스를 실행하면 명령이 종료되지 않고 대화가 대기 상태로 남을 수 있으므로, 별도의 워커나 세션으로 분리해서 관리하는 편이 안전하다.

터미널 권한을 무조건 허용하면 안 되는 이유

이 부분이 가장 중요하게 짚어야 할 지점이다. CoS의 셸 명령 실행 권한은 승인 폴더 범위로 제한되지 않고, 로그인한 운영체제 사용자의 권한을 그대로 물려받는다. 파일 읽기·쓰기는 지정한 폴더 안에서만 허용되지만, 터미널 명령 자체는 그 폴더 밖에서도 실행될 수 있다는 뜻이다. 이 차이를 모르고 터미널 권한을 가볍게 켜 두면, 승인 폴더 하나만 제한했다고 안심할 근거가 없어진다.

실무에서 자주 발생하는 Chat On Steroids 엣지 케이스

승인한 폴더인데 파일을 읽지 못하는 경우

Workspace에서 승인한 경로와 실제로 대화 중인 프로젝트 경로가 일치하는지부터 확인한다. 상위 폴더만 승인하고 하위 프로젝트를 별도로 열었을 때 인식이 어긋나는 경우가 종종 있다.

MCP 연결은 정상인데 도구 호출이 실패하는 경우

로컬 권한이 켜져 있다는 사실이 ChatGPT가 실제로 그 호출을 수락했다는 것을 증명하지는 않는다. 로컬 도구 기록을 확인해 해당 요청의 실행 결과가 실제로 존재하는지부터 살펴봐야 하고, 기록이 없다면 실행 여부가 확정되지 않은 상태이므로 같은 작업을 무작정 재시도하지 않는 편이 안전하다.

Browser Bridge 포트가 이미 사용 중인 경우

다른 프로세스가 같은 포트를 점유하고 있으면 연결이 실패한다. 이런 경우 CoS 설정에서 포트를 다른 값으로 바꾸거나, 점유 중인 프로세스를 먼저 종료해야 한다.

고정 포트와 Auto 포트 설정의 차이

고정 포트는 같은 번호를 계속 쓰기 때문에 방화벽 규칙을 한 번만 설정해 두면 되는 대신 충돌 가능성이 있고, Auto 포트는 매번 비어 있는 포트를 찾아 쓰기 때문에 충돌은 피할 수 있지만 외부 도구와 연동할 때 포트 번호를 고정적으로 참조하기 어렵다.

Chrome Extension 버전이 맞지 않는 경우

CoS 앱과 확장 프로그램은 같은 버전끼리만 맞물리도록 설계돼 있어서, 앱만 업데이트하고 확장 프로그램을 재로드하지 않으면 앱이 구버전 확장을 거부한다.

ChatGPT에서 모델이나 앱이 표시되지 않는 경우

CoS의 Reload ChatGPT models 기능을 실행하면 현재 로그인된 계정에서 실제로 사용 가능한 모델 목록을 다시 불러온다.

TOOL_DISABLED 오류가 발생하는 경우

이 오류가 뜨면 먼저 Read-only 모드가 켜져 있지 않은지, 해당 도구에 대응하는 로컬 기능이 꺼져 있지 않은지를 확인한다. 비슷해 보이지만 CALLER_IDENTITY_REQUIRED나 WORKER_IDENTITY_LOST는 호출자 신원 확인 문제를 가리키는 별개의 오류이므로, 이 두 가지가 뜬다고 해서 명령 실행 자체가 전역적으로 막혀 있다는 뜻은 아니다.

UNIDENTIFIED_CALLER가 발생하는 경우

이 오류는 지금 요청을 보낸 대화가 페어링된 브라우저에서 열려 있는지를 CoS가 확인하지 못했을 때 발생한다. CoS는 현재 활성화된 탭을 추측해서 대응하지 않으므로, 반드시 페어링이 이루어진 그 브라우저 창에서 해당 대화를 열어 둔 상태여야 한다.

COMPACTION_IN_PROGRESS가 발생하는 경우

컨텍스트가 가득 차 Compact & Resume이 작동 중일 때 나타나는 오류로, 원본 대화의 인수인계가 끝날 때까지 기다리면 된다. 이후 작업은 새로 만들어진 대화 쪽에서 이어진다.

Chat On Steroids 권한 설정에서 꼭 알아야 할 보안 포인트

승인 폴더와 실제 터미널 권한은 같은 개념이 아니다

앞서 다룬 것처럼, 파일 도구는 승인 폴더를 기준으로 경로를 검증하지만 셸 명령은 그 경계 밖에서도 실행된다. 두 권한을 하나로 묶어 생각하면 실제보다 안전하다고 착각하기 쉽다.

exec 명령이 승인 폴더 밖에서도 실행될 수 있는 이유

명령 실행 도구는 운영체제 수준에서 로그인한 사용자 계정 그대로 프로세스를 띄우는 방식으로 동작하기 때문에, 애초에 파일 경로 검증이라는 개념 자체가 적용되지 않는다. 앱의 경로 검사는 커널이나 가상 머신 수준의 격리가 아니라는 점도 함께 알아 둬야 한다.

Read-only 모드가 차단하는 기능

Read-only 모드는 쓰기, 명령 실행, 데스크톱 제어, 클립보드 쓰기를 한 번에 차단하는 상위 스위치다. 세부 기능을 하나씩 끄는 대신 이 모드 하나로 전체를 잠그는 용도로 쓰인다.

Desktop 권한을 활성화하면 가능한 작업

Desktop 커넥터를 켜면 화면을 관찰하고 마우스, 키보드, 클립보드를 조작하는 것까지 가능해진다. Windows와 macOS에서만 제공되며, macOS에서는 기본값이 꺼진 상태로 시작한다.

Screen Recording과 Accessibility 권한이 필요한 경우

macOS에서 Desktop 커넥터를 쓰려면 시스템 설정에서 화면 기록과 손쉬운 사용 권한을 운영체제 차원에서 별도로 허용해야 한다. CoS 안에서 켰다고 끝나는 것이 아니라 macOS 자체의 승인 절차가 한 번 더 필요하다.

로컬 대화 기록은 어디에 저장되는가

세션 기록은 로컬에 저장되며 기본 보관 기간은 30일이다. 다만 이 기록은 의도적으로 상세하게 남고, Electron의 safeStorage로 암호화되는 자격 증명과 달리 기록 자체는 암호화되지 않는다. 같은 운영체제 계정에 접근할 수 있는 사람이라면 이 기록을 읽을 수 있다는 뜻이다.

Chat On Steroids를 개발 프로젝트에 적용하는 실제 워크플로우

1단계: 프로젝트 구조 먼저 분석시키기

새 프로젝트를 처음 연결하면, 전체 구조를 훑어보게 하는 요청부터 시작하는 편이 이후 작업의 맥락을 잡는 데 도움이 된다.

2단계: 수정 대상 파일을 좁히기

구조 파악이 끝나면 실제로 손댈 파일 범위를 구체적으로 지정한다. 범위가 넓을수록 dry run 검사와 패치 적용에 걸리는 시간도 늘어난다.

3단계: 변경 사항을 코드에 적용하기

V4A 패치가 적용되는 과정을 검토하면서, 필요하면 그 자리에서 추가 지시를 덧붙여 수정 방향을 조정한다.

4단계: 테스트와 빌드 실행하기

명령 실행 권한이 켜져 있다면 수정 직후 바로 테스트를 돌려 회귀 여부를 확인한다.

5단계: 오류 로그를 다시 분석시키기

테스트가 실패하면 그 출력 로그를 그대로 대화에 남겨 다음 수정안을 받는다. 사람이 로그를 옮겨 적는 과정이 빠지는 지점이 이 단계다.

6단계: 최종 변경 사항을 직접 검토하기

자동화된 흐름이라 해도 마지막 diff 검토는 사람이 직접 하는 편이 좋다. 특히 여러 파일에 걸친 대규모 패치일수록 의도치 않은 변경이 섞여 들어갈 가능성을 배제할 수 없다.

Claude Code와 Chat On Steroids는 어떻게 다른가

Claude Code는 터미널 중심이고 Chat On Steroids는 ChatGPT 중심이다

Claude Code는 터미널(또는 IDE 확장) 안에서 에이전트가 직접 실행되는 구조다. 반면 CoS는 대화 자체가 브라우저의 ChatGPT 안에서 이루어지고, 로컬 컴퓨터는 MCP를 통해 그 대화에 손발을 빌려주는 쪽에 가깝다. 대화의 본진이 어디에 있는지가 두 도구의 근본적인 차이다.

같은 프로젝트를 수정하는 방식 비교

Claude Code는 터미널 세션 안에서 명령형으로 작업 지시를 이어가는 흐름에 가깝고, CoS는 웹 채팅 인터페이스의 대화 맥락 안에서 파일과 명령이 도구 호출로 오간다. 결과물은 비슷해도 작업 도중 느껴지는 흐름은 상당히 다르다.

MCP 연결이 필요한 작업과 필요하지 않은 작업

개념 설명이나 알고리즘 질문처럼 로컬 컨텍스트가 필요 없는 작업이라면 어느 도구를 쓰든 큰 차이가 없다. 실제 프로젝트 파일을 직접 읽고 고쳐야 하는 작업에서만 이런 로컬 연동의 존재 여부가 체감된다.

어떤 상황에서 각각의 도구를 사용하는가

이미 특정 생태계(OpenAI 계정과 ChatGPT, 혹은 Anthropic 계정과 Claude)에 익숙하다면 그 쪽 도구를 확장하는 방향이 자연스럽다. 두 도구를 놓고 저울질하기보다는, 지금 쓰고 있는 대화형 모델 구독을 로컬까지 확장할 수 있는지를 먼저 살펴보는 편이 실용적이다.

Chat On Steroids 업데이트 후 다시 확인해야 하는 설정

앱 업데이트 후 Chrome Extension 다시 로드하기

CoS 앱과 확장 프로그램은 버전이 함께 맞물려 있어서, 앱만 업데이트하고 넘어가면 확장 프로그램이 구버전으로 남아 서로 어긋난다.

ChatGPT에서 변경된 MCP 앱 상태 확인하기

워크스페이스 단위로 배포된 앱은 관리자가 갱신하기 전까지 예전에 검토된 도구 스냅샷을 그대로 유지하는 경우가 있으므로, 업데이트 이후 도구 목록이 이상하면 이 부분도 함께 의심해 볼 필요가 있다.

기존 Tunnel과 API Key를 다시 확인해야 하는 경우

연결이 갑자기 끊기면 저장된 터널 ID와 API 키의 권한(Tunnels: Read, Use)이 여전히 유효한지부터 점검한다.

업데이트 후 연결이 끊겼을 때 점검 순서

확장 프로그램 재로드, ChatGPT 쪽 앱 새로고침, 터널 재연결 순으로 하나씩 짚어 나가는 편이 원인을 좁히기 쉽다.

Chat On Steroids 설정 후 실제로 테스트해 볼 작업

로컬 파일 읽기 테스트

승인 폴더 안의 파일 하나를 지정해 내용을 요약해 달라고 요청하는 것으로 연결 상태를 가장 빠르게 확인할 수 있다.

파일 생성 및 수정 테스트

간단한 텍스트 파일을 하나 새로 만들어 보게 하면 쓰기 권한과 패치 적용이 정상 동작하는지 확인할 수 있다.

터미널 명령 실행 테스트

echo 같은 부작용 없는 명령으로 먼저 시험한 뒤, 실제 빌드나 테스트 명령으로 넘어가는 순서가 안전하다.

테스트 코드 실행 테스트

프로젝트에 이미 있는 테스트 스위트를 실행시켜 출력이 대화 안에 제대로 반영되는지 확인한다.

ChatGPT와 로컬 프로젝트가 정상적으로 연결됐는지 확인하기

위 네 가지가 모두 문제없이 동작한다면, Core 커넥터의 핵심 기능은 정상적으로 연결된 상태라고 볼 수 있다.

Chat On Steroids의 장점보다 먼저 알아야 할 한계

아직 베타 소프트웨어라는 점

CoS는 한 명의 메인테이너가 유지보수하는 베타 프로젝트로 문서 여러 곳에 명시돼 있다. 버그 바운티나 응답 시간 보장 같은 장치는 없다.

로컬 권한을 부여하는 만큼 사용자가 확인해야 하는 부분

앞서 다룬 것처럼 서명되지 않은 빌드, 승인 폴더 밖에서도 실행되는 셸 명령, 암호화되지 않은 세션 기록은 모두 사용자가 직접 인지하고 관리해야 하는 지점이다.

ChatGPT 계정의 사용량 및 모델 제한은 그대로 적용된다

CoS는 별도의 API 키를 발급받아 쓰는 구조가 아니라 이미 쓰고 있는 ChatGPT 계정의 대화를 그대로 활용하는 방식이다. 계정에 걸린 모델 가용 범위와 사용량 한도, 컨텍스트 한도가 로컬 연동 여부와 무관하게 그대로 적용된다.

MCP 연결이 모든 ChatGPT 작업을 자동화해 주는 것은 아니다

도구 승인 프롬프트가 뜬 채로 대기하고 있으면 Goal이나 Loop, 에이전트가 멈춘 것처럼 보일 수 있다. 이런 경우 CoS가 열어 둔 ChatGPT 창에서 요청된 동작을 직접 검토하고 승인해야 다음 단계로 넘어간다.

 

💡 에이전틱 개발 환경을 무료로 체험해보고 싶다면? Chat On Steroids 연결 전에 에이전트 기반 개발 환경을 먼저 경험해보고 싶다면 GitLab Duo의 Agentic Chat을 대안으로 활용해볼 수 있습니다.

• 특징: 신용카드 등록 없이 30일 무료 체험 제공
• 지원 모델: GPT-6 Astra 및 Claude Fable 모델 계열 지원
• 활용 방법: GitLab 무료 체험 페이지에서 카드 등록 없이 신청 후 바로 에이전트 기능 테스트 가능

Chat On Steroids 설정 및 ChatGPT 로컬 연동 핵심 요약

설치부터 로컬 연동까지 한 번에 정리

운영체제에 맞는 CoS 설치, Workspace에서 프로젝트 폴더 승인, Setup에서 터널 연결, ChatGPT Developer Mode에서 Core 앱 등록, Companion Extension 로드까지 다섯 단계를 거치면 기본 연동이 끝난다.

반드시 확인해야 하는 권한 설정

승인 폴더 범위, Read-only 모드 여부, 그리고 셸 명령이 그 폴더 경계 밖에서도 실행된다는 사실은 연결 전에 한 번은 짚고 넘어가야 하는 지점이다.

연결 오류가 발생했을 때 가장 먼저 볼 항목

Core Actions 목록이 비어 있는지, 저장된 터널 ID가 지금 접속한 워크스페이스와 일치하는지, 확장 프로그램과 앱의 버전이 맞는지부터 순서대로 확인하면 대부분의 연결 오류 원인을 좁힐 수 있다.

실제 개발에 적용할 때의 권장 작업 순서

구조 파악 → 수정 범위 좁히기 → 패치 적용 → 테스트 실행 → 오류 로그 재분석 → 사람의 최종 검토, 이 여섯 단계를 하나의 루틴으로 고정해 두면 로컬 연동의 이점을 가장 안정적으로 가져갈 수 있다.