Claude Code Complete Hands-On Guide: Eine Komplettlösung für die Installation, die Konfiguration von Haushaltsmodellen und fortgeschrittene Übungen.

KI-Programmierwerkzeuge entwickeln sich von passiven "Code-Patchern" zu aktiven "Entwicklungspartnern". Sie sind in der Lage, komplexe Anforderungen zu verstehen, Aufgaben zu planen und sich direkt am gesamten Entwicklungsprozess zu beteiligen. In diesem Artikel werfen wir einen detaillierten Blick auf ein Kommandozeilen-KI-Programmiertool, das diesen Trend repräsentiert - ein Tool, das wir Claude Codeund bietet einen detaillierten und vollständigen Leitfaden für seine Verwendung.

Ideen für eine neue Generation von KI-Programmierassistenten

Im Gegensatz zu den bekannten IDE-Plugins ist dieClaude Code Solche Tools wählen eine Schnittstelle, die näher am eigentlichen Arbeitsablauf des Entwicklers liegt - die Befehlszeile (CLI).

Die Befehlszeilenschnittstelle ist einfach und effizient

Dieses Design ist kein Zufall. Für Entwickler ist die Kommandozeile leichtgewichtig, skriptfähig und lässt sich nahtlos mit Tools wie Git integrieren. Die Einbindung von KI-Funktionen in dieses Kernland macht sie zu einem Teil des Workflows und nicht zu einer isolierten Funktion. Zu den Tools der gleichen Kategorie gehören Alis Qwen Code und Googles Gemini CLI.

 
Ähnliche Schnittstellen für CLI AI-Programmierwerkzeuge

Leistungsstarke Modelle und API-Ökosystem

Claude Code 的能力源于背后顶尖的大语言模型，例如由 Anthropisch Unternehmen entwickelt Claude 3 OpusundClaude 3.5 Sonnet Die Modelle von Anthropic, die vom ehemaligen OpenAI-Kernmitglied Dario Amodei gegründet wurden, sind mehrjährig branchenführend in den Bereichen Programmierung und Argumentation.

auch wenn Claude Code Das offizielle Anthropic-Modell wird standardmäßig verwendet, aber seine hohen Kosten schränken die Verwendung durch einzelne Entwickler ein. Glücklicherweise können wir es so konfigurieren, dass es sich mit kostengünstigeren, selbst entwickelten Modellen verbinden lässt, z. B. mit dem Modell von Wisdom Spectrum GLM-4.5 oder die dunkle Seite des Mondes Kimi K2.

Ein wichtiges technisches Detail ist das API-Format. Während die meisten großen Modelle mit dem OpenAI-Aufrufformat kompatibel sind, hat Anthropic eine eigene Reihe von Spezifikationen.Claude Code Es wird das Anthropic-Format verwendet, so dass Modelldienstleister, die dieses Format ebenfalls unterstützen, von Haus aus unterstützt werden. Modelle, die nur das OpenAI-Format unterstützen, müssen über ein Konvertierungstool überbrückt werden.

Darüber hinaus.Claude Code Es handelt sich um eine gut durchdachte, eigenständige Intelligenz mit eingebauten System-Prompts, die für Anthropics eigene Modellfunktionen optimiert sind. Wenn Sie es durch ein Modell eines Drittanbieters ersetzen, kann es zu folgenden Problemen kommen 5% bis 20% der Verlust an Wirksamkeit. Für die überwiegende Mehrheit der Entwicklungsszenarien halten sich diese Auswirkungen jedoch in akzeptablen Grenzen, solange die Anforderungen klar beschrieben sind.

Von "Assistenten" zu "Partnern"

Herkömmliche KI-Programmier-Plug-ins, wie der frühe Tongyi Linguistic Code, sind durch Modellfähigkeiten und Kontextlänge begrenzt und dienen hauptsächlich als "Zwischenablage" und einmalige Dialogwerkzeuge.Claude Code Diese neue Generation von Werkzeugen ist in der Lage, die gesamte Projektmappe zu verstehen, mit autonomer Planung und Multitasking-Fähigkeiten für komplexe Aufgaben.

