Droid

Droid는 Factory의 CLI 코딩 에이전트입니다. 공식 문서: Factory BYOK.

먼저 4AICode 토큰을 환경 변수에 저장:

export RELAY4AI_API_KEY=sk-4ai-xxxxxxxxxxxxxxxx

~/.factory/settings.json 편집:

{
  "customModels": [
    {
      "model": "4aicode-gpt-5.6-terra",
      "displayName": "4AICode GPT 5.6 Terra",
      "baseUrl": "https://relay.4aicode.com/v1",
      "apiKey": "${RELAY4AI_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384,
      "index": 0,
      "id": "custom:4AICode-GPT-5.6-Terra-0"
    },
    {
      "model": "4aicode-gpt-5.6-sol",
      "displayName": "4AICode GPT 5.6 Sol",
      "baseUrl": "https://relay.4aicode.com/v1",
      "apiKey": "${RELAY4AI_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384,
      "index": 1,
      "id": "custom:4AICode-GPT-5.6-Sol-1"
    },
    {
      "model": "4aicode-gpt-6-astra",
      "displayName": "4AICode GPT 6 Astra",
      "baseUrl": "https://relay.4aicode.com/v1",
      "apiKey": "${RELAY4AI_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384,
      "index": 2,
      "id": "custom:4AICode-GPT-6-Astra-2"
    },
    {
      "model": "4aicode-gpt-5.4-mini",
      "displayName": "4AICode GPT 5.4 Mini",
      "baseUrl": "https://relay.4aicode.com/v1",
      "apiKey": "${RELAY4AI_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384,
      "index": 3,
      "id": "custom:4AICode-GPT-5.4-Mini-3"
    },
    {
      "model": "gemini-3.8-flash",
      "displayName": "4AICode Gemini 3.8 Flash",
      "baseUrl": "https://relay.4aicode.com/v1",
      "apiKey": "${RELAY4AI_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384,
      "index": 4,
      "id": "custom:4AICode-Gemini-3.8-Flash-4"
    }
  ],
  "model": "custom:4AICode-GPT-5.6-Terra-0",
  "sessionDefaultSettings": {
    "model": "custom:4AICode-GPT-5.6-Terra-0"
  }
}

저장 후 Droid를 재시작합니다. droid로 대화 모드에 들어 /model로 4AICode GPT 5.6 Terra를 선택하세요.

4aicode-gpt-* 별칭은 gpt-5.6-terra를 직접 쓰지 않기 위함입니다. Droid가 일반 Chat Completions 모델로 취급하고, 4AICode 게이트웨이가 실제 Codex 모델로 매핑해 시작 시 GPT-5 / Responses API provider 검증 경고를 줄입니다.

헤드리스 예:

droid exec --model "custom:4AICode-GPT-5.6-Terra-0" "summarize this repository"

플래그십이 필요할 때 Sol 명시:

droid exec --model "custom:4AICode-GPT-5.6-Sol-1" "refactor this repository"

경량 모델:

droid exec --model "custom:4AICode-GPT-5.4-Mini-3" "fix typos in docs"

Gemini 3.8 Flash:

droid exec --model "custom:4AICode-Gemini-3.8-Flash-4" "analyze this repository"

Pi

Pi는 pi.dev의 CLI 코딩 에이전트입니다. 커스텀 모델 설정 파일은 ~/.pi/agent/models.json. 공식: Pi Custom Models.

먼저 토큰을 환경 변수에:

export RELAY4AI_API_KEY=sk-4ai-xxxxxxxxxxxxxxxx

~/.pi/agent/models.json 편집. Pi apiKey에서 환경 변수 참조 시 $ 접두사: $RELAY4AI_API_KEY.

{
  "providers": {
    "4aicode": {
      "baseUrl": "https://relay.4aicode.com/v1",
      "api": "openai-responses",
      "apiKey": "$RELAY4AI_API_KEY",
      "authHeader": true,
      "models": [
        {
          "id": "gpt-5.6-terra",
          "name": "4AICode GPT 5.6 Terra",
          "reasoning": true,
          "maxTokens": 16384
        },
        {
          "id": "gpt-5.6-sol",
          "name": "4AICode GPT 5.6 Sol",
          "reasoning": true,
          "maxTokens": 16384
        },
        {
          "id": "gpt-6-astra",
          "name": "4AICode GPT 6 Astra",
          "reasoning": true,
          "maxTokens": 16384
        },
        {
          "id": "gpt-5.4-mini",
          "name": "4AICode GPT 5.4 Mini",
          "reasoning": true,
          "maxTokens": 16384
        },
        {
          "id": "gemini-3.8-flash",
          "name": "4AICode Gemini 3.8 Flash",
          "reasoning": false,
          "maxTokens": 16384
        }
      ]
    }
  }
}

실행:

pi --provider 4aicode --model gpt-5.6-terra

Pi 대화형 /model로 4AICode GPT 5.6 Terra로 전환할 수도 있습니다.

플래그십 Sol:

pi --provider 4aicode --model gpt-5.6-sol

Astra:

pi --provider 4aicode --model gpt-6-astra

Gemini 3.8 Flash:

pi --provider 4aicode --model gemini-3.8-flash

확인

설정 후 ping 메시지를 보내고 대시보드 → 사용 이력을 엽니다. 요청 이력에 해당 모델이 보이면 성공입니다.

Gemini 3.8 Flash로 확인:

pi --provider 4aicode --model gemini-3.8-flash "ping"

Droid 및 Pi에서 4AICode 사용

Droid

Pi

확인