// Quick Start

선적 서류 비치

환경 변수를 통해 API 엔드포인트와 키를 구성하세요. AnBoWork를 통합하는 데 코드를 변경할 필요가 없습니다.

플러그인
AnBoWork 데스크톱 앱용 플러그인을 구축하고 싶으십니까(AI용 도구 추가, 측면 패널 도킹, 시스템 알림 보내기)?플러그인 개발자 문서

01API 엔드포인트

Anthropic SDK (Claude Code 등)
https://api.anbowork.com
OpenAI SDK / HTTP
https://api.anbowork.com/v1
KEY
콘솔의 "API Key Management" 아래에서 키를 생성하세요. sk-your-api-key처럼 보입니다. 요청에 Authorization: Bearer sk-...로 전달합니다.

02환경 변수

Windows 설정

현재 터미널 세션에만 유효합니다. 창이 닫힐 때 닫힙니다. 빠른 테스트에 좋습니다.

# PowerShell (valid for current session only)
$env:ANTHROPIC_BASE_URL = "https://api.anbowork.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-api-key"

macOS / Linux 설정

현재 터미널 세션에만 유효합니다. 창이 닫힐 때 닫힙니다. 빠른 테스트에 좋습니다.

# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.anbowork.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

03도구 통합

주류 AI 코딩 도구는 AnBoWork에 직접 연결할 수 있습니다. 아래에서 환경 변수나 구성을 설정하기만 하면 됩니다.

Claude Code CLI

Anthropic의 공식 CLI — 환경 변수를 통해 AnBoWork에 연결합니다. 코드를 변경할 필요가 없습니다.

API 키 관리로 이동하여 원클릭 설정 스크립트를 다운로드하세요 → 
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.anbowork.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

그런 다음 다음을 사용하여 시작하십시오.

claude

Codex CLI

OpenAI 공식 Codex CLI — /v1/responses 엔드포인트를 사용합니다. 참고: base_url에는 /v1이 포함되어야 합니다.

~/.codex/config.toml을 편집하세요:

model_provider = "piomodel"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.piomodel]
name = "piomodel"
base_url = "https://api.anbowork.com/v1"
wire_api = "responses"
env_key = "PIOMODEL_API_KEY"

그런 다음 API 키를 환경 변수로 설정합니다.

# bash / zsh
export PIOMODEL_API_KEY="sk-your-api-key"

그런 다음 다음을 사용하여 시작하십시오.

codex

Cursor / 윈드서핑

설정에서 OpenAI 엔드포인트 및 API 키를 재정의하세요.

{
  "openai.baseUrl": "https://api.anbowork.com/v1",
  "openai.apiKey": "sk-your-api-key"
}

Cline (VS 코드)

Cline에서 OpenAI 호환 제공자를 선택하고 엔드포인트, 키, 모델명을 입력합니다.

Provider   : OpenAI Compatible
Base URL   : https://api.anbowork.com/v1
API Key    : sk-your-api-key
Model      : claude-sonnet-4-5-20250929

04코드 예

from anthropic import Anthropic

# Automatically reads ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN from env
client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)

설치하다: pip install anthropic / openai · npm install openai

05스트리밍

스트림 추가: SSE 스트리밍을 활성화하려면 요청 본문에 true로 설정하세요. 실시간 채팅 UI에 이상적입니다.

from anthropic import Anthropic

client = Anthropic()

with client.messages.stream(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about Go."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

06자동 형식 변환

AnBoWork는 게이트웨이 수준에서 Anthropic 메시지와 OpenAI 채팅 간의 투명한 양방향 변환을 수행합니다. 즉, 동일한 모델을 Anthropic 스타일 또는 OpenAI 스타일로 호출할 수 있습니다. 즉, 하나의 코드베이스, 모든 모델을 호출할 수 있습니다.

두 스타일 간의 키 필드 매핑:

Anthropic 스타일OpenAI 스타일설명
systemmessages[role=system]시스템 프롬프트의 위치가 다릅니다. 게이트웨이가 자동으로 처리합니다.
max_tokens（必填）max_tokens（可选）생략하면 게이트웨이가 모델의 기본 한도를 적용합니다.
content 分块数组content 字符串텍스트/이미지 블록은 문자열로 변환되거나 문자열로 변환됩니다.
stop_reasonfinish_reason종료 이유 필드 이름 매핑
TIP
이미 OpenAI 코드가 있는데 Claude에게 전화하고 싶으신가요? base_url과 모델만 변경하면 됩니다. 메시지 구조를 건드릴 필요가 없습니다.

07다중 모드

이미지 생성에서는 사용량에 따라 요금이 청구되는 동일한 게이트웨이 및 API 키를 사용합니다.

img = client.images.generate(
    model="gpt-image-2",
    prompt="夜幕下的城市天际线，电影感",
    size="1024x1024",
)
print(img.data[0].url)

08함수 호출

OpenAI 스타일 도구를 사용하여 호출 가능한 함수를 정의하세요. 모델은 필요할 때 tool_calls를 반환하고, 코드는 이를 실행하고 결과를 반환합니다.

tools = [{
  "type": "function",
  "function": {
    "name": "get_weather",
    "description": "查询某城市天气",
    "parameters": {
      "type": "object",
      "properties": {"city": {"type": "string"}},
      "required": ["city"],
    },
  },
}]

resp = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",
    messages=[{"role": "user", "content": "上海今天天气怎么样？"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

09오류 처리

/v1/* 엔드포인트는 OpenAI의 오류 형식을 따릅니다. 응답에는 유형/코드/메시지가 포함됩니다.

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_quota",
    "message": "余额不足"
  }
}

일반적인 오류 코드

HTTP설명
401API 키가 유효하지 않거나 누락되었습니다.
402잔액이 부족합니다. 충전해 주세요.
429비율이 제한되었거나 일일 할당량이 소진되었습니다.
503모든 업스트림 채널을 사용할 수 없음(회로 고장)
모든 모델 및 가격 보기 →