Configuração do Codex

Uma conexão. Todos os sete modelos.

Configure seu agente uma vez e troque de modelo e esforço de raciocínio na mesma sessão.

Baixar ZIP de configuração com todos os modelos ↗

InterfaceSistema operacional

Prefere pular a configuração manual? Peça à IA para fazer isso por você.

Prompt de configuração com IA

Siga https://siapi.ai/pt-br/docs/codex?model=deepseek-flash&surface=cli&platform=macos para conectar meu Agent a todos os modelos SI-API. Preserve as configurações existentes e peça minha chave de API quando necessário.

GLM 5.3 Flash
DeepSeek V4.1 Flash
Kimi K3.1 Pro
Kimi K3.1 Pro HighSpeed
GLM 5.3
MiniMax M3.1 Flash
Qwen3.8 Max

Os sete modelos estão neste download. Mantenha a mesma configuração ao trocar de modelo. Obter sua chave de API →

1. Prepare sua ferramenta e sua chave

Instale Codex pela página oficial. Crie ou copie sua chave SI-API em /pt-br/keys.

Guia oficial de instalação ↗

Prepare sua ferramenta e sua chave

export SIAPI_API_KEY="YOUR_SIAPI_API_KEY"

2. Salve a configuração

Baixe e extraia o ZIP. Substitua YOUR_SIAPI_API_KEY pela sua chave e salve cada arquivo no caminho indicado abaixo. Mescle os campos com o arquivo existente, preservando outros provedores, permissões e preferências. Não substitua toda a configuração existente.

Local da configuração: ~/.codex

siapi.config.toml

Salvar em: ~/.codex/config.toml

Mescle estes campos no arquivo existente, preservando outros provedores, permissões e preferências. Não substitua a configuração inteira. Substitua o caminho do catálogo pelo caminho absoluto real. Se CODEX_HOME estiver definido, use essa pasta.

Ver ou copiar configuração

siapi.config.toml

Baixar

model_provider = "siapi"
model = "deepseek-flash"
model_catalog_json = "/ABSOLUTE/PATH/TO/.codex/siapi-models.json"
web_search = "disabled"

[model_providers.siapi]
name = "SI-API"
base_url = "https://siapi.ai/v1"
wire_api = "responses"
supports_websockets = false
env_key = "SIAPI_API_KEY"
requires_openai_auth = false

[profiles.siapi]
model_provider = "siapi"
model = "deepseek-flash"

siapi-models.json · modelos e configurações de esforço necessários

Salvar em: ~/.codex/siapi-models.json

Salve este catálogo de modelos ao lado de config.toml. Em config.toml, defina model_catalog_json com o caminho absoluto completo desse arquivo. Os dois arquivos são necessários.

Ver ou copiar configuração

siapi-models.json

Baixar

{
  "models": [
    {
      "slug": "glm-5.3-flash",
      "display_name": "GLM 5.3 Flash",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "max",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Low"
        },
        {
          "effort": "high",
          "description": "High"
        },
        {
          "effort": "max",
          "description": "Max"
        }
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 0,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    },
    {
      "slug": "deepseek-flash",
      "display_name": "DeepSeek V4.1 Flash",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "high",
      "supported_reasoning_levels": [
        {
          "effort": "none",
          "description": "Off"
        },
        {
          "effort": "low",
          "description": "Low"
        },
        {
          "effort": "high",
          "description": "High"
        },
        {
          "effort": "max",
          "description": "Max"
        }
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 1,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    },
    {
      "slug": "kimi-k3.1-pro",
      "display_name": "Kimi K3.1 Pro",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "max",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Low"
        },
        {
          "effort": "high",
          "description": "High"
        },
        {
          "effort": "max",
          "description": "Max"
        }
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 2,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    },
    {
      "slug": "kimi-k3.1-pro-highspeed",
      "display_name": "Kimi K3.1 Pro HighSpeed",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "max",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Low"
        },
        {
          "effort": "high",
          "description": "High"
        },
        {
          "effort": "max",
          "description": "Max"
        }
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 3,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    },
    {
      "slug": "glm-5.3",
      "display_name": "GLM 5.3",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "max",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Low"
        },
        {
          "effort": "high",
          "description": "High"
        },
        {
          "effort": "max",
          "description": "Max"
        }
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 4,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    },
    {
      "slug": "minimax-m3.1",
      "display_name": "MiniMax M3.1 Flash",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "none",
      "supported_reasoning_levels": [],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 5,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    },
    {
      "slug": "qwen3.8-max",
      "display_name": "Qwen3.8 Max",
      "description": "SI-API · text and local function tools",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "none",
          "description": "Off"
        },
        {
          "effort": "low",
          "description": "Low"
        },
        {
          "effort": "medium",
          "description": "Medium"
        },
        {
          "effort": "xhigh",
          "description": "XHigh"
        }
      ],
      "shell_type": "unified_exec",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 6,
      "base_instructions": "You are a coding assistant. Follow the user’s instructions and configured permissions. Inspect relevant files before editing and verify your work.",
      "supports_reasoning_summaries": false,
      "supports_reasoning_summary_parameter": false,
      "support_verbosity": false,
      "default_verbosity": null,
      "apply_patch_tool_type": null,
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      },
      "experimental_supported_tools": [],
      "input_modalities": [
        "text"
      ]
    }
  ]
}

