🪄 Integrando o Claude Code com Modelos Personalizados CodingPlanX

O Claude Code é um poderoso assistente de programação de IA lançado pela Anthropic. Ele se integra diretamente ao seu terminal, entende a sua base de código e colabora perfeitamente com você para escrever, refatorar e depurar código.

Este tutorial irá guiá-lo através da preparação do ambiente, instalação de ferramentas e configuração exclusiva para a interface de proxy codingplanx.ai.

📋 Requisitos do Sistema

Antes de começar, certifique-se de que seu sistema atende aos seguintes requisitos mínimos:

Node.js: Versão >= 18.0
Sistema Operacional: macOS, Linux, Windows (WSL recomendado)

🚀 Início Rápido

1. Instalar Node.js

💡 Dica: Se você já tem o Node.js 18.0 ou superior instalado, pule este passo diretamente.

🍎 Usuários macOS

Recomenda-se a instalação via Homebrew:

# 1. Instalar ferramentas de linha de comando do Xcode
sudo xcode-select --install

# 2. Instalar Homebrew (se ainda não estiver instalado)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. Instalar Node.js via Homebrew
brew install node

# 4. Verificar a instalação
node --version

🐧 Usuários Ubuntu / Debian

Use o script oficial do NodeSource para instalar a versão LTS:

# 1. Baixar e executar o script de instalação
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. Instalar Node.js
sudo apt-get install -y nodejs

# 3. Verificar a instalação
node --version

🪟 Usuários Windows

Recomenda-se usar a linha de comando winget para a instalação, ou ir ao Site Oficial do Node.js para baixar o instalador:

# Instalar a versão LTS do Node.js usando winget
winget install OpenJS.NodeJS.LTS

# Verificar a instalação (Pode ser necessário reiniciar o terminal após a instalação)
node --version

2. Instalar Claude Code

Abra seu terminal e use o npm para instalar o Claude Code globalmente:

npm install -g @anthropic-ai/claude-code

# Verificar se a instalação foi bem-sucedida
claude --version

(Nota: Se você encontrar erros de permissão, usuários de macOS/Linux podem precisar usar sudo npm install -g @anthropic-ai/claude-code)

3. Configurar e Começar a Usar

🔑 Obter Informações Necessárias de Configuração

Para usar este serviço, você precisa preparar as duas seguintes variáveis de ambiente:

Configuração	Descrição	Como Obter
`ANTHROPIC_AUTH_TOKEN`	Token de Autenticação da API	Após o registro, vá para a página API Tokens e clique em Add Token (Começa com `sk-`)
`ANTHROPIC_BASE_URL`	Endereço do Serviço da API	Preencha exatamente: `https://api.codingplanx.ai`

📝 Sugestões ao criar um token:

Nome: Dê o nome que quiser (ex: claude-code-cli)

Cota: Defina como Unlimited Quota (Cota Ilimitada)

Grupo: Selecione Claude code exclusive ou Official Claude 3 & above Proxy

Outras Opções: Mantenha as configurações padrão

💻 Iniciar Claude Code

Por favor, escolha o comando de inicialização correspondente com base no seu sistema operacional e terminal. Por favor, navegue até o diretório do seu projeto primeiro:

cd sua-pasta-do-projeto

🟢 Linux / macOS (Bash/Zsh)

# Definir variáveis de ambiente (efetivo para a sessão de terminal atual)
export ANTHROPIC_AUTH_TOKEN="sk-SeuTokenReal"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # Definir tempo limite para 300 segundos para evitar desconexões em respostas longas

# Iniciar Claude Code
claude

🔵 Windows PowerShell

# Definir variáveis de ambiente (efetivo para a sessão de terminal atual)
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-SeuTokenReal"
$env:API_TIMEOUT_MS = "300000"

# Iniciar Claude Code
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-SeuTokenReal
set API_TIMEOUT_MS=300000

claude

💡 Dica Profissional: Se você não quiser inserir variáveis de ambiente todas as vezes, pode adicionar as instruções export acima ao seu arquivo ~/.bashrc ou ~/.zshrc (Mac/Linux), ou adicionar variáveis de ambiente permanentes nas configurações de sistema do Windows.

⚙️ Assistente de Configuração da Primeira Execução

Ao iniciar o claude pela primeira vez, o sistema irá guiá-lo através das configurações básicas:

Theme (Tema) 👉 Selecione seu esquema de cores de terminal preferido, pressione Enter para confirmar.
Safety (Segurança) 👉 Leia e confirme os avisos de segurança, pressione Enter.
Terminal 👉 Recomenda-se as configurações padrão, pressione Enter.
Trust (Confiança) 👉 Confirme que você confia no diretório de trabalho atual, pressione Enter.

✨ Parabéns! Quando você vir o prompt de entrada, poderá começar a conversar com seu parceiro de programação de IA! Tente digitar: "Ajude-me a explicar a estrutura principal deste projeto".

❓ Perguntas Frequentes (FAQ)

Q: Encontrou o erro `Invalid API Key · Please run /login`?

R: Isso indica que o Claude Code falhou ao ler suas variáveis de ambiente. Por favor, verifique:

Se ANTHROPIC_AUTH_TOKEN e ANTHROPIC_BASE_URL estão definidos corretamente.
Se o formato do token está correto (ele deve começar com sk- e não conter espaços extras ou aspas).
Se você configurou variáveis de ambiente permanentes, certifique-se de ter reiniciado o seu terminal para que elas entrem em vigor.

Q: Por que o canto inferior esquerdo do terminal mostra status `offline`?

R: O Claude Code, por padrão, faz um ping no google.com para verificar o status da rede. Em certos ambientes de rede restritos, mostrar offline é normal e não afetará o seu uso normal e a geração de código de forma alguma.

Q: Por que pedir ao Claude para navegar na web (Fetch) falha?

R: Antes de acessar páginas da web externas, o Claude Code precisa chamar serviços oficiais para verificações de segurança. Se você encontrar falhas no Fetch:

Certifique-se de que o seu computador tem uma conexão de internet internacional estável.
Se necessário, ative um proxy de terminal global (ex: export https_proxy=...).

Q: Por que as requisições sempre pedem `fetch failed` ou dão tempo limite (timeout)?

R: Isso geralmente é causado por flutuações de rede ou encaminhamento de proxy. Soluções:

Verifique se a variável de ambiente de tempo limite está definida corretamente: API_TIMEOUT_MS=300000.
Tente alterar o seu nó de proxy local.
Pressione Ctrl+C para sair da sessão atual e execute novamente o comando claude.

Q: Erro de login na web?

R: Se você encontrar anomalias na página da web ao obter um Token, tente limpar o cache de Cookies do seu navegador ou use o modo de navegação anônima para fazer login em yunwu.ai novamente.

📌 Notas Importantes

🛡️ Aviso de Interface: Este site se conecta diretamente ao serviço oficial de encaminhamento do Claude Code, perfeitamente adaptado para a ferramenta CLI.
🚦 Limites de Taxa: A configuração atual suporta apenas o tráfego da API do Claude Code e não suporta chamadas de API padrão para outros clientes de terceiros.
🔒 Aviso de Segurança: Mantenha o token da sua API (sk-...) seguro. Nunca o codifique rigidamente (hardcode) em seus scripts ou faça o upload para repositórios públicos no GitHub.