Gateway operacional

Configure sua ferramenta de IA
com a Manus API

Instale Claude Code, Claude Desktop e Codex CLI com sua chave Manus API. Aprenda também a configurar clientes OpenAI-compatible e automações.

API BASE URLhttps://api-codex.manus.api.br/v1
01

Escolha sua ferramenta

Instale somente a ferramenta que pretende usar. Na próxima etapa, selecione Claude Code ou Codex CLI; os comandos e a configuração de cada uma ficam em uma aba independente.

02

Pré-requisitos

  • Uma chave Manus API individual ativa, fornecida no painel autorizado.
  • Internet e um terminal com curl (macOS/Linux) ou PowerShell (Windows).
  • Node.js LTS e npm para a instalação das ferramentas CLI; Git recomendado para projetos de código.
  • Claude Desktop e aplicativos gráficos somente nos sistemas que suportam oficialmente essas ferramentas.
node --version
npm --version
git --version
Segurança antes de instalar

Confira o conteúdo dos scripts e mantenha sua API key fora de repositórios, capturas de tela e históricos públicos. O instalador pode alterar arquivos de configuração em sua pasta de usuário; preserve os backups existentes.

03

Instalar e configurar

Escolha a ferramenta. O painel mostrará apenas os instaladores e as orientações correspondentes, mantendo separados os perfis de Claude e Codex.

INSTALAÇÃO INDIVIDUAL

Claude Code

Instale e configure o Claude Code com a sua chave Manus API. Os comandos abaixo selecionam somente Claude Code, sem instalar Codex.

API BASE URLhttps://api-codex.manus.api.br
macOS / Linux
curl -fsSL https://files.icodex.ia.br/install.sh | \
  ICODEX_TOOLS=claude \
  ICODEX_CLAUDE_CONFIG_URL="https://icodex.ia.br/docs?config=claude" bash
Windows · PowerShell
$env:ICODEX_TOOLS='claude'
$env:ICODEX_CLAUDE_CONFIG_URL='https://icodex.ia.br/docs?config=claude'
irm https://files.icodex.ia.br/install.ps1 | iex

Após executar, siga as perguntas de idioma, instalação e chave no terminal. Se a CLI já estiver instalada, o assistente pode reaproveitá-la.

Configuração manual do Claude Code

Alternativa de instalação da CLI, para quem prefere configurar manualmente:

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

Crie ou edite ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api-codex.manus.api.br",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "API_TIMEOUT_MS": "6000000"
  }
}
macOS / Linux — chave no terminal
export ANTHROPIC_AUTH_TOKEN="SUA_API_KEY"
cd ~/seu-projeto
claude
Windows PowerShell — chave do usuário
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','SUA_API_KEY','User')
# Reabra o PowerShell e execute:
claude

Não grave a chave em projetos Git. No Claude Code, use /status para conferir modelo e origem da conexão. Se já existir autenticação pessoal em outro provedor, evite misturar variáveis conflitantes.

Claude Desktop e aplicativos

Claude Desktop e aplicativos

O instalador guiado pode apresentar Claude Desktop nos sistemas compatíveis. A instalação do aplicativo e a configuração de um gateway personalizado são etapas distintas; confira a compatibilidade da sua versão e reinicie o aplicativo após a configuração. Para configurar apenas o Desktop pelo menu, selecione desktop.

Deseja instalar Claude e Codex juntos?

Use o instalador completo com os dois arquivos de configuração do iCodex. No menu, escolha as ferramentas que deseja instalar.

macOS / Linux · menu completo
curl -fsSL https://files.icodex.ia.br/install.sh | \
  ICODEX_CLAUDE_CONFIG_URL="https://icodex.ia.br/docs?config=claude" \
  ICODEX_CODEX_CONFIG_URL="https://icodex.ia.br/docs?config=codex" bash
Windows · menu completo
$env:ICODEX_CLAUDE_CONFIG_URL='https://icodex.ia.br/docs?config=claude'
$env:ICODEX_CODEX_CONFIG_URL='https://icodex.ia.br/docs?config=codex'
irm https://files.icodex.ia.br/install.ps1 | iex

Opções: ICODEX_LANG define idioma (pt, en, es); ICODEX_TOOLS permite escolher claude, desktop, codex, codexapp ou all. Não compartilhe sua chave em comandos ou repositórios.

Aplicativos OpenAI-compatible

NomeManus API / iCodex
TipoOpenAI-compatible
API Base URLhttps://api-codex.manus.api.br/v1
Chatchat/completions
Responsesresponses
API Keysua chave individual
04

