chatgpt-codex-onboarding은(는) 무엇을 하나요?
ChatGPT 또는 Codex 구독을 OAuth 디바이스 코드 로그인으로 연결합니다. 사용자가 ChatGPT Plus, Pro 또는 Team 계정으로 로그인하려고 할 때 사용합니다(예: "내 Codex 구독 사용", "ChatGPT로 로그인").
개요
이 스킬은 OAuth 2.0 디바이스 코드 인증 흐름을 사용하여 사용자가 기존 ChatGPT 또는 Codex 구독을 AI 에이전트에 안전하게 연결할 수 있도록 합니다. 사용자가 "Codex 구독 사용" 또는 "ChatGPT 계정 연결"을 요청하면, 이 스킬은 디바이스 코드와 사용자가 브라우저에서 방문할 URL을 생성합니다. 사용자는 해당 URL에서 코드를 입력하고 인증을 완료한 후, 에이전트는 자동으로 연결을 완료합니다.
사용 방법
- 사용자가 "내 ChatGPT 계정 연결" 또는 "Codex 사용"을 요청합니다.
- 스킬이 디바이스 코드와 인증 URL을 생성합니다.
- 사용자는 제공된 URL을 브라우저에서 열고 디바이스 코드를 입력합니다.
- 사용자가 ChatGPT/Codex 계정으로 로그인하고 권한을 승인합니다.
- 에이전트가 성공적으로 연결되었음을 확인합니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 OAuth 디바이스 코드 흐름을 지원하는 AI 에이전트
인증 흐름
- 토큰 요청: 에이전트가 OAuth 서버에 디바이스 인증을 요청합니다.
- 디바이스 코드 발급: 서버가
device_code,user_code,verification_uri를 반환합니다. - 사용자 인증: 사용자가 브라우저에서
verification_uri로 이동하여user_code를 입력합니다. - 토큰 폴링: 에이전트가
device_code로 서버를 주기적으로 폴링하여 액세스 토큰을 받습니다. - 연결 완료: 토큰이 발급되면 에이전트가 연결을 확인하고 필요한 API 호출을 수행합니다.
환경 변수
CHATGPT_CLIENT_ID: OAuth 클라이언트 IDCHATGPT_CLIENT_SECRET: OAuth 클라이언트 시크릿 (필요한 경우)CHATGPT_SCOPES: 요청할 권한 범위 (기본값:openid profile email)
참고 사항
- 이 스킬은 사용자의 ChatGPT Plus, Pro 또는 Team 구독에만 작동합니다.
- 무료 계정은 지원되지 않습니다.
- 인증이 완료되면 연결은 일정 시간 동안 유지됩니다.
- 사용자는 언제든지 계정 설정에서 연결을 해제할 수 있습니다.