Integrando o Codex com Modelos Personalizados CodingPlanX

Configure o OpenAI Codex CLI usando a sua Chave de API do CodingPlanX.ai.

Guia de Integração do Codex

O CodingPlanX.ai suporta não apenas o Claude Code, mas também o OpenAI Codex CLI. Depois de adquirir um plano, o Claude Code e o Codex compartilham a mesma cota do plano, oferecendo a flexibilidade de escolher a ferramenta de sua preferência.

Instalar Codex CLI

npm install -g @openai/codex

Verifique a instalação:

codex --version

Versão Mais Recente: v0.114.0 (11/03/2026), apresentando o sistema de Skills (Habilidades), mecanismo de Hooks e muito mais.

Modelos Disponíveis

Você pode acessar os seguintes modelos Codex/GPT através do CodingPlanX.ai:

Todos os modelos compartilham a cota do seu plano CodingPlanX.ai com o Claude Code.

Visão Geral da Configuração

O Codex CLI requer dois arquivos de configuração:

• ~/.codex/config.toml - Configuração do serviço
• ~/.codex/auth.json - Configuração de autenticação

---

Configuração Windows

Passo 1: Criar Diretório de Configuração

mkdir %HOMEPATH%\.codex

Passo 2: Criar config.toml

Crie o arquivo de configuração em ~/.codex/config.toml:

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

Passo 3: Criar auth.json

Crie o arquivo de autenticação em ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

Substitua cr_xxxxxxxxxx pela sua Chave de API do CodingPlanX.ai.

Passo 4: Definir Variáveis de Ambiente (Opcional)

Se preferir fornecer a sua chave por meio de variáveis de ambiente:

# Configuração temporária
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# Configuração permanente
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

Em seguida, defina OPENAI_API_KEY como null no seu auth.json.

---

Configuração macOS

Passo 1: Criar Diretório de Configuração

mkdir -p ~/.codex

Passo 2: Criar config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Passo 3: Criar auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Substitua cr_xxxxxxxxxx pela sua Chave de API do CodingPlanX.ai.

Passo 4: Definir Variáveis de Ambiente (Opcional)

Se preferir fornecer a sua chave por meio de variáveis de ambiente:

# Configuração temporária
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Configuração permanente
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Em seguida, defina OPENAI_API_KEY como null no seu auth.json.

---

Configuração Linux

Passo 1: Criar Diretório de Configuração

mkdir -p ~/.codex

Passo 2: Criar config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Passo 3: Criar auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Substitua cr_xxxxxxxxxx pela sua Chave de API do CodingPlanX.ai.

Passo 4: Definir Variáveis de Ambiente (Opcional)

Se preferir fornecer a sua chave por meio de variáveis de ambiente:

# Configuração temporária
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Configuração permanente (Bash)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# Configuração permanente (Zsh)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Em seguida, defina OPENAI_API_KEY como null no seu auth.json.

---

Verificar Configuração

Após configurar, execute o Codex CLI para verificar:

codex

Indicadores de Sucesso

• O Codex inicia normalmente e se conecta ao serviço.
• Você pode gerar código e receber respostas da IA.
• As requisições de rede são roteadas adequadamente por meio do proxy CodingPlanX.ai.

FAQ / Solução de Problemas

Arquivo de Configuração Não Encontrado

Problema: O Codex avisa que o arquivo de configuração não pode ser encontrado.

Solução:

1. Verifique se o caminho de configuração está correto.
2. Certifique-se de que o diretório ~/.codex/ existe.
3. Verifique se ambos config.toml e auth.json estão presentes.

Falha na Autenticação da Chave de API

Problema: Variável de ambiente inválida ou chave de API incorreta.

Solução:

1. Verifique se a variável de ambiente CRS_OAI_KEY está definida corretamente.
2. Verifique o formato da sua chave de API (começa com cr_).
3. Certifique-se de que a chave não esteja expirada verificando o Console.

Problemas de Conexão de Rede

Problema: Incapaz de conectar aos serviços CodingPlanX.ai.

Solução:

1. Verifique sua conexão com a internet.
2. Verifique se o base_url está definido corretamente como https://api.codingplanx.ai.