Claude Code超详细完整指南附最佳实践（最新版2026年，可接入GLM）

Claude Code 概述

Claude Code 概述 - Claude Code Docs

Claude Code 是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。

Claude Code 是一个由 AI 驱动的编码助手，可以帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

开始使用

终端

macOS, Linux, WSL:

curl-fsSLhttps://claude.ai/install.sh|bash# 不建议以下方式了npminstall-g@anthropic-ai/claude-codenpmuninstall-g@anthropic-ai/claude-code

Windows PowerShell:

irmhttps://claude.ai/install.ps1|iex

当您使用claude命令启动交互式会话

claude

IDE

先安装插件，再运行

/ide

VS Code

• 为 VS Code 安装
• Claude Code for VS Code
  

JetBrains

• Claude Code [Beta] - IntelliJ IDEs Plugin | Marketplace
  

模型概览

模型概览 - Claude API Docs

选择合适的模型

为您的应用选择最佳的 Claude 模型需要在三个关键因素之间取得平衡：能力、速度和成本。本指南帮助您根据具体需求做出明智的决策。

确定关键标准

在选择 Claude 模型时，我们建议首先评估以下因素：

• **能力：**您需要模型具备哪些特定功能或能力来满足您的需求？
• **速度：**模型在您的应用中需要多快的响应速度？
• **成本：**您在开发和生产使用方面的预算是多少？

模型选择矩阵

模型设置接入GLM

安装 Claude Code Router

npminstall-g@musistudio/claude-code-router

创建并配置您的 ~/.claude-code-router/config.json 文件。

{ "LOG": false, "LOG_LEVEL": "debug", "CLAUDE_PATH": "", "HOST": "127.0.0.1", "PORT": 3456, "APIKEY": "", "API_TIMEOUT_MS": "600000", "PROXY_URL": "", "transformers": [], "Providers": [ { "name": "claude", "api_base_url": "", "api_key": "", "models": [ "aws-claude-opus-4-5", "aws-claude-opus-4-6", "aws-claude-sonnet-4-5", "aws-claude-sonnet-4-6", "glm-4_7", "glm5" ], "transformer": { "use": [ "openrouter" ] } } ], "StatusLine": { "enabled": false, "currentStyle": "default", "default": { "modules": [] }, "powerline": { "modules": [] } }, "Router": { "default": "claude,aws-claude-opus-4-6", "background": "claude,aws-claude-opus-4-6", "think": "claude,aws-claude-opus-4-6", "longContext": "claude,aws-claude-opus-4-6", "longContextThreshold": 200000, "webSearch": "claude,aws-claude-opus-4-6", "image": "claude,aws-claude-opus-4-6" }, "CUSTOM_ROUTER_PATH": "~/.claude-code-router" }

用路由器运行 Claude Code

ccr code

切换模型

/model claude,aws-claude-opus-4-6 /model claude,glm5 /model litellm,aws-claude-opus-4-6 /model litellm,glm5 /model 智谱,glm-4.7 /model 智谱,glm-5

UI 模式

ccr ui

最佳实践

Claude Code 最佳实践 - Claude Code Docs

编写有效的 CLAUDE.md

运行/init根据你的当前项目结构生成启动 CLAUDE.md 文件，然后随时间精化。

CLAUDE.md 是一个特殊文件，Claude 在每次对话开始时读取。包括 Bash 命令、代码风格和工作流规则。这给 Claude 提供了它无法从代码中推断的持久上下文。/init命令分析你的代码库以检测构建系统、测试框架和代码模式，为你提供坚实的基础来精化。CLAUDE.md 文件没有必需的格式，但保持简短和易读。例如：

CLAUDE.md

# Code style - Use ES modules (import/export) syntax, not CommonJS (require) - Destructure imports when possible (eg. import { foo } from 'bar') # Workflow - Be sure to typecheck when you're done making a series of code changes - Prefer running single tests, and not the whole test suite, for performance

CLAUDE.md 在每个会话中加载，所以只包括广泛适用的东西。对于仅有时相关的域知识或工作流，改用 skills。Claude 按需加载它们，不会使每次对话都膨胀。保持简洁。对于每一行，问自己：“删除这个会导致 Claude 犯错吗？”如果不会，删除它。膨胀的 CLAUDE.md 文件会导致 Claude 忽略你的实际指令！

如果 Claude 继续做你不想要的事情，尽管有反对的规则，该文件可能太长，规则被遗漏了。如果 Claude 问你在 CLAUDE.md 中回答的问题，措辞可能不明确。像对待代码一样对待 CLAUDE.md：当事情出错时审查它，定期修剪它，并通过观察 Claude 的行为是否实际改变来测试更改。你可以通过添加强调（例如”IMPORTANT”或”YOU MUST”）来调整指令以改进遵守。将文件检入 git，以便你的团队可以贡献。该文件随时间增加价值。CLAUDE.md 文件可以使用@path/to/import语法导入其他文件：

CLAUDE.md

