Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Guia de implantação do Codex

Explica a instalação da ferramenta CLI, a integração da API e a configuração do ambiente de desenvolvimento.

📋 Pré-requisitos (primeiro passo) Primeiro, conclua a instalação do ambiente Node.js e confirme que o Node.js 18+ está instalado corretamente. Durante a configuração, lembre-se de abrir as opções avançadas do ccs; depois de adicionar o modelo, você poderá conversar

🎯 Navegação rápida

O CodeX é um assistente de programação inteligente de última geração baseado na arquitetura GPT-5, que oferece aos desenvolvedores recursos avançados de geração e otimização de código.

Fluxo de implantação: configuração do ambiente do sistema ➜ instalação da ferramenta CLI ➜ integração da API ➜ ambiente de desenvolvimento pronto

🚀 Configuração rápida com o CC-Switch (recomendado)

⚠️ Pré-requisito

Antes de configurar o CodeX com o CC-Switch, confirme que a ferramenta CodeX foi instalada globalmente via npm:

npm install -g @openai/codex@latest
Baixar arquivo compactado Baixar arquivo compactado

Verifique a instalação: codex --version

Recomendamos usar a ferramenta de configuração rápida CC-Switch para fazer a configuração por uma interface gráfica, de forma simples e rápida, sem precisar usar a linha de comando.

Etapas de configuração

  1. Inicie o CC-Switch e mude para a aba Codex

A imagem mostra a interface do aplicativo CC-Switch, com várias abas na parte superior. Uma seta vermelha destaca a aba “Codex”. A imagem corresponde às etapas da seção “Configuração rápida com o CC-Switch (recomendado)” e indica que, depois de iniciar o CC-Switch, você deve clicar na aba “Codex” na parte superior para acessar as próximas opções de configuração.A imagem mostra a interface do aplicativo CC-Switch, com várias abas na…

  1. Abra o aplicativo CC-Switch
  2. Clique na aba “Codex” na parte superior
  3. Clique no botão laranja “+” no canto superior direito para adicionar uma nova configuração
  4. Preencha a configuração do provider do CodeX
  5. Nome do provider: um nome personalizado (como “gpt-agent”)
  6. Base URL: insira https://api.llm-token.cn/v1
  7. API Key: cole sua APIkey
  8. Model: selecione gpt-5.4 (o modelo mais recente no momento da redação deste documento era o 5.4)
  9. Outras configurações: ajuste parâmetros como intensidade de raciocínio e acesso à rede conforme necessário
  10. Clique no botão “Salvar”

A imagem mostra a tela para adicionar uma nova configuração no aplicativo CC-Switch. Na parte superior há as abas “Provider do Codex” e “Provider unificado”; a aba “Provider do Codex” está selecionada. Abaixo aparecem “Configuração personalizada” e vários providers predefinidos, como OpenAI Official e Shengsuanyun. Na parte inferior da tela há campos para “Nome do provider” e “Observações”, além dos botões “Cancelar” e “Adicionar”. A imagem mostra a tela exibida depois da etapa “Clique no botão laranja ‘+’ no canto superior direito para adicionar uma nova configuração” e ajuda você a concluir a configuração personalizada.A imagem mostra a tela para adicionar uma nova configuração no aplicativ…

Esta é a tela de edição da configuração de um provider no CC-Switch. Na parte superior aparece o ícone da ferramenta correspondente e há vários campos: o nome do provider está preenchido como “Guizhou Cloud Computing”, o campo do site oficial mostra parcialmente “https:///”, uma chave mascarada foi colada no campo API Key e o endereço de solicitação da API está definido como “https://api.llm-token.cn/v1”. Na parte inferior, uma observação amarela informa que deve ser inserido um endpoint de serviço compatível com o formato OpenAI Response; no canto inferior direito há um botão azul “Salvar”. A tela corresponde às instruções de preenchimento do provider no guia de implantação do Codex.Esta é a tela de edição da configuração de um provider no CC-Switch. Na…

💡 Dica

  • O CC-Switch cria automaticamente os arquivos ~/.codex/config.toml e auth.json
  • Você pode adicionar vários providers e alternar entre eles a qualquer momento
  • Depois de trocar a configuração, feche e reinicie o CodeX para aplicar a mudança
  1. Ative e use a configuração
  2. Localize na lista a configuração que você acabou de criar
  3. Clique no botão “Em uso” à direita da configuração
  4. A configuração será marcada como “Em uso” (etiqueta verde)
  5. Reinicie o CodeX para aplicar a nova configuração
  6. Alternância rápida pela bandeja do sistema