Anstatt nur Codeschnipsel zu generieren, können Dateien direkt bearbeitet, Tests ausgeführt, Build-Befehle ausgeführt und sogar Git-Commits bearbeitet werden. Die Rolle des Entwicklers verlagert sich von einem "Ausführenden" von Aufgaben zu einem "Delegierenden" komplexer Projekte und betritt eine sogenannte "Arbeitswelt". VibeCoding(Ambient Programming) - Definition der Anforderungen, Entwurf der Architektur und anschließende Überwachung der KI durch spezifische Programmieraufgaben.

Vollständige Anleitung zur Installation und Konfiguration

Dieses Tutorial verwendet macOS als Beispiel, die Vorgehensweise ist für Windows ähnlich.

Schritt 1: Schnelle Installation

Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist (Version >= 18), und führen Sie dann den folgenden Befehl aus, um es global zu installieren:

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

Nach Abschluss der Installation führen Sie in einem beliebigen Projektverzeichnis aus claude um es zu starten.

# 进入你的项目目录
cd your-awesome-project
# 启动 Claude Code
claude
# 首次使用时，可能会提示登录

Schritt 2: Umgang mit regionalen Beschränkungen und Konfiguration von Inlandsmodellen

Wenn Sie bei Ihrem ersten Lauf die Meldung erhalten, dass eine Region nicht verfügbar ist, können Sie die Umgebungsvariablen so konfigurieren, dass die Anfrage an einen einheimischen Modelldienstleister weitergeleitet wird, der mit dem Anthropic-API-Format kompatibel ist.

Probleme mit regionalen Beschränkungen, die während des ersten Laufs auftreten können

Öffnen Sie die Konfigurationsdatei des Terminals (unter macOS ist dies standardmäßig .zshrc), fügen Sie die folgenden zwei Zeilen hinzu:

# 使用 vi 编辑配置文件。新手提示：打开后按 i 进入插入模式，
# 粘贴内容后按 ESC，然后输入 :wq 回车即可保存退出。
vi ~/.zshrc

Fügen Sie Folgendes in die Datei ein:

export ANTHROPIC_BASE_URL=你的模型调用地址
export ANTHROPIC_API_KEY=你的API密钥

Führen Sie nach dem Speichern und Beenden unbedingt die source ~/.zshrc um die Konfiguration sofort wirksam werden zu lassen.

Konfigurationsbeispiel 1: Modell Smart Spectrum GLM-4.5

1. Registrierung und Beantragung eines API-Schlüssels: ZugangSmart Spectrum AI Offene PlattformAnmelden beiSeite zur API-SchlüsselverwaltungErstellen Sie einen neuen Schlüssel.
   
2. Optionale Pakete (optional)Smart Spectrum bietet Entwicklern eine kostengünstigeProgrammierung von Paketenetwa 20 Dollar für den ersten Monat, mit vielen Anrufen.
   
3. Umgebungsvariablen konfigurierenDie anthropik-kompatible Adresse von Smart Spectrum lautet https://open.bigmodel.cn/api/anthropic.

   export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
   export ANTHROPIC_API_KEY=粘贴你的智谱API密钥
   

4. Gültige Konfiguration und Neustart: Umsetzung source ~/.zshrc Führen Sie danach erneut die claude Befehl.

Konfigurationsbeispiel 2: Modell Dark Side of the Moon Kimi K2

1. Registrierung & Aufstockung: ZugangDark Side of the Moon EntwicklerplattformAnmeldung. Es wird empfohlen, $50 oder mehr aufzuladen, um die Anrufrate zu sichern.
   
2. API-Schlüssel abrufenErstellen Sie einen neuen API-Schlüssel im Backend-Verwaltungssystem.
   
3. Umgebungsvariablen konfigurierenKimi's Anthropic-kompatible Adresse ist https://api.moonshot.cn/anthropic/.

   export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic/
   export ANTHROPIC_API_KEY=粘贴你的KimiAPI密钥
   

4. Gültige Konfiguration und Neustart: Umsetzung source ~/.zshrc Führen Sie danach erneut die claude Befehl.

Schritt 3: Weiterleitung zu einem beliebigen Modell im OpenAI-Format

