명령어
ChatGPT 데스크톱 앱의 명령어 및 키보드 단축키 참고 자료
다음 명령어와 키보드 단축키를 사용하여 앱을 탐색할 수 있습니다.
키보드 단축키
| 작업 | 단축키 | |
|---|---|---|
| 일반 | ||
| 명령어 메뉴 | Cmd/Ctrl + Shift + P 또는 Cmd/Ctrl + K | |
| 설정 | Cmd/Ctrl + , | |
| 키보드 단축키 | Cmd/Ctrl + Shift + / | |
| 폴더 열기 | Cmd/Ctrl + O | |
| 뒤로 이동 | Cmd/Ctrl + [ | |
| 앞으로 이동 | Cmd/Ctrl + ] | |
| 글꼴 크기 늘리기 | Cmd/Ctrl + + | |
| 글꼴 크기 줄이기 | Cmd/Ctrl + - | |
| 사이드바 전환 | Cmd/Ctrl + B | |
| 검토 탭 열기 | Ctrl + Shift + G | |
| 검토 패널 전환 | Cmd/Ctrl + Alt + B | |
| 하단 패널 전환 | Cmd/Ctrl + J | |
| 터미널 전환 | Ctrl + ` | |
| 터미널 지우기 | Ctrl + L | |
| 채팅 | 빠른 채팅 | Cmd + Option + N (macOS) 또는 Ctrl + Alt + N (Windows) |
| 새 채팅 | Cmd/Ctrl + N 또는 Cmd/Ctrl + Shift + O | |
| 채팅 검색 | Cmd/Ctrl + G | |
| 채팅에서 찾기 | Cmd/Ctrl + F | |
| 이전 채팅 | Cmd/Ctrl + Shift + [ | |
| 다음 채팅 | Cmd/Ctrl + Shift + ] | |
| 입력 | 받아쓰기 | Ctrl + Shift + D |
단축키를 찾거나 사용자 지정하거나 초기화하려면 설정 > 키보드 단축키를 여세요. 명령어 이름으로 검색하거나 검색 필드를 키 입력 모드로 전환한 다음 찾으려는 단축키를 누를 수 있습니다.
이전 채팅 검색 및 채팅 내 찾기
채팅 검색(Cmd/Ctrl + G)을 사용하여 이전
채팅을 다시 여세요. 확장 일치 기능을 사용할 수 있으면 채팅 내용과
Git 브랜치 이름도 일치시킬 수 있으므로 채팅에 나온 문구나
fix/login-redirect 같은 브랜치를 검색할 수 있습니다.
채팅을 연 후 채팅에서 찾기(Cmd/Ctrl + F)를 사용하여 채팅 내 텍스트를 찾으세요. 다른 채팅까지 검색하지는 않습니다.
/(으)로 시작하는 작업은 슬래시 명령어를 참조하세요.
딥 링크
ChatGPT 데스크톱 앱은 호환성을 위해 codex:// URL 스킴을 유지하므로
링크를 통해 앱의 특정 부분을 직접 열 수 있습니다. 쿼리 문자열 값을 URL에
추가하기 전에 인코딩하세요.
지원되는 링크
링크를 만들 때는 다음 표준 형식을 사용하세요. 아래 섹션에는 링크 유형별 전체 참고 정보가 나와 있습니다.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://threads/new |
새 로컬 채팅. |
codex://new?<query> |
하나 이상의 쿼리 매개변수가 있는 새 로컬 채팅. |
codex://threads/<thread-id> |
로컬 채팅. <thread-id>은 해당 채팅의 기술적 스레드 ID입니다. |
codex://settings |
설정. |
codex://settings/connections/<connection-type> |
컴퓨터, 기기 또는 SSH 연결 설정. |
codex://settings/connections/ssh/add?name=<ssh-config-host> |
SSH config의 호스트를 Codex에 추가합니다. |
codex://skills |
스킬. |
codex://automations |
생성 흐름이 열린 예약 화면. |
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name> |
알려진 마켓플레이스의 플러그인 설치 흐름. |
codex://plugins/<plugin-id> |
플러그인 상세 페이지. |
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path> |
로컬 마켓플레이스의 로컬 플러그인 상세 페이지. |
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url> |
펫 설치 흐름. |
채팅
기존 로컬 채팅을 열거나 새 채팅을 시작해야 할 때 다음 링크를 사용하세요.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://threads/<thread-id> |
로컬 채팅. <thread-id>은 해당 채팅의 기술적 스레드 ID입니다. |
codex://threads/new |
새 로컬 채팅. |
codex://threads/new?<query> |
선택적 쿼리 매개변수가 있는 새 로컬 채팅. |
codex://new?<query> |
새 로컬 채팅. prompt, path 또는 originUrl 중 하나 이상을 포함해야 하며, 그렇지 않으면 링크가 아무 작업도 하지 않습니다. |
codex://threads/new 또는 codex://new에는 필요에 따라 다음 쿼리 매개변수를 추가하세요. 동일한 URL에서 함께 사용할 수 있습니다.
| 쿼리 매개변수 | 필수 여부 | 기능 |
|---|---|---|
prompt=<text> |
아니요 | 작성기의 초기 텍스트를 설정합니다. |
path=<absolute-path> |
아니요 | 로컬 워크스페이스에서 새 채팅을 엽니다. path은 로컬 디렉터리의 절대 경로여야 합니다. 유효하면 Codex가 해당 디렉터리를 활성 워크스페이스로 사용합니다. |
originUrl=<git-remote-url> |
아니요 | Git 원격 URL을 기준으로 현재 워크스페이스 루트 중 하나와 일치시킵니다. path도 있으면 Codex는 path을 먼저 확인합니다. |
예: Codex 사용 방식에 관한 재미있는 통계를 보여 주세요
플러그인으로 채팅 시작하기
사용자가 플러그인 기반 채팅을 시작할 수 있도록 인코딩하기 전에 프롬프트에 플러그인 멘션을 포함하세요.
[@Example](plugin://example@openai-curated) Summarize this document: https://example.com/document/123전체 프롬프트를 URI 구성 요소로 인코딩하고(예: JavaScript의
encodeURIComponent 사용) 이를 prompt 매개변수로 전달하세요.
codex://new?prompt=%5B%40Example%5D(plugin%3A%2F%2Fexample%40openai-curated)%20Summarize%20this%20document%3A%20https%3A%2F%2Fexample.com%2Fdocument%2F123링크를 열면 디코딩된 프롬프트가 작성기에 입력된 새 채팅이 열립니다. 프롬프트는 자동으로 전송되지 않습니다. 사용자가 프롬프트를 전송하면 Codex는 해당 채팅에서 설치된 플러그인을 사용할 수 있습니다. 플러그인이 설치되어 있지 않지만 사용자가 이용할 수 있는 경우 Codex는 사용자에게 플러그인을 설치하고 필요한 커넥터를 연결하도록 요청합니다. 설정을 마치면 사용자는 계속을 선택하여 동일한 채팅을 재개할 수 있습니다. 워크스페이스 설정에서 사용자가 설치할 수 있는 플러그인을 제한할 수 있습니다. 플러그인 설치 및 권한에 관한 자세한 내용은 플러그인을 참조하세요.
설정
설정 또는 특정 설정 페이지를 열어야 할 때 다음 링크를 사용하세요.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://settings |
설정. |
codex://settings/browser-use |
브라우저 설정. |
codex://settings/computer-use/google-chrome |
컴퓨터 사용을 위한 Google Chrome 설정. |
codex://settings/connections |
원격 연결 설정. |
codex://settings/connections/computer |
다른 기기에서 이 Mac 또는 PC를 제어하기 위한 설정. |
codex://settings/connections/devices |
다른 기기를 제어하기 위한 설정. |
codex://settings/connections/ssh |
SSH 연결 설정. |
codex://settings/connections/ssh/add?name=<ssh-config-host> |
지정된 호스트 별칭을 Codex 관리 연결로 추가한 다음, SSH 연결 설정을 엽니다. |
name 값은 ~/.ssh/config의 호스트 별칭과 일치해야 합니다. 이 링크는
추가된 호스트의 자동 연결을 비활성화합니다. Codex가 지정된 호스트를 찾지 못하면
SSH 연결 설정을 열고 오류를 표시합니다.
지원되지 않는 codex://settings/... 경로는 기본 설정 페이지를 엽니다.
Skills
Skills를 열어야 할 때는 다음 링크를 사용합니다.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://skills |
Skills. |
Scheduled
Scheduled를 열어야 할 때는 다음 링크를 사용합니다.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://automations |
생성 흐름이 열린 상태의 Scheduled. |
Plugins
Plugin 링크는 마켓플레이스에서 설치하는지, plugin을 여는지, 로컬 marketplace.json에서 작업하는지에 따라 서로 다른 형식을 사용합니다. plugin의 기본 사항은 Plugins를 참조하세요. 로컬 또는 저장소 마켓플레이스 설정은 Plugin 빌드를 참조하세요.
Plugin 설치
Codex가 이미 알고 있는 마켓플레이스에서 plugin 설치 흐름을 열려면 이 형식을 사용합니다.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name> |
plugin 세부 정보 또는 설치 흐름. |
| 쿼리 매개변수 | 필수 여부 | 기능 |
|---|---|---|
marketplace=<marketplace-name> |
예 | 마켓플레이스를 식별합니다. OpenAI 큐레이션 plugin에는 openai-curated을 사용합니다. |
설치 링크는 marketplace 쿼리 매개변수만 허용합니다. Codex가 요청한 마켓플레이스나 plugin을 찾지 못하면 대신 Plugins 페이지를 엽니다.
Plugin 세부 정보
| 딥 링크 | 열리는 항목 |
|---|---|
codex://plugins/<plugin-id> |
plugin 세부 정보 페이지. |
<plugin-id>는 plugin을 식별해야 합니다. OpenAI 큐레이션 plugin에는 <plugin-name>@openai-curated 형식을 사용합니다.
Codex가 생성한 plugin 링크에는 다음 쿼리 매개변수도 포함될 수 있습니다. 링크를 직접 작성할 때는 둘 다 생략하세요.
| 쿼리 매개변수 | 필수 여부 | 기능 |
|---|---|---|
hostId=<host-id> |
아니요 | local 또는 구성된 원격 연결 중 하나와 같이 plugin 컨텍스트를 소유한 Codex 호스트를 식별합니다. Codex가 이러한 ID를 제공합니다. |
source=manage |
아니요 | 앱의 plugin 관리 진입점을 유지합니다. 관리자 전용이 아닙니다. |
예: OpenAI Developers plugin 열기
로컬 plugin
로컬 또는 저장소 마켓플레이스 설정은 Plugin 빌드를 참조하세요.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path> |
로컬 마켓플레이스의 로컬 plugin 세부 정보 페이지. |
| 쿼리 매개변수 | 필수 여부 | 기능 |
|---|---|---|
marketplacePath=<absolute-marketplace-path> |
예 | 로컬 marketplace.json의 절대 경로입니다. 예: /Users/alex/.agents/plugins/marketplace.json. |
mode=share |
아니요 | 해당 로컬 plugin의 공유 흐름을 엽니다. |
Pets
해당 기능이 활성화되어 있을 때 pet 설치 흐름을 열려면 다음 링크를 사용합니다.
| 딥 링크 | 열리는 항목 |
|---|---|
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url> |
pet 설치 흐름. |
| 쿼리 매개변수 | 필수 여부 | 기능 |
|---|---|---|
name=<pet-name> |
예 | pet 이름을 설정합니다. 값에는 공백이 아닌 문자가 하나 이상 포함되어야 합니다. |
imageUrl=<https-image-url> |
예 | pet 이미지 또는 스프라이트 시트의 절대 HTTPS URL을 제공합니다. |
description=<text> |
아니요 | 설치 흐름에 설명을 추가합니다. |
spriteVersionNumber=<1-or-2> |
아니요 | 스프라이트 시트 형식을 선택합니다. 기본값은 1이며, 지원되는 유일한 다른 값은 2입니다. |
설치 링크는 이러한 쿼리 매개변수만 허용합니다. 잘못된 이름, HTTPS가 아닌 이미지 URL, 지원되지 않는 스프라이트 버전 또는 추가 경로 세그먼트가 있으면 링크가 아무 작업도 수행하지 않습니다.