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 “We…
Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUESTHoc 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…
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
- Inicia CC-Switch et configurationem Claude Code adde
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…
- 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
|
- 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
- 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
|
Configuratio colloqui non potest?
Hoc proba; si adhuc deficit, ministerium clientium pete.
Imago CC Switch ostendit. Optio “Guizhou Cloud Computing” sagitta rubra…
Imago tab proxy in optionibus CC Switch ostendit. Status proxy localis e…
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 | iexCMD utere:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdModus 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-codeInstitutionem comproba:
claude --versionVariabiles 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-codeModus II: Curl Script
curl -fsSL https://claude.ai/install.sh | bashModus 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-codeInstitutionem comproba
claude -vCommuniter 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 | bashModus 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-codeInstitutionem comproba
claude -vVariabiles 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 ~/.bashrcFedora/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