Um ein Modell zu verwenden, das nur das OpenAI-Format unterstützt (z. B. Tongyi Qianqian), können Sie die ClaudeCodeRouter Middleware, um die Konvertierung durchzuführen.

1. Installieren des Routers::

   npm install -g @musistudio/claude-code-router
   

   Zu seinen Hauptmerkmalen gehören das Modell-Routing, die Unterstützung mehrerer Anbieter und die Anfrage/Antwort-Transformation.

2. Starten der Konfigurationsoberfläche::

   ccr ui
   

   Auf der sich öffnenden Seite fügen Sie den Modellanbieter hinzu, wählen die Vorlage aus und geben den API-Schlüssel und den Modellnamen ein.
   
   

3. Routing konfigurieren::
   Im Routing-Abschnitt auf der rechten Seite verweisen Sie verschiedene Aufgaben (z. B. Denken, langer Kontext) auf das soeben hinzugefügte Modell, speichern und starten Sie neu.
   
4. aktivieren (einen Plan) Claude Code::
   ausnutzen ccr code gestartet wird, kann das konfigurierte Modell über diesen Weg verwendet werden.
   

Schritt 4: Integration in die IDE

Claude Code Verbesserte Plug-ins für VS Code und JetBrains IDE-Familie (IntelliJ IDEA, WebStorm usw.) werden bereitgestellt, die mit einem Klick aus der IDE heraus gestartet werden können, um die Interaktion zu vereinfachen.

Installieren von Plug-ins in der IDE

Start mit einem Tastendruck, nahtlose Integration

Die wichtigsten Tipps zur Nutzung im Detail

Grundlegende Interaktion

• @ NotationVerweis auf eine Datei oder ein Verzeichnis, das dem Kontext hinzugefügt werden soll.
• # NotationDefinition von Erinnerungen oder Regeln, die die KI bei späteren Interaktionen befolgen wird.
• ! Notation: Wechselt vorübergehend in den Bash-Modus, um Shell-Befehle auszuführen.
• ESC Dreh- und AngelpunktUnterbrechung: Unterbricht die aktuell ausgeführte Aufgabe.
• mehrzeilige Eingabe: Verwendung Shift+Enter vielleicht Option+Enter (macOS) Geben Sie mehrzeiligen Text ein. Sie können ausführen /terminal-setup Montage Shift+Enter Abkürzungen.

Vollständige Befehlsliste

Einfuhr / Das Befehlsmenü kann aufgerufen werden, und im Folgenden finden Sie eine vollständige Liste der Befehle:

/add-dir                  添加一个新的工作目录
/agents                   管理代理配置
/bashes                   列出和管理后台任务
/clear (reset, new)       清除对话历史并释放上下文
/compact                  清除对话历史，但在上下文中保留摘要。可选：/compact [摘要说明]
/config (theme)           打开配置面板
/context                  将当前上下文使用情况可视化为彩色网格
/cost                     显示当前会话的总成本和持续时间
/doctor                   诊断并验证您的 Claude Code 安装和设置
/exit (quit)              退出 REPL
/export                   导出当前对话到文件或剪贴板
/feedback (bug)           提交关于 Claude Code 的反馈
/help                     显示帮助和可用命令
/hooks                    管理工具事件的钩子配置
/ide                      管理 IDE 集成并显示状态
/init                     使用代码库文档初始化一个新的 CLAUDE.md 文件
/install-github-app       为代码仓库设置 Claude GitHub Actions
/login                    使用您的 Anthropic 帐户登录
/logout                   从您的 Anthropic 帐户注销
/mcp                      管理 MCP 服务器
/memory                   编辑 Claude 内存文件
/migrate-installer        从全局 npm 安装迁移到本地安装
/model                    设置 Claude Code 的 AI 模型
/output-style             直接或从选择菜单设置输出样式
/output-style:new         创建一个自定义输出样式
/permissions              管理允许和拒绝工具的权限规则
/pr-comments              从 GitHub 拉取请求中获取评论
/release-notes            查看发行说明
/resume                   继续一个对话
/review                   审查一个拉取请求
/security-review          完成对当前分支上待定更改的安全审查
/status                   显示 Claude Code 状态
/statusline               设置 Claude Code 的状态行用户界面
/terminal-setup           安装 Shift+Enter 换行快捷键
/todos                    列出当前的待办事项
/upgrade                  升级到 Max 以获得更高的速率限制
/vim                      在 Vim 和普通编辑模式之间切换