O CC-Switch permite alternar rapidamente entre configurações do CodeX pela bandeja do sistema:

  • Clique com o botão direito no ícone do CC-Switch na bandeja do sistema
  • Selecione a categoria Codex no menu
  • Selecione diretamente a configuração desejada
  • A configuração entra em vigor imediatamente, sem abrir a interface principal

⚠️ Observações

  • Depois de trocar a configuração, você precisa reiniciar o CodeX para aplicar a mudança
  • Você pode testar a velocidade do endpoint da API no CC-Switch

⌨️ Configuração manual pela linha de comando

Se você não usa o CC-Switch, siga as etapas abaixo para configurar o CodeX manualmente.

🖥️ Windows

Primeiro passo: implantar a ferramenta de linha de comando do CodeX

Abra o Prompt de Comando ou o PowerShell como administrador e execute:

npm install -g @openai/codex@latestcodex --version

Crie o arquivo de configuração: config.toml

model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = true

Crie o arquivo de autenticação: auth.json

{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}

Terceiro passo: inicializar o espaço de trabalho

mkdir my-codex-projectcd my-codex-projectcodex

🍏 macOS

Implantar a ferramenta CodeX

npm install -g @openai/codex@latestcodex --version

Integrar o serviço de API

Crie o diretório de configuração:

mkdir -p ~/.codexcd ~/.codex

Crie a configuração config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

Crie a configuração de autenticação auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

Inicializar o espaço de trabalho

mkdir my-codex-projectcd my-codex-projectcodex

🐧 Linux

Implantar a ferramenta CodeX

sudo npm install -g @openai/codex@latestcodex --version

1 2

Integrar o serviço de API

Crie o diretório de configuração:

mkdir -p ~/.codexcd ~/.codex

Crie a configuração config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

Crie a configuração de autenticação auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

Inicializar o espaço de trabalho

mkdir my-codex-projectcd my-codex-projectcodex

Onde ficam os arquivos de configuração?

  • Windows: %USERPROFILE%\.codex\
  • macOS/Linux: ~/.codex/

Não consegue conversar depois da configuração?

Tente fazer isto; se ainda não funcionar, entre em contato com o atendimento ao cliente

A imagem mostra a interface do CC Switch, com o título “CC Switch” e vários ícones na parte superior. A linha “Guizhou Cloud Computing” aparece sobre um fundo verde, com um ícone de três pontos à esquerda e a indicação “Falha na consulta” à direita. Uma seta vermelha aponta para o ícone de engrenagem à esquerda, relacionado à seção “Não consegue conversar depois da configuração? Tente fazer isto; se ainda não funcionar, entre em contato com o atendimento ao cliente”, possivelmente indicando que você deve clicar nesse ícone para ajustar as configurações.A imagem mostra a interface do CC Switch, com o título “CC Switch” e vár…

Esta captura de tela mostra as configurações do CC Switch. Setas vermelhas apontam para a aba “Proxy” na parte superior e para o status “Em execução” na área “Proxy local”. O módulo “Proxy local” permite controlar o serviço de proxy e consultar seu status e a porta; o status “Em execução” indica que o serviço de proxy está funcionando normalmente.Esta captura de tela mostra as configurações do CC Switch. Setas vermelh…

A imagem mostra as configurações de proxy do guia de implantação do Codex. Na parte superior há as abas “Geral”, “Proxy” e “Logs”, com “Proxy” selecionada. O interruptor principal do proxy e o retorno de exibição da ativação do proxy aparecem na tela; abaixo há as opções Codex e Gemini, com uma seta vermelha apontando para Codex. A página também mostra endereço do servidor proxy, porta, tipo e recursos do proxy, além da opção de registro de logs do aplicativo e seu interruptor. A imagem está relacionada à solução para problemas de conversa após a configuração e ilustra as opções de proxy.A imagem mostra as configurações de proxy do guia de implantação do Code…

Guia de implantação do Claude Code

Abrange instalação, inicialização, integração de proxy, erros comuns e o fluxo completo de implantação.

Guia de implantação do Hermes

Para cenários de AI Agent no terminal, abrangendo instalação do ambiente, configuração do modelo e solução de problemas.

Seções desta página

🎯 Navegação rápida🚀 Configuração rápida com o CC-Switch (recomendado)Etapas de configuração⌨️ Configuração manual pela linha de comando🖥️ WindowsPrimeiro passo: implantar a ferramenta de linha de comando do CodeXTerceiro passo: inicializar o espaço de trabalho🍏 macOSImplantar a ferramenta CodeXIntegrar o serviço de APIInicializar o espaço de trabalho🐧 LinuxImplantar a ferramenta CodeXIntegrar o serviço de APIInicializar o espaço de trabalhoOnde ficam os arquivos de configuração?Não consegue conversar depois da configuração?