Integração do Codex CLI

Método de configuração para integrar o OpenAI Codex CLI com a 1折AI (model_providers em ~/.codex/config.toml), chamando modelos GPT por meio da Responses API.

Os modelos OpenAI / GPT já estão ativos. O Codex CLI usa a OpenAI Responses API (/v1/responses) e se conecta usando a chave de API deste site. Para ver os modelos disponíveis e os preços, consulte o catálogo de modelos.

Primeiro, vamos esclarecer como configurar um provedor personalizado para o Codex. O formato vem da documentação oficial de configuração do Codex.

Arquivo de Configuração

A configuração do Codex fica em ~/.codex/config.toml. Provedores personalizados só podem ser escritos neste arquivo de nível de usuário; a configuração .codex/config.toml model_provider em um projeto será ignorada.

1
model_provider = "onezhe"
2
model = "gpt-6-astra"
3

4
[model_providers.onezhe]
5
name = "1折AI"
6
base_url = "https://1zheai.com/v1"
7
env_key = "ONEZHE_API_KEY"
8
wire_api = "responses"

O exemplo usa gpt-6-astra, que pode ser substituído por qualquer outro ID de modelo GPT suportado pela sua chave.

Significado de cada campo:

Campo	Descrição
`model_provider`	Qual provedor usar, correspondente ao id em `[model_providers.<id>]` abaixo. `openai`, `ollama`, `lmstudio` são nomes reservados e não podem ser usados
`base_url`	Deve incluir `/v1`
`env_key`	O Codex lê a chave de API desta variável de ambiente; o nome deve corresponder exatamente ao que você exporta
`wire_api`	A documentação oficial afirma que atualmente apenas `responses` é suportado; também é o padrão quando omitido

Em seguida, coloque a chave de API em uma variável de ambiente:

macOS / Linux
Windows PowerShell

export ONEZHE_API_KEY="sk-你的Key"

[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")

Instalando o Codex

Os comandos a seguir vêm da documentação oficial do Codex:

npm install -g @openai/codex

brew install --cask codex

curl -fsSL https://chatgpt.com/codex/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Perguntas Frequentes

401？

O nome da variável em env_key não corresponde ao que você realmente exportou, ou você abriu o terminal antes de definir a variável de ambiente. Verifique novamente os nomes em ambos os lados e, em seguida, reabra o terminal e tente novamente.

Dá para mudar wire_api para chat?

Não. A documentação oficial de configuração do Codex afirma que wire_api aceita apenas responses. Serviços que fornecem apenas uma API Chat Completions precisam de uma ferramenta adicional de conversão de protocolo para se conectar ao Codex.

Como escolher o modelo GPT?

Verifique os modelos atuais no catálogo de modelos e preencha o ID do modelo em model. Após iniciar o Codex, faça uma solicitação curta e verifique o modelo e o status no log de chamadas.