// Quick Start

Documentação

Configure seu endpoint e chave de API por meio de variáveis de ambiente — nenhuma alteração de código é necessária para integrar AnBoWork.

PLUG-IN

Quer construir um plugin para o aplicativo de desktop AnBoWork (adicionar ferramentas para IA, encaixar um painel lateral, enviar notificações do sistema)?Documentos para desenvolvedores de plug-ins

01Terminais de API

Anthropic SDK (Claude Code etc.)

https://api.anbowork.com

OpenAISDK/HTTP

https://api.anbowork.com/v1

KEY

Crie uma chave no console em "API Key Management". Parece sk-sua-chave de API. Passe nas solicitações como Autorização: Bearer sk-...

02Variáveis de ambiente

Windows Configuração

Válido apenas para a sessão de terminal atual. Fecha quando a janela fecha. Bom para testes rápidos.

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

macOS / Linux Configuração

Válido apenas para a sessão de terminal atual. Fecha quando a janela fecha. Bom para testes rápidos.

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

03Integração de ferramentas

As principais ferramentas de codificação de IA podem se conectar diretamente a AnBoWork – basta definir as variáveis de ambiente ou configuração abaixo.

Claude Code CLI

CLI oficial de Anthropic — conecte-se a AnBoWork por meio de variáveis de ambiente, sem necessidade de alterações de código.

Vá para API Key Management para baixar um script de configuração com um clique →

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

Em seguida, inicie com:

claude

Codex CLI

OpenAI oficial Codex CLI — usa o endpoint /v1/responses. Nota: base_url deve incluir /v1.

Edite ~/.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"

Em seguida, defina a chave API como uma variável de ambiente:

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

Em seguida, inicie com:

codex

Cursor / Windsurf

Substitua o endpoint OpenAI e a chave API nas configurações.

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

Cline (Código VS)

Selecione o provedor compatível OpenAI em Cline e insira o endpoint, a chave e o nome do modelo.

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

04Exemplos de código

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)

Instalar: pip install anthropic / openai · npm install openai

05Transmissão

Adicione stream: fiel ao corpo da sua solicitação para ativar o streaming SSE – ideal para UIs de bate-papo em tempo real.

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)

06Conversão automática de formato

AnBoWork realiza conversão bidirecional transparente entre Anthropic Mensagens e OpenAI Bate-papo no nível do gateway. Isso significa que você pode chamar o mesmo modelo no estilo Anthropic ou no estilo OpenAI — uma base de código, qualquer modelo.

Mapeamentos de campos principais entre os dois estilos:

Anthropic Estilo	OpenAI Estilo	Descrição
system	messages[role=system]	O prompt do sistema está posicionado de forma diferente; o gateway lida com isso automaticamente
max_tokens（必填）	max_tokens（可选）	Quando omitido, o gateway aplica o limite padrão do modelo
content 分块数组	content 字符串	Blocos de texto/imagem são convertidos de e para strings
stop_reason	finish_reason	Concluir mapeamento do nome do campo de motivo

TIP

Já tem o código OpenAI e deseja ligar para Claude? Basta alterar base_url e model – não há necessidade de alterar a estrutura da mensagem.

07Multimodal

A geração de imagens usa o mesmo gateway e chave de API, cobrada por uso.

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

08Chamada de Função

Defina funções que podem ser chamadas usando ferramentas no estilo OpenAI. O modelo retorna tool_calls quando necessário, e seu código as executa e retorna os resultados.

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)

09Tratamento de erros

Os endpoints /v1/* seguem o formato de erro de OpenAI — as respostas contêm tipo/código/mensagem.

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

Códigos de erro comuns

HTTP	Descrição
401	A chave de API é inválida ou está faltando
402	Saldo insuficiente — por favor, recarregue
429	Taxa limitada ou cota diária esgotada
503	Todos os canais upstream indisponíveis (circuito quebrado)

Veja todos os modelos e preços →