Eingehende Analyse der gängigen Befehle

• /init:: Scannen der Projekterstellung CLAUDE.mdmit Zusammenfassungen des Technologie-Stacks, der Architektur usw., um AI ein schnelles Verständnis des Projekts zu ermöglichen.
• /KompaktZusammenfassen langer Dialogverläufe, um wichtige Informationen zu erhalten, Token zu sparen und die KI zu fokussieren.
• /klarLeeren Sie den aktuellen Dialog vollständig und öffnen Sie einen neuen.
• /Resümee:: Wiederherstellen des Dialogverlaufs und Fortsetzen früherer Aufgaben.
• /SpeicherBearbeiten Sie eine Reihe von Markdown-Dateien, um langfristige Verhaltenspräferenzen (z. B. Codierungsstil, Persönlichkeit) für die KI zu definieren. Diese Dateien befinden sich im Verzeichnis ~/.claude Verzeichnis, unterteilt in globale und Projektebene. Zum Beispiel.rules.md Die Datei kann die folgenden Programmierprinzipien enthalten:

  你的任务是：**审查、理解并迭代式地改进/推进一个[项目类型，例如：现有代码库 / 软件项目 / 技术流程]。**
  在整个工作流程中，你必须内化并严格遵循以下核心编程原则，确保你的每次输出和建议都体现这些理念：
  - **简单至上 (KISS):** 追求代码和设计的极致简洁与直观，避免不必要的复杂性。
  - **精益求精 (YAGNI):** 仅实现当前明确所需的功能，抵制过度设计和不必要的未来特性预留。
  - **坚实基础 (SOLID):**
  - **S (单一职责):** 各组件、类、函数只承担一项明确职责。
  - **O (开放/封闭):** 功能扩展无需修改现有代码。
  - **L (里氏替换):** 子类型可无缝替换其基类型。
  - **I (接口隔离):** 接口应专一，避免"胖接口"。
  - **D (依赖倒置):** 依赖抽象而非具体实现。
  - **杜绝重复 (DRY):** 识别并消除代码或逻辑中的重复模式，提升复用性。
  - **文档同步 (Doc Sync):** 代码变更必须同步更新相关文档，保持一致性。
  **请严格遵循以下工作流程和输出要求：**
  1.  **深入理解与初步分析（理解阶段）：**
      - 详细审阅提供的[资料/代码/项目描述]，全面掌握其当前架构、核心组件、业务逻辑及痛点。
      - 在理解的基础上，初步识别项目中潜在的**KISS, YAGNI, DRY, SOLID**原则应用点或违背现象。
  2.  **明确目标与迭代规划（规划阶段）：**
      - 基于用户需求和对现有项目的理解，清晰定义本次迭代的具体任务范围和可衡量的预期成果。
      - 在规划解决方案时，优先考虑如何通过应用上述原则，实现更简洁、高效和可扩展的改进，而非盲目增加功能。
  

Erweiterte Funktionen: Anpassung und Automatisierung

Benutzerdefinierte Befehle

Kapseln Sie allgemeine komplexe Aufgaben in benutzerdefinierte Befehle. Schreiben Sie einfach eine Markdown-Datei, die die Eingabeaufforderung enthält (der Dateiname ist der Name des Befehls, z. B. add-changelog.md), setzen Sie die ~/.claude/commands/ Verzeichnis, starten Sie neu, und Sie können die /add-changelog Aufruf. Gemeinschaftsstandorte https://www.buildwithclaude.com/ Eine große Anzahl von voreingestellten Befehlen steht zum Download bereit.

System der Unterbeauftragten

Erstellen Sie mehrere dedizierte "Sub-Intelligenzen" (z. B. Frontend-Spezialisten, UX-Designer), und die Hauptintelligenz kann automatisch Aufgaben auf der Grundlage komplexer Anforderungen aufschlüsseln und zuweisen, was eine parallele Zusammenarbeit über mehrere Rollen hinweg ermöglicht.