See @README.md for project overview and @package.json for available npm commands. # Additional Instructions - Git workflow: @docs/git-instructions.md - Personal overrides: @~/.claude/my-project-instructions.md

你可以在多个位置放置 CLAUDE.md 文件：

• 主文件夹（~/.claude/CLAUDE.md）：适用于所有 Claude 会话
• 项目根目录（./CLAUDE.md）：检入 git 以与你的团队共享
• 父目录：对于 monorepos 有用，其中root/CLAUDE.md和root/foo/CLAUDE.md都会自动拉入
• 子目录：当处理这些目录中的文件时，Claude 按需拉入子 CLAUDE.md 文件
• CLAUDE.local.md 是一个本地的 CLAUDE.md 文件，用于存储您的个人偏好和指令，不会被签入版本控制。

配置权限

使用/permissions来允许列表安全命令或/sandbox用于操作系统级隔离。这减少了中断，同时让你保持控制。

默认情况下，Claude Code 请求可能修改你的系统的操作的权限：文件写入、Bash 命令、MCP 工具等。这是安全的但繁琐。在第十次批准后，你不是真的在审查，你只是点击通过。有两种方式来减少这些中断：

• 权限允许列表：允许你知道是安全的特定工具（如npm run lint或git commit）
• 沙箱：启用操作系统级隔离，限制文件系统和网络访问，允许 Claude 在定义的边界内更自由地工作

或者，使用--dangerously-skip-permissions来绕过所有权限检查，用于包含的工作流，如修复 lint 错误或生成样板。

让 Claude 运行任意命令可能导致数据丢失、系统损坏或通过提示注入进行数据渗透。仅在没有互联网访问的沙箱中使用--dangerously-skip-permissions。

关于 配置权限 和 启用沙箱。

你可以在这个位置找到该配置文件：.claude/settings.local.json

使用 CLI 工具

告诉 Claude Code 在与外部服务交互时使用 CLI 工具，如gh、aws、gcloud和sentry-cli。

CLI 工具是与外部服务交互的最 context 高效的方式。如果你使用 GitHub，安装ghCLI。Claude 知道如何使用它来创建问题、打开拉取请求和读取评论。没有gh，Claude 仍然可以使用 GitHub API，但未认证的请求经常会触发速率限制。Claude 也有效地学习它不知道的 CLI 工具。尝试像Use 'foo-cli-tool --help' to learn about foo tool, then use it to solve A, B, C.这样的提示。

连接 MCP 服务器

运行claude mcp add来连接外部工具，如 Notion、Figma 或你的数据库。

使用 MCP servers，你可以要求 Claude 从问题跟踪器实现功能、查询数据库、分析监控数据、集成来自 Figma 的设计并自动化工作流。

Sentry

Search, query, and debug errors intelligentlyCommand

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

GitHub - microsoft/playwright-mcp: Playwright MCP server

claude mcpaddplaywright npx @playwright/mcp@latest

创建 skills

Agent Skills - Claude API Docs
Agent Skills 是扩展 Claude 功能的模块化能力。每个 Skill 包含指令、元数据和可选资源（脚本、模板），Claude 在相关时会自动使用这些资源。

为什么使用 Skills

Skills 是可重用的、基于文件系统的资源，为 Claude 提供特定领域的专业知识：工作流、上下文和最佳实践，将通用代理转变为专家。与提示不同（提示是对话级别的一次性任务指令），Skills 按需加载，无需在多个对话中重复提供相同的指导。

主要优势：

• 专业化 Claude：为特定领域的任务定制功能
• 减少重复：创建一次，自动使用
• 组合功能：结合 Skills 构建复杂工作流

Skills 如何工作

Skill 结构

每个 Skill 都需要一个带有 YAML 前置数据的SKILL.md文件：

--- name: your-skill-name description: 简要描述此 Skill 的功能以及何时使用它 --- # 您的 Skill 名称 ## 指令 [Claude 要遵循的清晰、分步指导] ## 示例 [使用此 Skill 的具体示例]

必需字段：name和description

字段要求：

name：

• 最多 64 个字符
• 只能包含小写字母、数字和连字符
• 不能包含 XML 标签
• 不能包含保留字：「anthropic」、「claude」

description：

• 必须非空
• 最多 1024 个字符
• 不能包含 XML 标签

description应包括 Skill 的功能以及 Claude 何时应使用它。有关完整的创作指导，请参阅最佳实践指南。

示例

在.claude/skills/中创建SKILL.md文件，为 Claude 提供域知识和可重用工作流。

Skills 使用特定于你的项目、团队或域的信息扩展 Claude 的知识。Claude 在相关时自动应用它们，或者你可以使用/skill-name直接调用它们。通过向.claude/skills/添加带有SKILL.md的目录来创建 skill：

.claude/skills/api-conventions/SKILL.md

--- name: api-conventions description: REST API design conventions for our services --- # API Conventions - Use kebab-case for URL paths - Use camelCase for JSON properties - Always include pagination for list endpoints - Version APIs in the URL path (/v1/, /v2/)

