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.
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 --versionConfira 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.
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.
Claude Code
Instale e configure o Claude Code com a sua chave Manus API. Os comandos abaixo selecionam somente Claude Code, sem instalar Codex.
https://api-codex.manus.api.brcurl -fsSL https://files.icodex.ia.br/install.sh | \
ICODEX_TOOLS=claude \
ICODEX_CLAUDE_CONFIG_URL="https://icodex.ia.br/docs?config=claude" bash$env:ICODEX_TOOLS='claude'
$env:ICODEX_CLAUDE_CONFIG_URL='https://icodex.ia.br/docs?config=claude'
irm https://files.icodex.ia.br/install.ps1 | iexApó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 --versionCrie 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"
}
}export ANTHROPIC_AUTH_TOKEN="SUA_API_KEY"
cd ~/seu-projeto
claude[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','SUA_API_KEY','User')
# Reabra o PowerShell e execute:
claudeNã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.
Codex CLI
Instale e configure o Codex CLI com a sua chave Manus API. Os comandos abaixo selecionam somente Codex, sem instalar Claude Code.
https://api-codex.manus.api.br/v1curl -fsSL https://files.icodex.ia.br/install-codex.sh | \
ICODEX_CODEX_CONFIG_URL="https://icodex.ia.br/docs?config=codex" bash$env:ICODEX_TOOLS='codex'
$env:ICODEX_CODEX_CONFIG_URL='https://icodex.ia.br/docs?config=codex'
irm https://files.icodex.ia.br/install.ps1 | iexO Codex utiliza a API Responses e a variável ICODEX_API_KEY. Confira a versão instalada ao concluir.
Configuração manual do Codex CLI
Alternativa de instalação da CLI, sem configuração automática:
npm install -g @openai/codex
codex --versionEdite ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml):
model = "gpt-5.6-sol"
model_provider = "icodex"
[model_providers.icodex]
name = "iCodex / Manus API"
base_url = "https://api-codex.manus.api.br/v1"
env_key = "ICODEX_API_KEY"
wire_api = "responses"
[profiles.icodex]
model = "gpt-5.6-sol"
model_provider = "icodex"export ICODEX_API_KEY="SUA_API_KEY"
cd ~/seu-projeto
codex --profile icodex[Environment]::SetEnvironmentVariable('ICODEX_API_KEY','SUA_API_KEY','User')
# Reabra o terminal:
codex --profile icodexO instalador utiliza ICODEX_API_KEY. Quem já utiliza um perfil com MANUS_API_KEY pode mantê-lo, desde que env_key no TOML corresponda à variável realmente configurada. Para Codex em aplicativos gráficos, consulte primeiro se sua versão admite provedor personalizado.
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.
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$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 | iexOpçõ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
Manus API / iCodexOpenAI-compatiblehttps://api-codex.manus.api.br/v1chat/completionsresponsessua chave individualModelos 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.
SOL
gpt-5.6-solPara programação complexa, arquitetura, revisão e tarefas que exigem a melhor qualidade.
TERRA
gpt-5.6-terraEquilíbrio entre capacidade, velocidade e custo para o trabalho cotidiano.
LUA
gpt-5.6-lunaIndicado para alto volume, respostas rápidas, automações e tarefas objetivas.
ChatGPT 6
gpt-6-lunaModelo GPT-6 para desenvolvimento, análise e conversas. Consulte a disponibilidade do modelo na sua chave.
Outros modelos liberados
fable-5gpt-5.5gpt-5.5-proGPT-5.6HaikuSonnetOpus 4.7Opus 4.8Opus 5TokenRouterPara 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 × 1024sdxlStable Diffusion XL BaseQualidade · use pelo menos 8 passos · recomendado em 512 × 512sdxl-lightningStable Diffusion XL LightningRecomendado para velocidade · 4 passos · 512 × 512img_gpt_proChatGPT Imagem ProTexto para imagem e imagem para imagem · aceita proporção e até 3 referênciasimg_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..."
]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.
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.
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.