Your privacy choices

Allow optional cookies for referral attribution and anonymous visit measurement.

Dux institutionis Claude Code

Institutionem, initializationem, connexionem proxy, errores communes et totum iter explicat.

Primum documenta officialia lege: docs.claude.com

📋 Requisita priora
Primum Node.js institue, et confirma Node.js 18+ recte institutum esse.

⚡ Prima institutio: errorem initializationis praeteri

Cum canali intermedio uteris, Claude Code in primo initio hunc errorem ostendit:

Imago errorem primi initii Claude Code in fundo nigro ostendit. Post “Welcome to Claude Code” apparent “Unable to connect to Anthropic services” et “Failed to connect to api.anthropic.com: ERR_BAD_REQUEST”; usor admonetur ut conexionem interretialem et retis inspiciat. Etiam dicitur Claude Code fortasse in regione usoris non praesto esse, cum nexu officiali.Imago errorem primi initii Claude Code in fundo nigro ostendit. Post “We…

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Hoc fit quia Claude Code in primo initio officialem API ad confirmationem initializationis coniungere conatur, quam canalis intermedius perficere non potest. Post institutionem sed ante primum initium, unum ex his modis exsequere:

Modus I: praeteri per CC-Switch (commendatus)

Novissimum fasciculum institutionis pro macOS vel Windows e pagina CC-Switch depone. Aperi instrumentum CC-Switch, intra Optiones → Generalia, atque optionem “Praeteri confirmationem primae institutionis Claude Code” activa.

Imago tab generalem in optionibus CC-Switch ostendit. Optio praetereundi confirmationem primae institutionis Claude Code rubro quadro illustratur et eius commutator activus est.Imago tab generalem in optionibus CC-Switch ostendit. Optio praetereundi…

Modus II: fasciculum configurationis manu muta

In directorio principali usoris fasciculum ~/.claude.json inveni et in fine campum "hasCompletedOnboarding": true adde:

⚠️ Formam JSON observa
Antequam campum addis, comma Anglicum in fine campi prioris adde; alioquin forma JSON falsa Claude Code initium impediet.
{
"installMethod": "unknown",
"autoUpdates": true,
"firstStartTime": "2025-07-14T06:11:03.877Z",
"userID": "xxxx",
"projects": {
"/home/your-user": {
"allowedTools": [],
"history": [],
"mcpContextUris": [],
"mcpServers": {},
"enabledMcpjsonServers": [],
"disabledMcpjsonServers": [],
"hasTrustDialogAccepted": false,
"projectOnboardingSeenCount": 0,
"hasClaudeMdExternalIncludesApproved": false,
"hasClaudeMdExternalIncludesWarningShown": false
}
},
"hasCompletedOnboarding": true
}

Post mutationem servatam, claude iterum exsequere ut rite utaris.


🚀 Configuratio celeris per CC-Switch (commendata)

Si CC-Switch iam instituisti, configurationes Claude Code facile per interfaciem graphicam administrare potes, sine fasciculis et variabilibus ambitus manu emendandis.

Commoda CC-Switch

  • Interfacies graphica, usus simplex et perspicuus
  • Provisores diversi uno tactu mutantur
  • Variabiles ambitus et fasciculi configurationis automatice administrantur
  • Servatio et restitutio configurationis sustinentur
  • Configuratio sine terminali repellendo mutatur

Gradus configurationis

  1. Inicia CC-Switch et configurationem Claude Code adde

Imago interfaciem addendi configurationem in CC-Switch ostendit. Supra tabs provisoris Claude et provisoris communis sunt, priore electa. Infra regiones provisorum praeparatorum et configurationis propriae apparent; configuratio propria rubro quadro illustratur.Imago interfaciem addendi configurationem in CC-Switch ostendit. Supra t…

  • Aperi applicationem CC-Switch
  • Preme tab 「Claude」 supra
  • Preme tesseram aurantiacam 「+」 in angulo dextro superiore ut novam configurationem addas

Imago interfaciem addendi configurationem in CC-Switch ostendit. API Key occultata est, cum nota clavem a “sk” incipientem a ministerio clientium praebitam esse. Inscriptio petitionis “https://gpt-agent.cc” est; monitum flavum endpoint compatibile cum Claude API sine virgula obliqua finali requirit.Imago interfaciem addendi configurationem in CC-Switch ostendit. API Key…

  1. Comple notitias provisoris
  • Nomen provisoris: nomen proprium (ut "guizhou")
  • API Base URL: insere https://api.llm-token.cn
  • API Key: token proprium Claude e tribunali acceptum insere
  • Electio exemplaris: exemplar Claude praesto pro necessitate elige
  • Preme “Serva”
💡 Nota
  • Plures configurationes provisorum addere potes (ut officialem, Guizhou Cloud ☁️, etc.)
  • CC-Switch fasciculum ~/.claude/settings.json automatice mutat
  • Post mutationem configurationis Claude Code claude et repelle ut valeat
  1. Configurationem activa et utere
  • Configurationem 「gptagent」 modo creatam in indice inveni
  • Preme “Nunc adhibetur” ad dextram configurationis (vel chartam configurationis directe preme)
  • Configuratio statu “Nunc adhibetur” (titulus viridis) notabitur
  • Claude Code repelle; nova configuratio valebit
  1. Mutatio celeris e lance systematis