Modelos em destaque

Perfis em destaque para programação, agentes e tarefas gerais. A disponibilidade de cada identificador depende dos modelos habilitados na sua chave e do protocolo utilizado.

Outros modelos liberados

fable-5gpt-5.5gpt-5.5-proGPT-5.6HaikuSonnetOpus 4.7Opus 4.8Opus 5TokenRouter

Para integrações novas, recomendamos começar com gpt-5.6-sol. Use TERRA para equilibrar desempenho e custo, ou LUA para volume e velocidade.

Modelos para criação de imagens

Disponíveis na busca de modelos da própria API (GET /v1/models) e usados em POST /v1/images/generations com a mesma API key.

fluxFLUX.1 SchnellRápido · padrão de 2 passos · até 1024 × 1024
sdxlStable Diffusion XL BaseQualidade · use pelo menos 8 passos · recomendado em 512 × 512
sdxl-lightningStable Diffusion XL LightningRecomendado para velocidade · 4 passos · 512 × 512
img_gpt_proChatGPT Imagem ProTexto para imagem e imagem para imagem · aceita proporção e até 3 referências

img_gpt_pro gera imagens somente a partir do prompt (texto para imagem) ou combina o prompt com referências (imagem para imagem).

Para imagem para imagem, envie referências opcionais em base64:

"reference_images": [
  "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD..."
]
05

Verificar conexão

Depois da configuração, confirme o gateway antes de iniciar tarefas grandes. A autenticação depende da sua chave individual, que não deve ser publicada.

Consultar modelos

curl https://api-codex.manus.api.br/v1/models \
  -H "Authorization: Bearer SUA_API_KEY"

Teste de Chat Completions

curl https://api-codex.manus.api.br/v1/chat/completions \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Olá"}]}'

Claude Code: execute claude e consulte /status. Codex: execute codex --profile icodex em um projeto e envie uma pergunta curta. Para cliente Anthropic, o endereço base é https://api-codex.manus.api.br; no Codex e na OpenAI-compatible, termina em /v1.

06

Solução de problemas

401 — chave inválida ou ausente

Confira se a chave está ativa, completa e associada à conta correta. Não inclua espaços e não publique a chave nos logs.

429 — limite de requisições

Reduza solicitações simultâneas ou aguarde o intervalo indicado pela API. O limite depende do plano e das regras da conta.

Claude Code: conflito de autenticação

Confira ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL e variáveis de provedores anteriores. Não execute logout da conta pessoal sem necessidade.

Codex: provedor ou perfil não encontrado

Confirme o arquivo ~/.codex/config.toml, o nome icodex, wire_api = "responses" e a variável definida em env_key. Reabra o terminal.

Comando não encontrado

Confira a instalação e o PATH do Node.js. Teste npm list -g @openai/codex ou claude --version.

Timeout ou conexão lenta

Verifique rede, DNS, disponibilidade do gateway e janela de timeout. No Claude, o parâmetro API_TIMEOUT_MS pode precisar ser ajustado à tarefa.

Instalador acessa URL incorreta

Use os comandos iCodex acima, que definem ICODEX_CLAUDE_CONFIG_URL e ICODEX_CODEX_CONFIG_URL para arquivos hospedados no próprio domínio iCodex. O endereço do gateway é api-codex.manus.api.br.

07

FAQ rápida

Posso utilizar uma chave em Claude e Codex?

A mesma chave individual pode autenticar os clientes compatíveis habilitados no gateway; cada aplicativo usa seu protocolo e identificador de modelo.

Como seleciono apenas uma ferramenta?

No instalador, escolha no menu ou configure ICODEX_TOOLS=claude, ICODEX_TOOLS=codex ou outra opção compatível com seu sistema.

Como alterar o idioma?

Utilize ICODEX_LANG=pt, en ou es; sem essa variável, siga o menu inicial.

Como trocar o modelo?

No Claude, ajuste as variáveis de modelo do settings.json. No Codex, ajuste model em config.toml. Consulte os modelos liberados abaixo.

Posso testar sem instalar componentes adicionais?

Sim, use a configuração manual ou escolha não instalar programas ausentes quando o assistente perguntar. É necessário ter o aplicativo para executá-lo.

Preciso de uma chave da OpenAI ou Anthropic?

Para acessar a Manus API, utilize sua chave Manus. O cliente precisa apontar para o gateway e protocolo correspondentes.

Minha chave fica visível no painel?

A exibição e a recuperação da chave obedecem às regras da sua conta. Evite armazená-la em arquivos compartilhados.