어떤 Agent 제품에서도 Agent.Space 요금제와 크레딧 사용

02 / Developer API

어떤 Agent 제품에서도 Agent.Space 요금제와 크레딧 사용

Codex 전용 계정 요금제는 OpenAI 모델에, 크레딧은 기타 사용 가능한 모델의 종량제 결제에 사용됩니다. Agent.Space뿐 아니라 Codex, Claude Code, OpenCode, Hermes 등 익숙한 Agent 제품에서도 사용할 수 있습니다.

내 API Key 보기

Developer API 결제 수단

요금제 + 크레딧

Codex 전용 계정

OpenAI 모델

Codex 전용 계정 요금제에 포함됩니다.

공식 종량제

기타 사용 가능한 모델

필요할 때 충전하는 크레딧에서 결제됩니다.

익숙한 Agent 제품에서 사용

기본 제공Agent.Space
Codex
Claude Code
OpenCode
Hermes
자체 Agent 제품

Agent.Space에서는 바로 사용할 수 있습니다. 다른 제품은 Developer API를 한 번만 설정하면 됩니다.

GPT Image 2는 요금제 한도를 먼저 사용하며, 요금제가 없거나 한도를 소진하면 크레딧으로 종량제 결제합니다. 다른 모델은 표시된 결제 방식을 따릅니다.

요금제 보기Developer API 설정

03 / Agent 클라이언트

익숙한 클라이언트에서 Agent.Space 모델 사용

Codex, Claude Code, OpenCode를 내려받아 Agent.Space Developer API를 가리키기만 하면 됩니다. API Key 하나로 요금제 한도와 크레딧, 사용 가능한 모든 모델을 매일 쓰는 터미널과 에디터로 가져올 수 있습니다.

  • Codex

    OpenAI · 터미널과 IDE용 Coding Agent

    OpenAI 공식 Coding Agent로 CLI, IDE 확장, 데스크톱 앱을 제공합니다. OpenAI Responses 프로토콜로 Agent.Space에 연결해 Codex 전용 계정 요금제의 OpenAI 모델을 바로 사용합니다.

    • macOS
    • Linux
    • Windows

    설치 · macOS / Linux

    bash
    curl -fsSL https://chatgpt.com/codex/install.sh | sh
    공식 사이트에서 다운로드

  • Claude Code

    Anthropic · 터미널 Coding Agent

    Anthropic 공식 Coding Agent로 네이티브 Anthropic Messages 프로토콜을 사용합니다. Base URL을 Agent.Space로 지정하면 크레딧 종량제로 Claude 모델을 호출할 수 있습니다.

    • macOS
    • Linux
    • Windows

    설치 · macOS / Linux

    bash
    curl -fsSL https://claude.ai/install.sh | bash
    공식 사이트에서 다운로드

  • OpenCode

    오픈소스 · 터미널 Coding Agent

    사용자 정의 Provider를 지원하는 오픈소스 터미널 Agent로 OpenAI와 Anthropic 프로토콜을 모두 지원합니다. 설정 하나로 Agent.Space의 모든 모델을 사용할 수 있습니다.

    • macOS
    • Linux
    • Windows

    설치 · macOS / Linux

    bash
    curl -fsSL https://opencode.ai/install | bash
    공식 사이트에서 다운로드

Agent.Space를 통해 연결해야 하는 이유

  • Key 하나

    API Key 하나로 여러 모델 제공사

    OpenAI, Anthropic, DeepSeek 등 모델이 같은 Key와 Endpoint를 공유합니다. 모델을 바꿔도 계정은 그대로입니다.

  • 두 가지 프로토콜

    OpenAI Responses와 Anthropic Messages

    각 클라이언트의 네이티브 프로토콜로 연결합니다. 프록시나 클라이언트 수정 없이 한 번 설정하면 계속 쓸 수 있습니다.

  • 투명한 과금

    요금제와 크레딧은 분리 유지

    요금제에 포함된 모델은 요금제 한도를 먼저 쓰고 나머지는 크레딧으로 결제되며, 모든 요청을 Request history에서 확인할 수 있습니다.

  • 자유로운 전환

    언제든 클라이언트 교체

    오늘은 Codex, 내일은 Claude Code. Key와 한도는 그대로라 워크플로가 끊기지 않습니다.

세 단계면 끝납니다. API Key를 받고, 모델을 고르고, 설정을 클라이언트에 적습니다. 클라이언트 코드는 바꾸지 않아도 됩니다.

  1. API Key 받기

    Agent.Space Developer API 패널에서 “Codex · MacBook” 같은 Key를 만듭니다. 복사한 설정의 <your-api-key>를 전체 값으로 바꾸세요.

  2. 모델 고르기

    연결 가이드에서 클라이언트와 사용 가능한 모델을 고르세요. 템플릿에 정확한 모델 ID가 자동으로 입력됩니다.

  3. 클라이언트 설정 작성

    전체 설정을 복사하고 Key 자리 표시자를 바꾼 뒤 표시된 경로에 저장하세요. 설정 파일은 로컬에만 보관하세요.

  1. 기존 로그인 정보 삭제

    ~/.codex/auth.json 파일이 있다면 먼저 삭제하세요.

  2. 설정 작성

    처음 세 모델 설정을 config.toml 맨 위의 모든 [section] 앞에 두세요. 같은 이름의 기존 설정을 교체하고 Provider 블록 전체를 유지하세요.

  3. API Key 입력

    <your-api-key>를 내 Key로 바꾸고 파일을 로컬에 저장하세요.

내 API Key 받기

설정 파일 · ~/.codex/config.toml

toml
# IMPORTANT: Always keep this block at the TOP of this file.# ↓model = "gpt-6-astra"model_reasoning_effort = "high"model_provider = "agent-space"# ↑
# ...# There could be more blocks here in this file.# ...
# This is a full block.# ↓[model_providers.agent-space]name = "Agent.Space"base_url = "https://api.agent.space/v1"wire_api = "responses"experimental_bearer_token = "<your-api-key>"# ↑
# ...# There could be more blocks here in this file.# ...

다른 설치 방법

  • npmnpm install -g @openai/codex
  • Homebrewbrew install --cask codex
  • Windowspowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

템플릿에 Endpoint와 선택한 모델이 이미 들어 있습니다. <your-api-key>만 바꾸고 설정 파일은 로컬에만 보관하세요. 저장소에 커밋하거나 공유하지 마세요.

하나의 Space에서 시작

다음 작업을 Agent.Space로

적합한 Agent를 선택하고 프로젝트를 클라우드에서 이어 가며 맥락을 잃지 않고 협업하세요.

시작하기