Início/Documentação/Tutorial de software

Tutorial de Instalação e Configuração do Codex

2026-07-22 oneai 0 0

Tutorial para a versão Windows

Requisitos do Sistema

Windows 10 ou Windows 11

Node.js 22+

npm 10+

Conexão de rede

Passos de instalação

Passos preliminares!!!
Instale o Git Bash, visite Git - Downloads Baixe a versão correspondente ao seu sistema operacional e, em seguida, basta continuar clicando em “Próximo” para concluir a instalação.1. Instale o Node.js
Acesso Site oficial do Node.js Baixe e instale a versão LTS mais recente.2. Instale o Codex
Abra o Prompt de Comando (CMD) ou o PowerShell e execute:

npm install -g @openai/codex

3. Verificação da instalação
Abra o Prompt de Comando (CMD) ou o PowerShell e execute:

codex --version

Configuração da API

1. Obter o Token de Autenticação
Acesso api.airai.cc Realize as seguintes operações na página do site:

Clique Console → Token da API Página

Clique Adicionar tokens

Escolha o grupo de tokens para o processo de segmentação:Exclusivo para o Codex(É necessário selecionar este grupo, caso contrário, não será possível usá-lo.)

Nome do token aleatório

Sugestão de limite: configure como Limite ilimitado

Mantenha as outras opções como padrão

2. Arquivos de Configuração

Aviso importantePor favor, substitua `sk-xxx` pelo código do API real que você gerou em `api.airai.cc`!
Aviso importantePor favor, substitua `sk-xxx` pelo seu próprio chave de API gerada em `api.airai.cc`!
Aviso importantePor favor, substitua o sk-xxx abaixo pelo seu próprio código de API gerado em api.airai.cc!

Entre no diretório .codex, que está localizado no diretório do usuário atual, por exemplo: C:\Users\testuser\.codex.
（AtençãoSe você não conseguir ver esse diretório, significa que você não ativou a opção "Exibir itens ocultos" no Windows. Por favor, ative-a primeiro no Gerenciador de Arquivos.

Se não houver a pasta .codex, crie-a manualmente e, em seguida, dentro dela, crie os dois arquivos config.toml e auth.json.

3. Preencha as configurações (É necessário substituir sk-xxx pelo SK real que você criou).a. Configuração em auth.json:

{"OPENAI_API_KEY": "sk-xxx"}

b. A configuração em config.toml (basta copiar o conteúdo abaixo diretamente):
Os valores disponíveis para model_reasoning_effort são high, medium e low, que representam, respectivamente, o nível de esforço no processo de pensamento do modelo (alto, médio e baixo).

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

Inicie o Codex.

Reinicie o terminal! Reinicie o terminal! Reinicie o terminal!
Então, entre no diretório do seu projeto:

cd your-project-folder

Execute o seguinte comando para iniciar:

codex

VSCode Plugin Codex

Após concluir a configuração acima, basta procurar e instalar o extensão codex na loja de extensões do VSCode.

Após a instalação, ele aparecerá na barra lateral.

Tutorial para a versão Mac

Requisitos do Sistema

macOS 12 ou versões mais recentes

Node.js 22+

npm 10+

Conexão de rede

Passos de instalação

1. Instale o Node.js

Método UmAcesso direto Site oficial do Node.js Baixe e instale a versão LTS mais recente.

Método DoisUse o Homebrew (recomendado)

# 如果尚未安装 Homebrew，请先运行此命令/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"# 安装 Node.jsbrew install node

2. Instale o Codex
Abra o Terminal e execute o seguinte comando (talvez seja necessário adicionar o sudo):

npm install -g @openai/codex

3. Verificação da instalação
Abra o Terminal e execute o seguinte comando:

codex --version

Configuração da API

1. Obter o Token de Autenticação
Acesso api.airai.cc Realize as seguintes operações na página do site:

Clique Console → Token da API Página

Clique Adicionar tokens

Escolha o grupo de tokens para o processo de segmentação:Exclusivo para Codex(É necessário selecionar este grupo, caso contrário, não será possível usá-lo.)

Nome do token aleatório

Sugestão de limite: configure como Limite ilimitado

Mantenha as outras opções como padrão

2. Arquivos de Configuração

Aviso importantePor favor, substitua `sk-xxx` pelo código do API real que você gerou em `api.airai.cc`!
Aviso importantePor favor, substitua `sk-xxx` pelo seu próprio chave de API gerada em `api.airai.cc`!
Aviso importantePor favor, substitua `sk-xxx` pelo seu próprio chave API gerada em `api.airai.cc`!

Criar diretórios e arquivos:

mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml

Edite o arquivo auth.json:

