Guia de implantação do Codex
Baixe o CC Switch para o seu sistema, insira sua chave de API da Guishu AI e confira a primeira resposta do Codex CLI no terminal.
1. Baixar e abrir o CC Switch
Use o CC Switch para configurar o acesso à API. Depois, use o Codex CLI para conversar pelo terminal. Escolha o instalador do CC Switch 4.0.25 para o seu computador.
- Windows x64 · Baixar MSI Para a maioria dos PCs com processador Intel ou AMD. Clique duas vezes no arquivo
.msi, conclua a instalação e abra o CC Switch pelo menu Iniciar. - Windows ARM64 · Baixar MSI Escolha este arquivo se, em “Configurações → Sistema → Sobre”, o campo “Tipo de sistema” indicar um processador ARM.
- macOS · Baixar DMG Para Macs com chip da Apple ou processador Intel. Clique duas vezes no arquivo
.dmg, arraste o CC Switch para a pasta Aplicativos e abra o programa por lá. - Linux · Escolher pacote Expanda a seção “Assets” e escolha a arquitetura indicada por
uname -m(se apareceraarch64, selecionearm64). No Ubuntu ou Debian, baixe o.deb. No Fedora, baixe o.rpm.
Baixou outro arquivo? O arquivo v3.12.2-en.md contém as notas da versão. Se depois de extrair o arquivo você só encontrar CC-SWITC.14, use o instalador do seu sistema indicado acima. Pode deixar a extensão como está. Outras versões estão na página oficial de lançamentos.
2. Instalar o Codex CLI
No Windows, abra o Prompt de Comando. No macOS ou Linux, abra o terminal. Se você já instalou o Codex, execute codex --version. Se o número da versão aparecer, passe para a etapa 3.
Na primeira instalação, instale o Node.js LTS, abra o terminal novamente e execute os dois comandos abaixo, nesta ordem. O segundo deve mostrar codex-cli e o número da versão.
npm install -g @openai/codex@latest
codex --version3. Configurar a Guishu AI no CC Switch
Selecione Codex na barra lateral, abra a aba Direct e clique em Add Provider (+). Na categoria All, selecione Custom Configuration.
| Campo no CC Switch | O que preencher |
|---|---|
| Name | Digite “Guishu AI” para identificar o provedor na lista. |
| API Request URL | Digite https://api.llm-token.cn/v1, incluindo o /v1 no final. |
| API Key | Cole a chave de API completa que você recebeu da Guishu AI. |
| Default Model | Na lista de modelos, copie o ID de um modelo que aceite a API Responses e esteja disponível para a sua chave, como gpt-6.1-terra. |
Clique em Add no fim da página. De volta à aba Direct, clique em Switch no cartão “Guishu AI”. Se você estava usando roteamento ou agregação, o botão aparece como Back to direct and use. Quando o cartão mostrar In use, abra o Codex.
4. Conferir a primeira resposta no terminal
Se o Codex estiver aberto, encerre a sessão. No terminal, entre na pasta do projeto e execute codex. Se ainda não tiver um projeto, você pode começar com uma pasta vazia:
mkdir my-codex-project
cd my-codex-project
codexNo Codex, digite “Responda apenas com OK”. Ao receber a resposta, você confirma que a solicitação foi concluída. O teste consome saldo da sua chave.
Ficou sem resposta? Se aparecer o erro 401, cole a chave de API novamente e confira se ela está ativa. Se o modelo estiver indisponível, verifique o ID do modelo e as permissões da chave. Se o endereço da API não for encontrado, confira se a URL termina em /v1 e se Upstream Format está definido como OpenAI Responses nas opções avançadas.
Opcional: editar os arquivos de configuração manualmente
Se você já recebeu uma resposta com o CC Switch, a configuração está pronta. Para configurar manualmente, edite os dois arquivos abaixo em %USERPROFILE%\.codex\ no Windows ou em ~/.codex/ no macOS e no Linux. Crie a pasta se ela ainda não existir. Se já tiver arquivos de configuração, faça uma cópia de segurança e mantenha as demais opções.
config.toml — Informe o provedor, o endereço da API e um modelo disponível para a sua chave.
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json — Substitua o valor de exemplo pela sua chave de API da Guishu AI, salve o arquivo e abra o Codex novamente como na etapa 4.
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}