ChatGPT

ChatGPT (OpenAI 계정)

ChatGPT 구독을 Docker Agent에서 그대로 쓰는 방법을 설명해요. OpenAI 계정으로 로그인하면 별도의 API 키 없이도 ChatGPT의 모델을 Docker Agent에서 사용할 수 있어요.

출처: 문서

본문

chatgpt 프로바이더는 OPENAI_API_KEY 대신 ChatGPT 계정으로 인증해요(OpenAI의 Codex CLI가 쓰는 "Sign in with ChatGPT" 흐름과 같아요). 사용량은 토큰당 과금되는 API 크레딧이 아니라 ChatGPT Plus, Pro, Business 요금제에 청구돼요.

내부적으로 Docker Agent는 ChatGPT Codex 백엔드(https://chatgpt.com/backend-api/codex)와 통신하는데, 이 백엔드가 OpenAI Responses API로 gpt-5 모델 계열을 제공해요. GPT-5.6(Sol/Terra/Luna)도 여기서 제공되고, GPT-5.2와 GPT-5.3-Codex는 ChatGPT 로그인 방식에서는 지원이 중단(deprecated)됐어요.

사전 준비

  • 유료 ChatGPT 구독(Plus, Pro 또는 Business).
  • 로그인이 실행되는 머신의 브라우저(OAuth 흐름은 고정된 localhost:1455 콜백을 사용해요).

로그인

docker agent setup

프로바이더 목록에서 chatgpt를 고르면 API 키를 묻는 대신 마법사가 ChatGPT 로그인 페이지로 브라우저를 열고, 그 결과로 얻은 OAuth 자격 증명을 Docker Agent 설정 디렉터리(~/.config/cagent/chatgpt-auth.json, 소유자 전용 권한)에 저장해요. 액세스 토큰은 자동으로 갱신되고, 리프레시 토큰이 취소된 경우에만 다시 로그인하면 돼요.

관련 명령어:

docker agent doctor                        # chatgpt 행에서 자격 증명 상태를 보여줘요
rm ~/.config/cagent/chatgpt-auth.json      # 로그아웃 (저장된 로그인 정보 삭제)

설정

인라인

agents:
  root:
    model: chatgpt/gpt-5.6
    instruction: You are a helpful assistant.

네임드 모델 (Named model)

models:
  gpt:
    provider: chatgpt
    model: gpt-5.6
    thinking_budget: medium

agents:
  root:
    model: gpt

사용 가능한 모델

Codex 백엔드는 ChatGPT 요금제에서 쓸 수 있는 모델을 제공해요. 대표적으로 이렇답니다:

모델 용도
gpt-5.6 gpt-5.6-sol의 별칭, 범용·강력한 추론
gpt-5.6-sol 프론티어 모델, 가장 강력
gpt-5.6-terra 일상 작업의 주력 모델
gpt-5.6-luna 대량 처리용, 비용 효율적
gpt-5.2 ChatGPT 로그인 방식에서는 지원 중단
gpt-5.2-codex ChatGPT 로그인 방식에서는 지원 중단

노력(Effort) 선택기는 GPT-5.6 계열에서 Low/Medium/High/XHigh/Max를 제공해요(Minimal은 없어요).

동작 방식

  • 인증: docker agent setup의 로그인은 auth.openai.com을 상대로 OAuth 2.0 authorization-code + PKCE 흐름을 실행해요. 저장된 로그인은 자격 증명 검사(doctor, first_available, auto model selection)에서 가상 변수 CHATGPT_OAUTH_TOKEN으로 노출돼요.
  • API: 요청은 Responses API로만 나가요. 백엔드에 Chat Completions 엔드포인트가 없어서 api_type은 자동으로 고정돼요.
  • 요청 형태: 백엔드는 상태 없는 요청(store: false)과 최상위 instructions 필드를 요구해서, Docker Agent는 시스템 메시지를 그쪽으로 옮겨요. 클라이언트 측 샘플링 파라미터(temperature, top_p, max_tokens)는 백엔드에서 지원하지 않아 제거돼요.

토큰을 명시적으로 설정하기

CHATGPT_OAUTH_TOKEN은 다른 자격 증명처럼 설정할 수 있어요(셸 환경 변수, --env-from-file 등). 명시적으로 설정한 값은 저장된 로그인보다 우선해요. 미리 발급된 액세스 토큰을 쓰는 단기 CI 실행에 유용하지만, 그런 토큰은 만료되고 갱신되지 않는다는 점을 기억해 두세요.

ChatGPT 구독 vs OpenAI API 키

chatgpt openai
자격 증명 ChatGPT 계정 로그인 OPENAI_API_KEY
결제 ChatGPT 요금제에 포함(속도 제한) 토큰당 과금
모델 Codex 백엔드가 제공하는 gpt-5 계열 OpenAI API 전체 카탈로그
샘플링 제어(temperature 등) 지원 안 함 지원
임베딩 / 리랭킹 지원 안 함 지원

두 자격 증명이 모두 설정돼 있으면 자동 모델 선택은 openai를 우선해요. 구독을 쓰려면 --model chatgpt/gpt-5.6(또는 네임드 모델)로 고정하면 돼요.

참고 Codex 백엔드 사용은 OpenAI의 ChatGPT·Codex 이용 약관이 적용돼요. 로그인은 사용자별로 이루어지므로 저장된 자격 증명을 공유하지 마세요.

더 알아보기 (Learn more)