claude-code-guide

从入门到精通 Claude Code，一份指南全搞定

这是一个关于 Claude Code 的全面指南仓库，旨在帮助用户从新手成长为高级用户。它系统性地整理了 Claude Code 的安装配置、常用命令、工作流设计、Agent 开发、技能定制以及实用技巧。项目以文档为主，覆盖了从基础操作到复杂自动化场景的完整知识体系，解决了官方文档分散、社区经验碎片化的问题，为开发者提供了一站式的学习路径和速查手册。核心能力包括结构化的教程目录、可复用的工作流模板、Agent 与技能开发示例，以及大量实战中的 tips-and-tricks。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4631

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队zebbern

所属国家

官网地址

GitHubhttps://github.com/zebbern/claude-code-guide

定价模式free

价格说明开源指南，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,ai-agent,ai-agent-tools,anthropic-claude,claude,claude-ai,claude-api,claude-code,claude-code-communication,claude-code-guide,claude-code-skills,claude-commands,claude-desktop,claude-mcp,claude-sonnet,code,mcp,mcp-agents,mcp-tools,vscode-extension

GitHub 星标★ 4631

30天Star增速

HF 下载量

上线时间2025-06-21 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

Node.js 22 或更新版本（Claude Code v2.1.198 及以后要求）
一个可登录的 Anthropic 账号（用于 claude auth login）
macOS/Linux 上的 Homebrew 或 Windows 上的 WinGet（可选，用于包管理器安装与更新）
若接入远程 HTTP MCP 服务器，需能访问对应服务 URL 并完成 OAuth

安装与启动步骤

1确认运行环境

先确认本机满足版本要求：Claude Code v2.1.198 及之后需要 Node.js 22 或更高；用 Homebrew/WinGet 安装的则通过各自包管理器更新。
2安装原生命令行版本

在已存在的安装上运行此命令，会安装/重装 stable 通道的原生二进制。注意：从 npm 安装版本执行会被替换为原生构建。
```
claude install stable
```
3登录 Anthropic 账号

通过 CLI 直接完成认证，无需进入 REPL 交互界面。按提示在浏览器完成授权。
```
claude auth login
```
4检查安装与认证状态

用 auth status 查看当前登录状态，用 doctor 诊断安装、版本与整体配置问题，出问题先看它的输出。
```
claude auth status
claude doctor
```
5更新与诊断

手动更新 Claude Code 到最新版本；日常排查安装或版本异常时也使用 doctor。
```
claude update
```
6试跑无头查询

用 Plan 权限模式执行一次性任务，验证命令可用。注意 --bg 不能与 -p 组合使用。
```
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"
```
7设为默认 Plan 模式

编辑项目内 .claude/settings.json，把默认权限模式改为 plan；配置文件改动通常会被文件监视器自动拾取。
8接入 MCP 与后台任务

远程 HTTP 服务器需先 add 再 login 完成 OAuth；之后在会话中打开 /mcp 批准或重连服务器。
```
claude mcp add --transport http -s user sentry https://mcp.sentry.dev/mcp
claude mcp login sentry
```

关键配置

配置项	必填	说明	示例
`permissions.defaultMode`	否	在 .claude/settings.json 中把默认权限模式设为 plan	`plan`
`mcpServers..type`	是	MCP 服务器传输类型，本地进程用 stdio，远程用 http	`stdio`
`mcpServers..command`	否	stdio 类型服务器要执行的绝对路径命令	`/absolute/path/to/mcp-server`
`mcpServers..args`	否	传给 MCP 服务器命令的参数数组	`["--workspace", "/path/to/project"]`
`mcpServers..url`	否	http 类型 MCP 服务器的远程地址	`https://mcp.example.com/mcp`

如何确认成功

执行 claude doctor 无报错，且 claude auth status 显示已登录；能正常跑通一次 -p 无头查询即算成功。

常见问题

Q：Claude Code 对 Node.js 版本有什么要求？

A：v2.1.198 及以后版本要求 Node.js 22 或更新；npm 安装方式仍被支持以保持兼容，但不再是首选。

Q：npm 安装和原生安装可以互相切换吗？

A：可以在已有的 npm 安装上运行 claude install，它会替换为原生构建；旧的 migrate-installer 命令已经移除。

Q：Homebrew 或 WinGet 安装的怎么更新？

A：这两类安装通过各自的包管理器更新，而不是依赖 claude update 命令。

Q：怎么添加 MCP 服务器？

A：优先用 claude mcp add，它会写入正确的 scope 与 transport；远程 HTTP 服务器还需要额外执行 claude mcp login 完成 OAuth。

Q：直接改配置文件后需要重启吗？

A：项目 .mcp.json 的改动会被监视，通常无需完整重启；但 /hooks 只是合并配置的只读浏览器，要改的是源配置、插件、技能或代理文件。

注意事项

本仓库是文档型指南仓库，不提供 Claude Code 命令行工具本身的安装包，命令安装需按官方 setup 指南进行。
命令与厂商模型映射变化很快，README 中链接的官方参考始终是权威来源。
项目级子代理 hooks 只有在提供该代理定义的工作区被信任后才会运行。
hook 默认超时为 command/http/mcp_tool 600 秒、prompt 30 秒、agent 60 秒，超时不会取消其他并行 handler。

核心亮点

内容体系完整，覆盖安装、命令、工作流、Agent 开发等全链路
提供大量实战技巧和最佳实践，直接提升开发效率
结构清晰，适合新手快速上手和高级用户深度查阅

不足之处

文档/社区待观察
内容更新依赖社区贡献，可能滞后于 Claude Code 官方迭代

适用场景

快速掌握 Claude Code 基础操作和命令
设计复杂自动化工作流和自定义 Agent
作为日常开发中的速查手册和灵感来源

替代项目

anthropics/claude-code、awesome-claude-code、claude-code-tips

项目介绍

claude-code-guide 是智能体领域的开源项目，由 zebbern 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（4,631）位列前 10%，在智能体分类的 2,517 个项目里位列前 10%。

近 41 天，它的 GitHub 星标从 4,559 增加到 4,631，净增 72。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。开源指南，完全免费，无付费版本。

它主要面向的使用场景是：快速掌握ClaudeCode基础操作和命令。同类可对比的替代方案包括 anthropics/claude-code、awesome-claude-code、claude-code-tips。

上一篇：EvoScientist

下一篇：agenta