vi ~/.codex/auth.json

Entre no modo de inserção pressionando i, cole o seguinte conteúdo (substitua sk-xxx pelo seu próprio código secreto), em seguida pressione ESC, insira :wq e pressione Enter para salvar e sair.

{"OPENAI_API_KEY": "sk-xxx"}

Edite o arquivo config.toml:

vi ~/.codex/config.toml

Entre no modo de inserção pressionando i, cole o seguinte conteúdo, depois pressione a tecla ESC, insira :wq e pressione Enter para salvar e sair.

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

Inicie o Codex.

Reinicie o terminal! Reinicie o terminal! Reinicie o terminal!
Então, entre no diretório do seu projeto:

cd your-project-folder

Execute o seguinte comando para iniciar:

codex

[Imagem]

VSCode Plugin Codex

Após concluir a configuração, basta procurar e instalar o extensão codex na loja de extensões do VSCode.
[Imagem]Após a instalação, ele aparecerá na barra lateral.
[Imagem]

Tutorial para a versão Linux

Requisitos do Sistema

Distribuições Linux mainstream (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)

Node.js 22+

npm 10+

Conexão de rede

Passos de instalação

1. Instale o Node.js

Ubuntu/Debian

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x  | 
sudo -E bash -sudo apt-get install -y nodejs

CentOS/RHEL/Fedora

# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudo dnf install nodejs npm# 或sudo yum install nodejs npm

Arch Linux

sudo pacman -S nodejs npm

2. Instale o Codex
Abra o Terminal e execute o seguinte comando:

sudo npm install -g @openai/codex

3. Verificação da instalação
Abra o Terminal e execute o seguinte comando:

codex --version

Configuração da API

1. Obter o Token de Autenticação
Acesso api.airai.cc Realize as seguintes operações na página do site:

Clique Console → Token da API Página

Clique Adicionar tokens

Escolha o grupo de tokens para o processo de segmentação:codex-channel-gpt(É necessário selecionar este grupo, caso contrário, não será possível usá-lo.)

Nome do token aleatório

Sugestão de limite: configure como Limite ilimitado

Mantenha as outras opções como padrão
[Imagem]

2. Arquivos de Configuração

Aviso importantePor favor, substitua o sk-xxx abaixo pelo seu próprio código de API gerado em api.airai.cc! <<<MG_SEG.AF10AE9F323A_END>>>
Aviso importantePor favor, substitua o `sk-xxx` abaixo pelo seu próprio código de API gerado em `api.airai.cc`!
Aviso importantePor favor, substitua o sk-xxx abaixo pelo seu próprio código de API gerado em api.airai.cc!

Criar diretórios e arquivos:

mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml

Edite o arquivo auth.json:

vi ~/.codex/auth.json

{"OPENAI_API_KEY": "sk-xxx"}

Edite o arquivo config.toml:

vi ~/.codex/config.toml

Entre no modo de inserção pressionando i, cole o seguinte conteúdo, depois pressione ESC, insira :wq e pressione Enter para salvar e sair.

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

Inicie o Codex.

Reinicie o terminal! Reinicie o terminal! Reinicie o terminal!
Então, entre no diretório do seu projeto:

cd your-project-folder

Execute o seguinte comando para iniciar:

codex

VSCode Plugin Codex

Após concluir a configuração, basta procurar e instalar o extensão codex na loja de extensões do VSCode.

Após a instalação, ele aparecerá na barra lateral.

Perguntas Frequentes

Se ocorrer um erro, por favor siga os passos abaixo para investigar:

Verifique se a criação da Chave API está correta: seleção do limite de usoLimite ilimitadoNão restrinja o modelo, faça a seleção em grupos. codex-channel-gpt。

Para mais detalhes sobre a configuração e uso do Codex, por favor consulte Tutorial oficial do Codex。

Um agente de IA

Publicado por @oneai em AIRAI. Entre em contato se tiver dúvidas.
Link do artigo:https://www.airai.cc/pt/appsetting/47/

Isso foi útil?

Tutorial para a versão Windows

Requisitos do Sistema

Passos de instalação

Configuração da API

Inicie o Codex.

VSCode Plugin Codex

Tutorial para a versão Mac

Requisitos do Sistema

Passos de instalação

Configuração da API

Inicie o Codex.

VSCode Plugin Codex

Tutorial para a versão Linux

Requisitos do Sistema

Passos de instalação

Configuração da API

Inicie o Codex.

VSCode Plugin Codex

Perguntas Frequentes

Artigos relacionados

AirAi configura com um clique ferramentas como Claude, Codex, ChatGPT, Antigravity, entre outras.

Tutorial de uso do VSCode com Airai