Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Use este guia para executar o Codex CLI com o CometAPI como provedor de model. Referências oficiais:
O Codex deve ter ambos os arquivos configurados: ~/.codex/config.toml e ~/.codex/auth.json. Não use uma configuração apenas com base-URL para esta integração.

​
Pré-requisitos

RequisitoDetalhes
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) ou Windows 11 via WSL2
Node.js22+ (LTS recomendado)
Git2.23+ recomendado
Chave CometAPIObtenha uma no Painel do CometAPI (começa com sk-)

​
Instalar o Codex CLI

npm i -g @openai/codex
Ou via Homebrew: 
brew install --cask codex
Verifique a instalação: 
codex --version

​
Configurar o CometAPI

Crie ou edite ~/.codex/config.toml com esta configuração de provedor: 
model_provider = "cometapi"
model = "gpt-5.5"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
requires_openai_auth = true
As chaves model_provider e model devem permanecer no nível superior do arquivo. A seção [model_providers.cometapi] define o endpoint do CometAPI.
Se você gerencia as configurações do Codex por meio de um repositório de dotfiles, mantenha a cópia dos dotfiles sincronizada com ~/.codex/config.toml. O Codex lê o arquivo de ~/.codex/config.toml.

​
Armazenar sua chave de API

Crie ~/.codex/auth.json: 
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Substitua sk-your-cometapi-key pela sua chave real do CometAPI.
Este arquivo é obrigatório. auth_mode deve ser apikey, e OPENAI_API_KEY deve conter sua chave do CometAPI.

​
Iniciar o Codex

cd your-project
codex
Na primeira execução, o Codex solicitará que você escolha um tema e confirme as configurações de segurança.

​
Solução de problemas

SintomaCorreção
API key auth is missing a keyCorrija ~/.codex/auth.json. Ele deve conter "auth_mode": "apikey" e "OPENAI_API_KEY": "sk-..."
O prompt de login aparece inesperadamenteRecrie ~/.codex/auth.json com auth_mode definido como apikey e reinicie o Codex
O Codex ainda usa o provedor OpenAI padrãoCorrija ~/.codex/config.toml. model_provider deve ser cometapi
As requisições não chegam ao CometAPICorrija ~/.codex/config.toml. [model_providers.cometapi] deve incluir requires_openai_auth = true
Tempo limite de conexão ou endpoint incorretoCorrija ~/.codex/config.toml. base_url deve ser https://api.cometapi.com/v1
Model não encontradoVerifique a página de Models para ver os models disponíveis
Problemas no WindowsO Codex exige WSL2 no Windows — CMD/PowerShell nativo não é suportado