OpenCode GUI 클라이언트는 OpenAI 호환 chat/completions 프로토콜을 사용합니다. 커스텀 제공자를 4AICode로 지정하면 OpenCode에서 gpt-6-astra, gpt-5.6-sol, gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex 등을 사용할 수 있습니다.

사전 준비

4AICode 토큰: 대시보드 → 토큰 관리에서 생성. 형식 sk-4ai-...
Provider ID: 4aicode
Base URL: https://relay.4aicode.com/v1
기본 모델: gpt-5.4
코드 모델: gpt-5.3-codex

GUI 클라이언트 설정

왼쪽 하단 톱니 설정 → Provider / Models에서 OpenAI 호환 또는 Custom 제공자 추가.

필드 입력:

필드	값
Provider / Type	`OpenAI Compatible` 또는 `Custom`
Name / Display name	`4AICode`
Provider ID	`4aicode`
Base URL / API Base URL	`https://relay.4aicode.com/v1`
API Key	`sk-4ai-xxxxxxxxxxxxxxxx`
Model ID	`gpt-5.4`
Small model ID	`gpt-5.4-mini`
Timeout / Request timeout	`600000` ms 또는 `600` s
Chunk timeout / Stream timeout	`120000` ms 또는 `120` s

저장 후 메인 화면 하단 모델 선택:

4AICode / GPT-5.4

새 대화를 만들고:

Hello

정상 응답이면 GUI 설정 완료.

GUI 타임아웃 오류

다음과 비슷하면 GUI 타임아웃 필드를 확인:

Provider response headers timed out after 10000ms

OpenCode GUI가 제공자 응답 헤더 대기 중 타임아웃한 것입니다. Codex 업스트림 첫 청크가 10초를 넘길 수 있어 GUI 고급 설정에서 타임아웃을 늘리세요.

필드	권장값
Request timeout / Timeout	`600000` ms
Chunk timeout / Stream timeout	`120000` ms

GUI에 타임아웃 입력이 없으면 아래 opencode.json 방식 사용.

설정 파일 방식

GUI에서 타임아웃을 직접 넣을 수 없는 버전용. 생성 또는 편집:

~/.config/opencode/opencode.json

추가:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "4aicode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "4AICode",
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "apiKey": "sk-4ai-xxxxxxxxxxxxxxxx",
        "timeout": 600000,
        "chunkTimeout": 120000
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini"
        },
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex"
        }
      }
    }
  },
  "model": "4aicode/gpt-5.4",
  "small_model": "4aicode/gpt-5.4-mini"
}

OpenCode GUI 재시작 후 모델 선택에서 4AICode / GPT-5.4 선택.

대화형 자격 증명 추가

프로젝트 디렉터리에서 OpenCode 시작:

opencode

OpenCode에서:

/connect

프롬프트에 따라:

Provider: Other
Provider ID: 4aicode
API key: sk-4ai-xxxxxxxxxxxxxxxx

프로젝트 루트에 opencode.json 생성·편집. 내용은 위 「설정 파일 방식」 참고.

OpenCode로 돌아와:

/models

4AICode 아래 모델 선택.

환경 변수 방식

토큰을 환경 변수에 저장. 팀에서 opencode.json 공유 시 적합.

export FOURAICODE_API_KEY="sk-4ai-xxxxxxxxxxxxxxxx"

opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "4aicode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "4AICode",
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "apiKey": "{env:FOURAICODE_API_KEY}",
        "timeout": 600000,
        "chunkTimeout": 120000
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini"
        },
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex"
        }
      }
    }
  },
  "model": "4aicode/gpt-5.4",
  "small_model": "4aicode/gpt-5.4-mini"
}

전역 설정 경로

사용자 수준:

~/.config/opencode/opencode.json

프로젝트 수준은 프로젝트 루트:

opencode.json

프로젝트 설정이 우선하며, 특정 저장소에 제공자·모델을 고정할 때 적합.

사용 가능한 모델

Model	OpenCode 모델 형식	용도
`gpt-6-astra`	`4aicode/gpt-6-astra`	차세대 플래그십; 공식 가격의 15%
`gpt-5.6-sol`	`4aicode/gpt-5.6-sol`	복잡한 코딩·장시간·다중 파일 리팩터링
`gpt-5.6-terra`	`4aicode/gpt-5.6-terra`	균형 티어·가성비
`gpt-5.6-luna`	`4aicode/gpt-5.6-luna`	경량·저렴·빠름
`gpt-5.5`	`4aicode/gpt-5.5`	이전 세대 플래그십
`gpt-5.4`	`4aicode/gpt-5.4`	기본 권장·일반 작업 안정
`gpt-5.4-mini`	`4aicode/gpt-5.4-mini`	경량·빠른 검증·비용 민감
`gpt-5.3-codex`	`4aicode/gpt-5.3-codex`	코드 최적화·Codex 스타일

모델 필드는 전체 OpenCode 형식, 예: 4aicode/gpt-5.3-codex. UI 표시명은 GPT-5.3 Codex 가능.

FAQ

Provider response headers timed out after 10000ms

GUI가 응답 헤더 대기 중 타임아웃. Codex 첫 청크가 10초 넘을 수 있음. 설정에서 timeout, chunkTimeout 증가:

{
  "provider": {
    "4aicode": {
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "timeout": 600000,
        "chunkTimeout": 120000
      }
    }
  }
}

gpt-5.4-mini로 Hello 연결 테스트 후 gpt-5.4 또는 gpt-5.3-codex로 복귀.

401 Unauthorized

API key 만료 또는 복사 오류. 대시보드 → 토큰 관리에서 새 토큰 후 /connect 또는 환경 변수 갱신.

400 Model Not Supported

표의 literal model ID 사용. 흔한 선택: 4aicode/gpt-5.4, 4aicode/gpt-5.3-codex.

설정 후 모델 목록 안 보임

다음 확인:

/connect Provider ID가 4aicode
opencode.json 제공자 키가 "4aicode"
model이 4aicode/gpt-5.4 같은 전체 형식

OpenCode 설정