앱과 코딩 에이전트 연결

연동 경로를 선택하고 CostRouter Base URL과 API Key를 설정한 뒤 사용 로그에서 첫 요청을 확인하세요.

경로 1

AI 애플리케이션 연결

호환 SDK 또는 HTTP 클라이언트는 유지하고 Base URL, API Key, 모델 ID만 바꾸세요.

첫 단계로 권장

첫 동작 요청

curl 예제

curl -X POST "https://costrouter.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_COSTROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: CostRouter connected"
      }
    ],
    "stream": false
  }'

설정할 세 가지 값

Base URL: https://costrouter.ai/v1
인증: Bearer YOUR_COSTROUTER_API_KEY
모델: 모델 목록에서 정확한 ID 복사

경로 2

코딩 에이전트 설정

각 설정에 Base URL과 API Key를 전달하는 환경 변수 위치가 함께 표시됩니다. YOUR_COSTROUTER_API_KEY와 모델 자리표시자를 실제 값으로 바꾼 뒤 표시된 명령으로 도구를 실행하세요.

Codex

CostRouter 호환 설정

설정

Codex 설치

도구를 설치하거나 현재 버전이 정상적으로 시작되는지 확인하세요.

Codex 설치

npm install -g @openai/codex
codex --version

먼저 테스트 권장

명령 하나를 복사해 연결 확인

현재 터미널에 API Key를 export한 뒤 임시 CostRouter 공급자 설정으로 Codex를 시작합니다. config.toml은 변경되지 않으며 이 터미널을 닫으면 값이 사라집니다.

현재 터미널(zsh / bash)

export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" && \
codex \
  -c 'model_provider="costrouter"' \
  -c 'model="gpt-5.6-luna"' \
  -c 'model_providers.costrouter.name="CostRouter"' \
  -c 'model_providers.costrouter.wire_api="responses"' \
  -c 'model_providers.costrouter.env_key="OPENAI_API_KEY"' \
  -c 'model_providers.costrouter.base_url="https://costrouter.ai/v1"'

영구 설정

공급자 주소와 API Key를 config.toml에 함께 저장하면 이후 Codex 실행 시 자동으로 불러옵니다. API Key는 이 기기에 일반 텍스트로 저장되므로 개인 기기에서만 사용하고 파일을 안전하게 보호하세요.

~/.codex/config.toml

model_provider = "costrouter"
model = "gpt-5.6-luna"

[model_providers.costrouter]
name = "CostRouter"
wire_api = "responses"
base_url = "https://costrouter.ai/v1"
experimental_bearer_token = "YOUR_COSTROUTER_API_KEY"

이 도구 전용 API Key를 사용하세요.
모델 목록에서 사용 가능한 모델을 선택하세요.
도구를 다시 시작하고 사용 로그에서 요청을 확인하세요.

Claude Code

CostRouter 호환 설정

설정

Claude Code 설치

도구를 설치하거나 현재 버전이 정상적으로 시작되는지 확인하세요.

Claude Code 설치

npm install -g @anthropic-ai/claude-code
claude --version

먼저 테스트 권장

명령 하나를 복사해 연결 확인

아래 명령 전체를 실행하세요. Base URL과 API Key는 export를 통해 현재 터미널에 설정되며 구성 파일은 변경되지 않습니다. 이 터미널을 닫으면 값이 사라집니다.

현재 터미널(zsh / bash)

export ANTHROPIC_BASE_URL="https://costrouter.ai" \
  ANTHROPIC_AUTH_TOKEN="YOUR_COSTROUTER_API_KEY" && \
claude

영구 설정

도구 설정 파일에 저장해 이후 실행에서도 계속 사용합니다.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://costrouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_COSTROUTER_API_KEY"
  }
}

이 도구 전용 API Key를 사용하세요.
모델 목록에서 사용 가능한 모델을 선택하세요.
도구를 다시 시작하고 사용 로그에서 요청을 확인하세요.

Gemini CLI

CostRouter 호환 설정

설정

Gemini CLI 설치

도구를 설치하거나 현재 버전이 정상적으로 시작되는지 확인하세요.

Gemini CLI 설치

npm install -g @google/gemini-cli
gemini --version

먼저 테스트 권장

명령 하나를 복사해 연결 확인

현재 터미널(zsh / bash)

export GOOGLE_GEMINI_BASE_URL="https://costrouter.ai" \
  GEMINI_API_KEY="YOUR_COSTROUTER_API_KEY" \
  GEMINI_MODEL="gemini-available-model-id" && \
gemini

영구 설정

도구 설정 파일에 저장해 이후 실행에서도 계속 사용합니다.

~/.gemini/settings.json

{
  "env": {
    "GOOGLE_GEMINI_BASE_URL": "https://costrouter.ai",
    "GEMINI_API_KEY": "YOUR_COSTROUTER_API_KEY",
    "GEMINI_MODEL": "gemini-available-model-id"
  }
}

이 도구 전용 API Key를 사용하세요.
모델 목록에서 사용 가능한 모델을 선택하세요.
도구를 다시 시작하고 사용 로그에서 요청을 확인하세요.

Cursor

CostRouter 호환 설정

설정

Cursor 설치

도구를 설치하거나 현재 버전이 정상적으로 시작되는지 확인하세요.

Cursor 설치

cursor .

먼저 테스트 권장

명령 하나를 복사해 연결 확인

환경 변수는 이번에 시작한 Cursor와 해당 프로젝트 프로세스에만 전달됩니다. 내장 Agent에 적용되는지는 현재 Cursor 버전에 따라 다릅니다.

현재 터미널(zsh / bash)

export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" \
  OPENAI_BASE_URL="https://costrouter.ai/v1" && \
cursor .

영구 설정

Cursor 안에서 실행하는 프로젝트 코드와 스크립트가 읽도록 프로젝트 .env에 저장합니다. 내장 Agent의 사용자 지정 Base URL 지원 여부는 설치된 버전에 따라 다릅니다.

.env

OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY"
OPENAI_BASE_URL="https://costrouter.ai/v1"

이 도구 전용 API Key를 사용하세요.
모델 목록에서 사용 가능한 모델을 선택하세요.
도구를 다시 시작하고 사용 로그에서 요청을 확인하세요.

로컬 에이전트 프로필 관리

cc-switch로 로컬 제공자 프로필을 저장하고 전환할 수 있습니다. CostRouter Base URL과 API Key는 한 번만 추가하세요.

cc-switch 받기

프로덕션

출시 전 확인

트래픽이 늘어도 접근을 통제하고 비용을 확인할 수 있게 유지하세요.

앱, 환경, 에이전트마다 별도 Key를 사용하세요.
한도, 만료, 모델 제한과 IP 허용 목록을 설정하세요.
설정 및 모델 변경 후 사용 로그를 확인하세요.
환경 변수 또는 비밀 관리 서비스에서 인증 정보를 불러오세요.

AI 애플리케이션 연결

첫 동작 요청

설정할 세 가지 값

코딩 에이전트 설정

Codex

Codex 설치

명령 하나를 복사해 연결 확인

영구 설정

Claude Code

Claude Code 설치

명령 하나를 복사해 연결 확인

영구 설정

Gemini CLI

Gemini CLI 설치

명령 하나를 복사해 연결 확인

영구 설정

Cursor

Cursor 설치

명령 하나를 복사해 연결 확인

영구 설정

로컬 에이전트 프로필 관리

출시 전 확인

문의하기