Código de reivindicação de upgrade gratuito: Acesso local Modelos claude-sonnet-4-20250514

Na onda do desenvolvimento assistido por IA, os desenvolvedores estão constantemente buscando as melhores práticas para integrar perfeitamente modelos de linguagem de alto nível com fluxos de trabalho locais. Antrópica apresentado Claude Code Como um poderoso assistente de IA nativo de ponta a ponta, ele pode entender e manipular diretamente toda a base de código, o que melhora muito a eficiência do desenvolvimento. Enquanto isso, o IDE de IA da Amazon AWS Kiro Em sua versão prévia gratuita, ele fornece acesso a modelos específicos do Anthropic. claude-sonnet-4-20250514 de acesso. O modelo alcança avanços significativos na capacidade de codificação, na velocidade de inferência e na relação custo-benefício.

Neste documento, apresentamos uma combinação inteligente de soluções: por meio de duas ferramentas leves desenvolvidas pela comunidade Ki2API responder cantando Claude Code Routerque conecta os dois. O objetivo dessa solução é permitir que os desenvolvedores não façam quase nenhuma modificação no Claude Code experiência nativa, ela é livre para substituir seu modelo de back-end por um modelo mais eficiente claude-sonnet-4-20250514.

Arquitetura explicada: como os fluxos de trabalho são implementados?

Todo o fluxo de trabalho forma uma cadeia clara de solicitações locais que Claude Code A interação do front-end com o Kiro A extremidade traseira do modelo está conectada.

Caminho da solicitação: Claude Code -> Claude Code Router -> Ki2API -> Kiro (claude-sonnet-4-20250514)

• Por que você precisa dessa estrutura?
  • Interfaces padronizadas da OpenAI: Ki2API desempenha um papel fundamental de adaptador. Ele desempenha um papel fundamental na 8989 para iniciar um serviço que irá Kiro As chamadas de modelo são encapsuladas em um formato totalmente compatível com a API da OpenAI, incluindo o /v1/models responder cantando /v1/chat/completions e oferece suporte a respostas de streaming. Isso facilita o acesso a qualquer cliente que seja compatível com a interface OpenAI.
  • Roteamento flexível de solicitações: Claude Code Router (CCR) É uma especialidade para Claude Code ferramenta de proxy projetada. Ela lê o arquivo de configuração local e pode interceptar o Claude Code Diferentes tipos de solicitações emitidas (por exemplo, codificação regular, tarefas em segundo plano, processamento de contexto longo etc.) e as encaminham para o modelo de backend especificado, respectivamente.
  • Alta disponibilidade de modelos:: Adoção Kiro os desenvolvedores podem estabilizar o uso da plataforma claude-sonnet-4-20250514 Modelo. O modelo tem melhor desempenho e é mais ágil ao lidar com tarefas de codificação complexas e raciocínio de processo longo.

Três etapas para a configuração local

Etapa 1: iniciar o serviço Ki2API

Primeiro, precisamos iniciar o Ki2APIEle será usado como uma conexão Kiro Gateway local para a plataforma.

git clone https://github.com/zhalice2011/ki2api
cd ki2api
docker-compose up -d

Serviço de escuta padrão http://localhost:8989. Ki2API lê automaticamente as credenciais locais do cache do AWS SSO (geralmente localizadas na pasta ~/.aws/sso/cache/ ) e tem uma lógica de atualização automática incorporada. Se desejar, isso também pode ser feito por meio da função KIRO_ACCESS_TOKEN responder cantando KIRO_REFRESH_TOKEN para especificar manualmente as credenciais.

Etapa 2: Instalar o Claude Code e o Claude Code Router

Certifique-se de que você tenha o Node.jse depois através do npm instalação global Claude Code responder cantando Claude Code Router.

# 如果已安装 Claude Code，可跳过此步
npm install -g @anthropic-ai/claude-code
# 安装路由工具
npm install -g @musistudio/claude-code-router

Etapa 3: Escreva o arquivo de configuração e inicie

estabelecer Claude Code Router arquivo de configuração. Salve o seguinte conteúdo JSON em sua totalidade no arquivo ~/.claude-code-router/config.json Caminho.

{
"LOG": false,
"OPENAI_API_KEY": "",
"OPENAI_BASE_URL": "",
"OPENAI_MODEL": "",
"Providers": [
{
"name": "openai",
"api_base_url": "http://localhost:8989/v1/chat/completions",
"api_key": "ki2api-key-2024",
"models": [
"claude-sonnet-4-20250514"
]
}
],
"Router": {
"default": "openai,claude-sonnet-4-20250514",
"background": "openai,claude-sonnet-4-20250514",
"think": "openai,claude-sonnet-4-20250514",
"longContext": "openai,claude-sonnet-4-20250514",
"webSearch": "openai,claude-sonnet-4-20250514"
}
}

Configuração:

• Providers define os serviços de backend disponíveis. Aqui nós vamos name por causa de openai O serviço aponta para o Ki2API O endereço do
• Router O campo Claude Code Todos os painéis de tarefas (default, think e assim por diante) são roteados para o openai serviços e claude-sonnet-4-20250514 Modelos.

Quando a configuração estiver concluída, execute o seguinte comando para iniciar Claude Code::

ccr code

Neste ponto.CCR recuperação judicial Claude Code da solicitação da Web e siga as instruções Router A regra o encaminha para o Ki2API que, por fim, chama o serviço claude-sonnet-4-20250514 Modelos.

Perguntas frequentes e soluções

• 401 Erro não autorizado
  • Análise das causasA chave da API está incorreta ou Kiro As credenciais de acesso expiraram.
  • prescrição:: Certifique-se de que o arquivo de configuração api_key junto com Ki2API pré-configurado ki2api-key-2024 Consistente. Além disso, verifique Ki2API para confirmar que ele obteve ou liberou com sucesso os registros do contêiner do Docker do Kiro O token de acesso para o
• Conflito de portas ou falha de conexão
  • Análise das causas: Local 8989 a porta já está ocupada por outro programa, ou Ki2API O serviço não foi iniciado corretamente.
  • prescrição: Uso docker-compose logs -f para visualizar Ki2API dos registros em tempo real para localizar o problema. Se houver um conflito de portas, você poderá modificar o docker-compose.yml arquivo, que irá 8989 Mapeamento para outras portas disponíveis e sincronização de atualizações CCR no arquivo de configuração api_base_url.
• As alterações de configuração não têm efeito
  • Análise das causas: Claude Code Router Carrega a configuração na inicialização; as alterações em tempo de execução nos arquivos não são recarregadas automaticamente.
  • prescrição:: Modificações config.json você precisa executar novamente o arquivo ccr code para reiniciar o serviço para que a nova configuração tenha efeito.