CC-Switch configurationes celeriter e lance systematis mutare potest:

  • Iconem CC-Switch in lance systematis dextra preme
  • Categoriam Claude in menu elige
  • Configurationem desideratam directe elige
  • Configuratio statim valet, sine aperienda interfacie principali
⚠️ Animadvertenda
  • Post mutationem configurationis Claude Code repellendum est
  • Celeritatem endpoint API in CC-Switch probare et configurationem optimam eligere potes

Configuratio colloqui non potest?

Hoc proba; si adhuc deficit, ministerium clientium pete.

Imago CC Switch ostendit. Optio “Guizhou Cloud Computing” sagitta rubra indicatur; ad dextram nexus “https://gpt-agent.cc/” et nota defectus interrogationis apparent. Hoc locum inspiciendum cum configuratio deficit demonstrat.Imago CC Switch ostendit. Optio “Guizhou Cloud Computing” sagitta rubra…

Imago tab proxy in optionibus CC Switch ostendit. Status proxy localis est “Currit” et sagitta caerulea eum indicat. Etiam optiones defectus automatice transferendi, rectificatoris et proxy globalis apparent. Hic locus ad statum servitii proxy inspiciendum adhibetur.Imago tab proxy in optionibus CC Switch ostendit. Status proxy localis e…

Imago tab codicis in optionibus ducis Claude Code ostendit. Proxy localis pro versionibus linguarum communium activus est; exemplar Claude activum, Codex et Gemini inactiva sunt. Etiam inscriptio API, clavis API et acta applicationis, quorum commutator activus est, apparent.Imago tab codicis in optionibus ducis Claude Code ostendit. Proxy locali…

⌨️ Configuratio manualis per mandata

Si CC-Switch non adhibes, Claude Code per mandata manu configurare potes.

🖥️ Windows

Requisita systematis

Windows 10, 11

Gradus institutionis

Modus I: Native Install (commendatus)

PowerShell utere:

irm https://claude.ai/install.ps1 | iex

CMD utere:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Modus II: institutio NPM (non commendata)

⚠️ Institutio per npm non commendatur
Canalis npm tardius renovatur et versio instituta plerumque vetustior est; modum Native supra potius elige.
npm install -g @anthropic-ai/claude-code

Institutionem comproba:

claude --version

Variabiles ambitus configura

Si PowerShell adhibes:

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.llm-token.cn", "User")

Si CMD adhibes:

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.llm-token.cn"
💡 Nota
Memento sk-xxx tua clave propria substituere! Post configurationem terminale repelle ut variabiles ambitus valeant.
  • Inicia Claude

In terminali, per cd ad directorium incepti transi vel in quolibet directorio mane; mandatum claude insere ut incipias.

🍏 macOS

Requisita systematis

MacOS 10.15 (Catalina) vel recentius

Gradus institutionis

Modus I: Homebrew (commendatus)

brew install --cask claude-code

Modus II: Curl Script

curl -fsSL https://claude.ai/install.sh | bash

Modus III: institutio NPM (non commendata)

⚠️ Institutio per npm non commendatur
Canalis npm tardius renovatur et versio instituta plerumque vetustior est; modum Native supra potius elige.
npm install -g @anthropic-ai/claude-code

Institutionem comproba

claude -v

Communiter aliquid simile redditur: 1.0.108 (Claude Code)

Variabiles ambitus configura

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Nota
Memento sk-xxx tua clave propria substituere!

Terminale repelle et Claude inicia

Postquam terminale repulisti, per cd ad directorium incepti transi vel in quolibet directorio mane; mandatum claude insere ut incipias.

🐧 Linux

Requisita systematis

Distributio Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+, etc.)

Gradus institutionis

Modus I: Curl Script (commendatus)

curl -fsSL https://claude.ai/install.sh | bash

Modus II: institutio NPM (non commendata)

⚠️ Institutio per npm non commendatur
Canalis npm tardius renovatur et versio instituta plerumque vetustior est; modum Native supra potius elige.
npm install -g @anthropic-ai/claude-code

Institutionem comproba

claude -v

Variabiles ambitus configura

Ubuntu/Debian (Bash)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.bashrc
source ~/.bashrc

Fedora/CentOS (Zsh)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Nota
Memento sk-xxx tua clave propria substituere!

Terminale repelle et Claude inicia

Postquam terminale repulisti, per cd ad directorium incepti transi vel in quolibet directorio mane; mandatum claude insere ut incipias.


Quaestiones communes

Mandatum non invenitur?

  • Confirma Claude Code recte institutum esse
  • Variabilem ambitus PATH inspice
  • Fenestram terminalis repelle

Connexio deficit?

  • Conexionem retis inspice
  • Confirma API Key rectam esse
  • Confirma satis crediti superesse