passieren (eine Rechnung oder Inspektion etc.) /agents Befehlsverwaltung mit der Möglichkeit, neue Agenten mit Hilfe der KI zu erstellen oder Voreinstellungen aus der Community zu importieren.

KI-unterstützte Erstellung von Unteragenten

Bei einer Aufgabe, die ein UI-Design beinhaltet, ruft der intelligente Hauptkörper zuerst den UX-Designer an und kodiert dann, nachdem das Design bestätigt wurde, die KI generiert eine Todo-Liste, wenn die Aufgabe ausgeführt wird, und erledigt sie Punkt für Punkt mit einem sehr transparenten Workflow.

Hakensystem

Löst automatisch Befehle aus, wenn ein bestimmtes Ereignis eintritt (z. B. nachdem eine Datei bearbeitet wurde). Die Befehle werden automatisch durch den /hooks Anweisungsmanagement für automatisierte Prozesse wie automatische Formatierung und Berechtigungskontrolle.

Beispiel: Automatische Formatierung mit Prettier nach Bearbeitung einer TS-Datei

{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|MultiEdit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.ts$'; then npx prettier --write \"$file_path\"; fi; }"
}
]
}
]
}
}

Gemeinschaftsinstrumente claudecode-rule2hook Unterstützung für die Erstellung von Hook-Konfigurationen in natürlicher Sprache.

Konfigurieren des MCP-Servers

MCP (Machine-to-Claude Protocol) ist ein Protokoll, das externen Tools und Diensten die Kommunikation mit dem Claude Code Protokolle für die Kommunikation, die um Funktionen wie die Anbindung an Jira, Notion usw. erweitert werden können.

• Hinzufügen eines lokalen Stdio MCP-Servers:

  claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server
  

• SSE MCP-Server hinzufügen:

  claude mcp add --transport sse linear https://mcp.linear.app/sse
  

• MCP-Server verwalten:

  # 列出所有服务器
  claude mcp list
  # 删除服务器
  claude mcp remove github
  

Tipps zu Stichwörtern und Arbeitsmustern

Tipps zur Strukturierung von XML-Tags

Die Verwendung von XML-Tags zum Einbinden von Anweisungen, Kontext und Beispielen hilft Claude, Ihre Absicht genauer zu verstehen.

<instruction>
你希望 Claude 执行的主要任务或目标
</instruction>
<context>
任务的背景信息，比如涉及的框架、业务逻辑、团队规范等
</context>
<code_example>
可以参考的代码片段、接口规范或已有实现
</code_example>

Drei Betriebsarten schaltbar

ausnutzen Shift+Tab Zyklusschaltung:

1. Normalmodus: Im Standardmodus ist die Zustimmung des Benutzers erforderlich, bevor Vorgänge wie die Bearbeitung von Dateien durchgeführt werden können.
2. Automatischer AkzeptanzmodusAlle Vorgänge werden standardmäßig genehmigt und die KI hat die volle Kontrolle.
3. PlanungsmodusKI: Die KI plant und erstellt lediglich eine Liste von Aufgaben, ohne tatsächliche Operationen durchzuführen.

Weitere nützliche Tools und Ressourcen

• Regressionsgeschichte: Doppelklick ESC Dialogknoten können rückgängig gemacht werden. Für das Rollback von Codeänderungen verwenden Sie das Community-Tool ccundo (npm install -g ccundo).
• Opcode des visuellen Konfigurationstools:: Website https://opcode.sh/ Bietet eine leistungsstarke Webschnittstelle für die Verwaltung der Visualisierung Claude Code Alle Konfigurationen, einschließlich benutzerdefinierter Befehle, Hooks, Berechtigungen usw., der
  
  
• Claude Official Chinese Guide: offizielles Dokument Bietet die umfassendste und verbindlichste Einführung in die Funktionen und Gebrauchsanweisungen.
  

Eine neue Generation von KI-Programmierwerkzeugen verändert die Entwicklungsabläufe und befreit die Entwickler von mühsamen Programmierarbeiten, damit sie sich mehr auf Architekturdesign und geschäftliche Innovationen konzentrieren können. Sie zu beherrschen bedeutet, sich das Entwicklungsparadigma der Zukunft zu eigen zu machen.