# Configuração do Claude Code e do Codex

Configure o Claude Code e o Codex para encaminhar chamadas de modelos pela Felo API Platform.

Este guia mostra como configurar clientes de agente para usar a LLM API do Felo API Platform. Use esta página quando quiser que o Claude Code ou o Codex encaminhem chamadas de modelo pelo Felo API Platform em vez de chamar um fornecedor de modelo diretamente.

::: warning Créditos da API Felo são necessários
As chamadas de modelo da Felo são cobradas dos **créditos de serviço pré-pagos do Felo API Platform**. Uma **assinatura Felo Pro não inclui uso de API/modelo** e não pode ser usada para pagar por essas chamadas. Adicione créditos em [Console Billing](https://openapi.felo.ai/console/billing) antes da sua primeira requisição.
:::

Defina `FELO_API_KEY` com sua chave do Felo API Platform antes de usar qualquer um dos clientes.

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

## Caminhos de cliente compatíveis

| Cliente ou superfície de API | Endpoint Felo recomendado | Exemplo de modelo | Observações |
|-----------------------|---------------------------|---------------|-------|
| Claude Code | `POST /api/v1/messages` | `claude-sonnet-5` | O Claude Code usa o formato de rede Anthropic Messages. |
| Codex | `POST /api/v1/responses` | `gpt-5.6-sol` | Provedores personalizados do Codex devem usar a Responses API. |
| Chat Completions | `POST /api/v1/chat/completions` | `gpt-5.6-sol` | Use em SDKs ou integrações do lado do servidor. O suporte a Chat Completions no Codex está marcado como obsoleto na documentação do Codex. |

## Claude Code

O Claude Code deve usar o endpoint Messages compatível com Anthropic.

O Claude Code pode usar qualquer modelo publicado listado em [Modelos e preços](https://openapi.felo.ai/pt-BR/docs/guides/models-and-pricing.md), incluindo o recém-disponível `claude-sonnet-5`:

```bash
claude --model claude-sonnet-5
```

### Configuração do shell

```bash
export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-5"

claude
```

A URL base da Anthropic omite `/v1` de propósito, porque o Claude Code e o SDK da Anthropic acrescentam `/v1/messages` ao host de API configurado.

### Configuração por arquivo de configurações

Use um arquivo de configurações do Claude Code quando quiser que o endpoint e o modelo valham sempre que `claude` iniciar. Mantenha as chaves de API no seu shell ou gerenciador de segredos em vez de fazer commit delas nas configurações do projeto.

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}
```

Você também pode escolher o modelo para uma única sessão:

```bash
claude --model claude-sonnet-5
```

## Codex

O Codex deve usar o endpoint Responses compatível com OpenAI. `gpt-5.6-sol` é o nível principal do GPT-5.6 para raciocínio complexo, codificação e fluxos com agentes.

### Configuração do usuário

Adicione um provedor Felo à sua configuração do Codex no nível do usuário, em `~/.codex/config.toml`.

```toml
model_provider = "felo"
model = "gpt-5.6-sol"

[model_providers.felo]
name = "Felo API Platform LLM API"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"
```

A autenticação e a seleção de endpoint do Codex devem ficar na configuração do Codex no nível do usuário. O Codex ignora `model_provider`, `model_providers` e `openai_base_url` de arquivos `.codex/config.toml` no escopo do projeto.

### Seleção de modelo pontual

Depois que o provedor Felo estiver configurado, você pode escolher o modelo para uma única execução na CLI:

```bash
codex --model gpt-5.6-sol
```

Para execuções não interativas:

```bash
codex exec --model gpt-5.6-sol "Review this change"
```

## Cobrança e créditos

As chamadas de modelo são pré-pagas separadamente do Felo Pro:

- Cada requisição a um modelo Felo é debitada do seu saldo de créditos de serviço do Felo API Platform.
- Uma assinatura Felo Pro não concede créditos de API e não torna as chamadas de modelo gratuitas.
- Adicione créditos e consulte o uso em [Console Billing](https://openapi.felo.ai/console/billing).
- Se o saldo estiver zerado, a API retorna `402 INSUFFICIENT_CREDITS`.

Consulte [Cobrança e créditos](https://openapi.felo.ai/pt-BR/docs/faq/billing-and-credits.md) para ver a política completa.

## Documentação oficial

- [Variáveis de ambiente do Claude Code](https://code.claude.com/docs/en/env-vars)
- [Configuração de modelos do Claude Code](https://code.claude.com/docs/en/model-config)
- [Configurações do Claude Code](https://code.claude.com/docs/en/settings)
- [Noções básicas de configuração do Codex](https://developers.openai.com/codex/config-basic)
- [Configuração avançada do Codex](https://developers.openai.com/codex/config-advanced#custom-model-providers)
- [Modelos do Codex](https://developers.openai.com/codex/models)