Skills 也可以定义你直接调用的可重复工作流：

.claude/skills/fix-issue/SKILL.md

--- name: fix-issue description: Fix a GitHub issue disable-model-invocation: true --- Analyze and fix the GitHub issue: $ARGUMENTS. 1. Use `gh issue view` to get the issue details 2. Understand the problem described in the issue 3. Search the codebase for relevant files 4. Implement the necessary changes to fix the issue 5. Write and run tests to verify the fix 6. Ensure code passes linting and type checking 7. Create a descriptive commit message 8. Push and create a PR

运行/fix-issue 1234来调用它。对于具有你想手动触发的副作用的工作流，使用disable-model-invocation: true。

设置 hooks

使用 hooks 来处理必须每次发生且没有例外的操作。

Hooks 在 Claude 工作流中的特定点自动运行脚本。与 CLAUDE.md 指令不同，hooks 是确定性的，保证操作发生。Claude 可以为你编写 hooks。尝试像“编写一个在每次文件编辑后运行 eslint 的 hook”或“编写一个阻止写入迁移文件夹的 hook”这样的提示。运行/hooks进行交互式配置，或直接编辑.claude/settings.json。

创建自定义 subagents

在.claude/agents/中定义专门的助手，Claude 可以委托给它们来处理隔离的任务。

Subagents 在自己的 context 中运行，拥有自己的一组允许的工具。它们对于读取许多文件或需要专门关注而不会使你的主对话混乱的任务很有用。

.claude/agents/security-reviewer.md

--- name: security-reviewer description: Reviews code for security vulnerabilities tools: Read, Grep, Glob, Bash model: opus --- You are a senior security engineer. Review code for: - Injection vulnerabilities (SQL, XSS, command injection) - Authentication and authorization flaws - Secrets or credentials in code - Insecure data handling Provide specific line references and suggested fixes.

明确告诉 Claude 使用 subagents：“使用 subagent 来审查此代码的安全问题。“

安装 plugins

运行/plugin来浏览市场。Plugins 添加 skills、工具和集成，无需配置。

Plugins 将 skills、hooks、subagents 和 MCP 服务器捆绑到来自社区和 Anthropic 的单个可安装单元中。如果你使用类型化语言，安装 代码智能 plugin 来为 Claude 提供精确的符号导航和编辑后的自动错误检测。有关在 skills、subagents、hooks 和 MCP 之间选择的指导，请参阅 扩展 Claude Code。

管理你的会话

对话是持久的和可逆的。利用这一点！

尽早且经常改正方向

一旦你注意到 Claude 偏离轨道，立即改正它。

最好的结果来自紧密的反馈循环。虽然 Claude 有时会在第一次尝试时完美地解决问题，但快速改正它通常会更快地产生更好的解决方案。

• Esc：使用Esc键在中途停止 Claude。Context 被保留，所以你可以重定向。
• Esc + Esc或/rewind：按Esc两次或运行/rewind来打开 rewind 菜单并恢复之前的对话和代码状态，或从选定的消息进行总结。
• "撤销那个"：让 Claude 恢复其更改。
• /clear：在不相关的任务之间重置 context。长会话与无关的 context 可能会降低性能。

如果你在一个会话中对同一问题改正了 Claude 两次以上，context 就充满了失败的方法。运行/clear并使用更具体的提示重新开始，该提示包含你学到的东西。干净的会话与更好的提示几乎总是优于长会话与累积的改正。

恢复对话

运行claude --continue来继续你离开的地方，或--resume来从最近的会话中选择。

Claude Code 在本地保存对话。当任务跨越多个会话时，你不必重新解释 context：

claude --continue # Resume the most recent conversation claude --resume # Select from recent conversations

使用/rename给会话起描述性名称，如"oauth-migration"或"debugging-memory-leak"，以便你稍后可以找到它们。像对待分支一样对待会话：不同的工作流可以有单独的、持久的 context。

值得试一试

Anthropic《Claude Code 高度主动式编程助手|Claude Code A Highly Agentic Coding Assistant》中英_哔哩哔哩_bilibili

（比刷剧爽！）2026公认最好的《Claude Code》教程，附课件代码—Claude Code探索-测试-重构-调试代码库_哔哩哔哩_bilibili

make a cool visualization for me i am just getting started 给我做一个酷炫的可视化，我刚开始学 open it in the browse 在浏览器中打开它

give me an overview of the codebase 给我一个代码库的概述 how are these documents processed 这些文件是如何处理的？ trace the process of handing a user's query from frontend to backend 追踪用户查询从前端到后端处理的过程 draw a diagram that illustrates this flow 画一个图来展示这个流程

# always use uv to run the server do not use pip directly # 始终使用 uv 来运行服务器，不要直接使用 pip

CLI 标志

# 加载当前目录中最近的对话claude--continue

# 按 ID 或名称恢复特定会话，或显示交互式选择器以选择会话claude--resume

使用这些命令行标志自定义 Claude Code 的行为：

交互模式

交互模式 - Claude Code Docs