3. Inicie seu agente

Inicie uma nova sessão e envie uma mensagem. O modelo inicial é deepseek-flash.

Inicie seu agente

codex --profile siapi --model deepseek-flash

4. Alterne entre todos os modelos

Após a configuração, escolha qualquer modelo abaixo dentro do agente. A mesma chave e configuração funcionam com os sete modelos; não é necessário baixar ou conectar novamente.

Todos os 7 modelos nesta configuração de agente
Modelo / ID na API	Comando / caminho no seletor	Configurações de raciocínio
GLM 5.3 Flash `glm-5.3-flash`	`/model → SI-API → GLM 5.3 Flash (glm-5.3-flash)`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
DeepSeek V4.1 Flash `deepseek-flash`	`/model → SI-API → DeepSeek V4.1 Flash (deepseek-flash)`	Off, Low, High e Max. Medium / XHigh correspondem a High; Ultra corresponde a Max.
Kimi K3.1 Pro `kimi-k3.1-pro`	`/model → SI-API → Kimi K3.1 Pro (kimi-k3.1-pro)`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
Kimi K3.1 Pro HighSpeed `kimi-k3.1-pro-highspeed`	`/model → SI-API → Kimi K3.1 Pro HighSpeed (kimi-k3.1-pro-highspeed)`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
GLM 5.3 `glm-5.3`	`/model → SI-API → GLM 5.3 (glm-5.3)`	Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
MiniMax M3.1 Flash `minimax-m3.1`	`/model → SI-API → MiniMax M3.1 Flash (minimax-m3.1)`	Use o padrão do modelo. Esta rota não oferece controles personalizados de raciocínio.
Qwen3.8 Max `qwen3.8-max`	`/model → SI-API → Qwen3.8 Max (qwen3.8-max)`	Off, Low, Medium e XHigh. High / Max correspondem a XHigh, sem níveis adicionais.

5. Escolha o esforço de raciocínio

Execute /model, selecione um modelo SI-API e escolha o nível de raciocínio. Repita /model sempre que quiser trocar.

Dentro do agente

/model

Os níveis de esforço disponíveis dependem do modelo; consulte a tabela acima. O MiniMax M3.1 Flash usa o padrão do modelo.

Padrões de esforço e configurações salvas

Comece com o DeepSeek V4.1 Flash. Escolha Low, envie uma tarefa curta de leitura de arquivo, depois escolha High e repita. Confira a configuração atual após cada alteração.

Effort é a quantidade de raciocínio solicitada. Kimi K3.1 Pro / HighSpeed, GLM 5.3 e GLM 5.3 Flash oferecem Low / High / Max, com raciocínio sempre ativado. Escolha Low para raciocínio mais curto; não há opção Off. O padrão desses modelos é Max, mas o cliente pode substituí-lo. DeepSeek e Qwen têm os níveis próprios listados abaixo.

O MiniMax M3.1 Flash usa o raciocínio padrão. As configurações do MiniMax M3 se aplicam a outro modelo.

Use /model, selecione DeepSeek V4.1 Flash e escolha o nível de raciocínio. Abra /status para conferir a sessão. Repita /model para alterar sem editar JSON. O catálogo declara as opções disponíveis, sem fixar a sessão no padrão.

O catálogo define um padrão e uma lista de opções para cada modelo. Remova um model_reasoning_effort = "low" antigo se quiser usar os padrões do catálogo. Uma opção -c na linha de comando ou uma seleção salva na tarefa ainda pode ter prioridade.

Resultado esperado: No DeepSeek V4.1 Flash, a configuração muda de Low para High e volta a Low antes da próxima mensagem. Os demais modelos seguem os controles abaixo.

Catálogo de modelos do Codex e configurações de esforço no Desktop ↗

Confira o modelo e execute sua primeira tarefa

Abra um projeto com README.md. Permita que a ferramenta leia o arquivo e envie o prompt abaixo. Confirme a leitura e o retorno de um resumo. Para testar outro modelo, troque pela tabela acima e repita a tarefa.

Na sua ferramenta

/status
/model

Envie esta tarefa na sua ferramenta

Use a ferramenta de leitura de arquivos para ler o README.md deste projeto e resumir sua finalidade em uma frase. Não modifique nenhum arquivo.

Observações sobre a ferramenta

A CLI usa um perfil siapi dedicado. O aplicativo de desktop lê o config.toml principal, que também define padrões para execuções da CLI sem perfil.
O aplicativo de desktop lê um arquivo privado de chave por auth.command, permitindo autenticação ao abrir pelo Dock ou menu Iniciar. Não combine autenticação por comando com env_key ou requires_openai_auth.
A busca web hospedada está desativada. Esta configuração usa texto e ferramentas de função definidas pelo cliente; não habilita entrada de imagens nem tarefas na nuvem.

Referência oficial de configuração ↗ · Configuração do modelo

A conexão não funciona? · Uso

Compatibilidade dos Agents — Versões dos clientes, campos de raciocínio testados e limitações conhecidas.

Baixar instruções de configuração