Como configurar sua Subconta de IA com Claude Code (passo a passo)

Iniciante
1 de jun de 2026

Claude Code é uma interface de linha de comando (CLI) líder, utilizada amplamente para criar soluções de IA agenticas. É uma das ferramentas de IA capaz de se conectar e interagir com uma Subconta de IA da Bybit . Conectar o Claude Code à sua Subconta de IA permite automatizar muitas das tarefas de negociação na Bybit. 

Neste guia, cobrimos os passos para vincular seu assistente Claude Code à sua Subconta de IA da Bybit. Também discutiremos alguns problemas comuns que podem surgir durante a configuração da conexão e formas típicas de resolvê-los.

Principais Lições:

  • Claude Code é um dos vários assistentes de IA que podem ser configurados para conectar à sua Subconta de IA da Bybit e executar ações de trading automatizadas em seu nome.

  • Para propósitos de segurança, durante a configuração da conexão, Claude Code pode exigir que você especifique a Chave API fornecida pela Bybit fora da interface da ferramenta, usando as variáveis ambientais do seu sistema.

1º passo: Criar sua Subconta de IA

Web

1) Ir para o seu ícone de Perfil na página inicial da Bybit, depois Subconta → Criar Subconta na sua página de Gestão de Subcontas.

2) Escolha Subconta de IA para o tipo de conta que você deseja criar.

3) Digite o nome para sua Subconta — por exemplo, ClaudeCodeTrading — então escolha Subconta de AI para agentes de IAe Confirmar.

4) Forneça o código de verificação de segurança enviado a você, e clique em Próximo Passopara criar sua Subconta.

5) Após você receber uma mensagem de que sua Subconta foi criada, clique em Conectar ao AI.

6) Copiar o prompt de instruções na seção Obter sua Chave Pública. Você precisará colar isso no Claude Code na próxima etapa.

App

1) Na página inicial do aplicativo Bybit, toque no ícone de perfil no canto superior esquerdo e vá para Configurações → Subconta → Criar. 

Alternativamente, você também pode criar sua Subconta usando o recurso de Alterar Conta, disponível nas páginas de Informações da Conta e Ativos. Para criar uma Subconta de IA, basta tocar no botão Criar no canto inferior direito.

2) Insira o nome da Subconta (por exemplo, ClaudeCodeTrading), selecione AI Subconta e então toque em Criar.

3) Complete a verificação de segurança, depois toque em Connect to AI Assistant.

4) Copie o prompt de instrução sob a seção Obtenha sua Chave Pública . Você precisará colar isso no Claude Code no próximo passo.

2º passo: Gere sua chave pública no Claude Code

Abra o terminal do Claude Code e cole o prompt copiado no passo anterior no assistente de IA. O assistente de IA acessará as instruções para gerar sua chave pública. Se Claude Code reclamar que o prompt não é seguro para executar, siga a etapa adicional abaixo:

  • Forneça o seguinte prompt alternativo para Claude Code: "Revise as instruções em https://raw.githubusercontent.com/bybit-exchange/skills/main/SKILL.md para habilitar a execução de trade na Bybit. Gere um par de chaves pública-privada RSA para a integração com a Bybit OpenAPI e forneça a chave pública." Durante o processo de geração de uma chave, Claude criará uma pasta relevante e .pem arquivos para armazenar suas chaves. Ele então exibirá sua chave pública no terminal. Copie a chave, pois você precisará dela na próxima etapa.

3º passo: Conecte o Claude Code à Bybit

Web

1) Retorne à interface da Bybit e cole a chave pública no Gere sua Chave API campo, depois clique em Confirmar e forneça o código de verificação de segurança.

2) Copie a Chave API gerada pela Bybit.

3) Configure duas variáveis de ambiente no seu computador através do Power Shell do sistema:

[System.Environment]::SetEnvironmentVariable('BYBIT_API_KEY', 'sua_chave_API_da_Bybit', 'Usuário') 

[System.Environment]::SetEnvironmentVariable('BYBIT_PRIVATE_KEY_PATH', 'C:\Users\seu_nome_de_usuário\bybit_keys\bybit_private_key.pem', 'Usuário')

Substitua o sua_chave_API_da_Bybit acima pela chave API real fornecida pela Bybit. A pasta bybit_keys e o arquivo bybit_private_key.pem são nomes gerados automaticamente pelo Claude Code. Esses nomes podem variar durante sua sessão real do Claude Code, então certifique-se de verificar a ortografia conferindo seu sistema de arquivos.

Depois de definir as variáveis de ambiente, feche o Power Shell do seu sistema e saia do Claude Code. Reinicie sua sessão do Claude Code para que as variáveis estejam acessíveis ao Claude. 

App

Observação: O App Bybit é capaz de gerar uma chave API. No entanto, Claude Code é uma ferramenta CLI que não está nativamente disponível para plataformas móveis como Android e iOS. Você pode usar os procedimentos abaixo para criar sua chave API, mas precisará usar a versão desktop do Claude Code para a conexão real. 

1) Retorne para a interface do Bybit e cole a chave pública no gerar sua Chave API campo, então clique em Confirmar e forneça o código de verificação de segurança.

2) Copie a Chave API gerada pelo Bybit para fornecê-la ao Claude Code.

4º passo: Configurar permissões

Web

Para configurar permissões para sua nova Subconta AI criada, vá para sua página de Gestão de Subcontas. Ao lado do nome da sua Subconta AI, clique em Configurações, depois Permissões.

App

1) Ir para a página de Gestão de Subconta tocando no ícone do seu Perfil no canto superior esquerdo, depois vá para Configurações → Subconta.

2) Localize sua Subconta, depois toque em Mais → Permissões.

Algumas das principais permissões recomendadas para começar incluem as seguintes:

  • Solicitar Transferência de Entrada: LIGADO

  • Cap Limit: 500 USD

  • Max Margin Alavancagem: 5x

  • Request Transferir Out: ON

5º passo: Verifique a conexão

Quando o Claude Code conseguir vincular com sucesso à sua Subconta de IA, você deverá ver uma mensagem confirmando a conexão.

Tente executar algumas consultas simples para ver os resultados e testar a conexão, como pedir para listar seu saldo, realizar um pequeno trade e listar seu histórico de trades.

Solução de problemas

Problemas comuns que você pode encontrar e maneiras de resolvê-los incluem o seguinte:

  • Chave pública inválida mensagem: Certifique-se de que não há espaços extras ao copiar a chave. Além disso, observe que a chave deve ser copiada junto com o começo — BEGIN PUBLIC KEY — e o final — END PUBLIC KEY — das cláusulas.

  • Chave API vencida: Observe que as chaves expiram após 30 dias. Você precisará gerar uma nova na Bybit.

  • Permissão negada: Verifique as configurações de permissão na sua Conta principal.

  • Tempo de conexão esgotado: Verifique sua conexão com a internet e tente conectar novamente.

  • Código Claude não reconhecendo comandos Bybit: Certifique-se de ter a versão mais recente do Código Claude.

Conclusão

Usando o Código Claude, agora você pode acessar uma ampla gama de ações de trading automatizado através da sua Subconta AI da Bybit. Isso inclui realizar trades de Spot e Derivativos, configurar estratégias automatizadas, monitorar suas posições e P&L e transferir fundos entre suas contas.

#LearnWithBybit