어떤 Agent 제품에서도 Agent.Space 한도 사용

02 / Developer API

어떤 Agent 제품에서도 Agent.Space 한도 사용

Agent.Space 한도에는 OpenAI 모델용 Share와 기타 사용 가능한 모델용 Flex가 포함됩니다. Agent.Space뿐 아니라 Codex, Claude Code, OpenCode, Hermes 등 익숙한 Agent 제품에서도 사용할 수 있습니다.

내 API Key 보기

Agent.Space 한도 구성

Share + Flex

OpenAI 모델

Share 플랜에 포함된 모델 한도입니다.

Flex

기타 사용 가능한 모델

필요할 때 충전해 유연하게 쓰는 모델 잔액입니다.

익숙한 Agent 제품에서 사용

기본 제공Agent.Space

Codex

Claude Code

OpenCode

Hermes

자체 Agent 제품

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

GPT Image 2는 Share를 먼저 사용하며, 플랜이 없거나 한도를 소진하면 Flex를 사용합니다. 다른 모델은 표시된 결제 방식을 따릅니다.

요금제 보기 Developer API 설정

03 / Agent 클라이언트

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

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

Codex
OpenAI · 터미널과 IDE용 Coding Agent
OpenAI 공식 Coding Agent로 CLI, IDE 확장, 데스크톱 앱을 제공합니다. OpenAI Responses 프로토콜로 Agent.Space에 연결해 Share 한도의 OpenAI 모델을 바로 사용합니다.
- macOS
- Linux
- Windows
설치 · macOS / Linux
```
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
공식 사이트에서 다운로드
Claude Code
Anthropic · 터미널 Coding Agent
Anthropic 공식 Coding Agent로 네이티브 Anthropic Messages 프로토콜을 사용합니다. Base URL을 Agent.Space로 지정하면 Flex 잔액으로 Claude 모델을 호출할 수 있습니다.
- macOS
- Linux
- Windows
설치 · macOS / Linux
```
curl -fsSL https://claude.ai/install.sh | bash
```
공식 사이트에서 다운로드
OpenCode
오픈소스 · 터미널 Coding Agent
사용자 정의 Provider를 지원하는 오픈소스 터미널 Agent로 OpenAI와 Anthropic 프로토콜을 모두 지원합니다. 설정 하나로 Agent.Space의 모든 모델을 사용할 수 있습니다.
- macOS
- Linux
- Windows
설치 · macOS / Linux
```
curl -fsSL https://opencode.ai/install | bash
```
공식 사이트에서 다운로드

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

Key 하나
API Key 하나로 여러 모델 제공사
OpenAI, Anthropic, DeepSeek 등 모델이 같은 Key와 Endpoint를 공유합니다. 모델을 바꿔도 계정은 그대로입니다.
두 가지 프로토콜
OpenAI Responses와 Anthropic Messages
각 클라이언트의 네이티브 프로토콜로 연결합니다. 프록시나 클라이언트 수정 없이 한 번 설정하면 계속 쓸 수 있습니다.
투명한 과금
Share와 Flex는 분리 유지
호출한 모델이 어떤 한도를 쓰는지 결정하고, 모든 요청을 Request history에서 확인할 수 있습니다.
자유로운 전환
언제든 클라이언트 교체
오늘은 Codex, 내일은 Claude Code. Key와 한도는 그대로라 워크플로가 끊기지 않습니다.

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

API Key 받기
Agent.Space Developer API 패널에서 “Codex · MacBook” 같은 Key를 만듭니다. 복사한 설정의 <your-api-key>를 전체 값으로 바꾸세요.
모델 고르기
연결 가이드에서 클라이언트와 사용 가능한 모델을 고르세요. 템플릿에 정확한 모델 ID가 자동으로 입력됩니다.
클라이언트 설정 작성
전체 설정을 복사하고 Key 자리 표시자를 바꾼 뒤 표시된 경로에 저장하세요. 설정 파일은 로컬에만 보관하세요.

내 API Key 받기

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

model_provider = "agent-space"
model = "<model-id>"

[model_providers.agent-space]
name = "Agent.Space"
base_url = "https://api.agent.space/v1"
experimental_bearer_token = "<your-api-key>"
wire_api = "responses"

Codex는 OpenAI Responses 프로토콜을 사용하므로 Base URL이 /v1로 끝납니다. config.toml의 <your-api-key>를 전체 Key로 바꾸고 파일은 로컬에만 보관하세요.

다른 설치 방법

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를 선택하고 프로젝트를 클라우드에서 이어 가며 맥락을 잃지 않고 협업하세요.

시작하기

어떤 Agent 제품에서도 Agent.Space 한도 사용