ClaudeCode新手入门全指南

Aetik

728人浏览 · 2026-05-21 11:22:28

Aetik · 2026-05-21 11:22:28 发布

Claude Code 新手入门全指南

基于 Claude Code 官方文档整理，以模块化方式呈现，逻辑清晰、关系明确。

1. 概述：Claude Code 是什么

Claude Code 是 Anthropic 推出的代理式编码工具（Agentic Coding Tool）。它不是普通的聊天机器人——它能：

能力	说明
读取代码库	理解整个项目的结构、文件和依赖关系
编辑文件	跨多个文件进行修改，自动保持一致性
运行命令	执行构建、测试、Git 操作等终端命令
自主推理	分解复杂任务、选择工具、验证结果
集成开发工具	与 Git、CI/CD、IDE、Slack 等深度集成

核心区别：传统代码助手只能看到当前文件，Claude Code 能看到你的整个项目，并能自主执行多步骤任务。

可用界面一览

界面	特点	适合场景
终端 CLI	功能最全、可脚本化	日常开发、CI/CD 自动化
VS Code 扩展	内联差异、@-提及、计划审查	IDE 内编码
桌面应用	可视化差异、多会话管理、定时任务	需要 GUI 的工作流
Web 版	云端运行、无需本地环境	远程仓库、移动办公
JetBrains 插件	交互式差异查看	JetBrains IDE 用户
Slack 集成	在聊天中委派编码任务	团队协作

2. 环境与界面选择

选择决策树

我需要什么？
├── 本地日常开发 → 终端 CLI 或 VS Code 扩展
├── 可视化差异审查 → 桌面应用
├── 无本地环境/移动办公 → Web 版 (claude.ai/code)
├── 从手机继续本地会话 → Remote Control
├── CI/CD 自动化 → GitHub Actions / GitLab CI
├── 团队聊天触发 → Slack 集成
└── 定时任务 → Routines 或桌面计划任务

账户要求

需要以下之一：

Claude 订阅（Pro / Max / Team / Enterprise）— 推荐
Claude Console 账户（API 预付费）
企业云提供商：Amazon Bedrock / Google Vertex AI / Microsoft Foundry

3. 安装与登录

终端 CLI 安装

方式	命令	自动更新
原生安装（推荐）	macOS/Linux/WSL: `curl -fsSL https://claude.ai/install.sh \| bash`	✅ 是
	Windows PowerShell: `irm https://claude.ai/install.ps1 \| iex`	✅ 是
	Windows CMD: `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`	✅ 是
Homebrew	`brew install --cask claude-code`	❌ 需手动 `brew upgrade`
WinGet	`winget install Anthropic.ClaudeCode`	❌ 需手动 `winget upgrade`

Windows 用户注意：建议安装 Git for Windows，Claude Code 可借此使用 Bash 工具。WSL 环境无需额外安装。

VS Code 扩展安装

在扩展市场搜索 “Claude Code”，或从 VS Code Marketplace 安装。快捷键 Cmd+Shift+P（Mac）/ Ctrl+Shift+P（Windows），输入 “Claude Code” 打开。

4. 第一个会话

启动

cd /path/to/your/project
claude

进入后会看到欢迎界面，显示会话信息、最近对话和最新更新。

第一个问题

从探索代码库开始：

"这个项目做什么？"
"这个项目使用什么技术？"
"主入口点在哪里？"
"解释文件夹结构"

Claude 会自动读取项目文件来回答，你不需要手动添加上下文。

第一次代码更改

"在主文件中添加一个 hello world 函数"

Claude 会：

找到适当的文件
显示建议的更改
请求你的批准
执行编辑

Claude Code 在修改文件前始终请求许可（取决于权限模式）。

第一次 Git 操作

"我更改了哪些文件？"
"用描述性消息提交我的更改"
"创建一个名为 feature/my-feature 的新分支"
"显示我最后的 5 次提交"

基本命令速查

命令	功能
`claude`	启动交互模式
`claude "task"`	运行一次性任务
`claude -p "query"`	运行一次性查询后退出
`claude -c`	继续最近对话
`claude -r`	恢复之前的对话
`/clear`	清除对话历史
`/help`	显示可用命令
`exit` 或 `Ctrl+D`	退出 Claude Code

5. 核心概念：代理循环

三阶段循环

Claude Code 的工作方式是一个代理循环（Agent Loop），包含三个阶段：

收集上下文 → 采取行动 → 验证结果
    ↑                        ↓
    └────—— 根据反馈调整 ←————┘

阶段	说明	示例
收集上下文	搜索文件、读取代码、理解项目	运行测试查看失败信息，读取错误输出
采取行动	编辑文件、运行命令	修改源文件修复 bug
验证结果	检查工作是否正确	再次运行测试确认通过

循环会根据任务自动调整：

代码库问题 → 可能只需收集上下文
Bug 修复 → 多次循环全部三个阶段
重构 → 可能需要广泛验证

你也是这个循环的一部分：可以在任何时刻用 Esc 中断，引导 Claude 调整方向。

两大驱动组件

模型（Model）          →  进行推理，理解代码，决定做什么
工具（Tools）          →  采取行动，读取/编辑/运行/搜索
Claude Code（框架）    →  提供工具、上下文管理、执行环境

可用模型：

Sonnet — 处理大多数编码任务（速度快、成本低）
Opus — 复杂架构决策（推理更强）

使用 /model 在会话中切换，或用 claude --model <name> 启动。

Claude 能访问什么

资源	范围
项目文件	当前目录及子目录（经许可可访问外部）
终端命令	任何你能运行的命令
Git 状态	当前分支、未提交更改、提交历史
CLAUDE.md	项目中持久化的指令和约定
自动记忆	Claude 自动保存的学习内容
扩展	MCP 服务器、Skills、Subagents 等

6. 工具系统

工具是 Claude Code 能够采取行动的关键。没有工具，Claude 只能用文本回复；有了工具，它可以读取代码、编辑文件、运行命令。

五大类内置工具

类别	Claude 可以做什么	工具示例
文件操作	读取文件、编辑代码、创建新文件、重命名	Read, Write, Edit
搜索	按模式查找文件、正则搜索内容	Glob, Grep
执行	运行 shell 命令、测试、git 操作	Bash
网络	搜索网络、获取文档	WebSearch, WebFetch
代码智能	类型检查、跳转定义、查找引用	需要代码智能插件

工具使用示例

当你对 Claude 说 “修复失败的测试” 时，它会自动：

运行测试套件 → 查看失败内容
读取错误输出
搜索相关源文件
读取文件理解代码
编辑文件修复问题
再次运行测试验证

每个工具使用都给 Claude 新的信息，告知下一步决策。

7. 上下文窗口管理

什么是上下文窗口

上下文窗口保存：

对话历史（每条消息、每个工具使用）
文件内容
命令输出
CLAUDE.md 内容
自动记忆
加载的 Skills
系统指令

核心约束：上下文窗口填满 → LLM 性能下降 → Claude 可能"遗忘"早期指令。

自动压缩（Compaction）

Claude Code 在接近上下文限制时自动管理：

首先清除较旧的工具输出
然后总结对话历史
保留：你的请求、关键代码片段
可能丢失：早期对话中的详细指令

因此：将持久规则放在 CLAUDE.md 中，而不是依赖对话历史。

手动管理上下文的三种方式

方式	命令	使用时机
完全重置	`/clear`	在不相关的任务之间
定向压缩	`/compact focus on the API changes`	保留特定上下文
部分压缩	`Esc+Esc` → 选择消息检查点 → 总结	压缩部分对话
检查上下文	`/context`	查看什么在占用空间

Skills 和 Subagents 的上下文优势

Skills：按需加载，只在被调用时才将完整内容加载到上下文
Subagents：获得独立的全新上下文，不影响主对话，完成后返回摘要

8. 配置体系

Claude Code 的配置分为三层：

组织层（托管策略）→ 用户层（~/.claude/）→ 项目层（./.claude/）
  范围最广                                范围最具体

8.1 CLAUDE.md — 持久指令

CLAUDE.md 是一个 Markdown 文件，Claude 在每个会话开始时读取。用它来设置：编码标准、架构决策、首选库、审查清单。

文件位置与范围

位置	范围	用途
托管策略位置	组织中所有用户	公司编码标准、安全策略
`~/.claude/CLAUDE.md`	你的所有项目	个人偏好
`./CLAUDE.md` 或 `./.claude/CLAUDE.md`	当前项目	团队共享的指令
`./CLAUDE.local.md`	仅你（当前项目）	个人项目特定偏好（加入 .gitignore）
父目录	从工作目录向上遍历	Monorepo 中使用

编写原则

✅ 包括：
- Claude 无法猜测的 Bash 命令
- 与默认值不同的代码风格规则
- 测试指令和首选测试运行器
- 存储库礼仪（分支命名、PR 约定）
- 特定于项目的架构决策
- 开发者环境怪癖

❌ 排除：
- Claude 可通过代码弄清楚的
- 标准语言约定
- 详细的 API 文档（改为链接）
- 经常变化的信息
- 长解释或教程
- "编写干净的代码"之类的自明实践

大小建议：目标在 200 行以下，过长的文件消耗上下文并降低遵守度。

示例 CLAUDE.md

# 构建与测试
- 使用 `pnpm`，不是 `npm` 或 `yarn`
- 构建命令: `pnpm build`
- 测试命令: `pnpm test -- --run`（单次运行，非 watch 模式）

# 代码风格
- 使用 ES modules (import/export)，不是 CommonJS (require)
- 尽可能解构导入: `import { foo } from 'bar'`
- 使用 2 空格缩进

# 工作流
- 完成一系列代码更改后运行类型检查
- 优先运行单个测试，不要为性能运行整个测试套件
- 提交前运行 `pnpm lint`

# 压缩指令
压缩时始终保留已修改文件的完整列表和测试命令。

导入其他文件

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

使用 `/init` 自动生成

运行 /init，Claude 分析代码库并自动生成包含构建命令、测试指令和项目约定的 CLAUDE.md。如果已存在，会建议改进而非覆盖。

8.2 自动记忆

自动记忆让 Claude 跨会话自动积累知识，无需你手动编写。Claude 会自己保存：

构建命令
调试见解
架构笔记
代码样式偏好
工作流习惯

存储位置：~/.claude/projects/<project>/memory/

查看和管理：使用 /memory 命令浏览、编辑或删除记忆文件。

启用/禁用：

{ "autoMemoryEnabled": false }

或设置环境变量 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1。

CLAUDE.md vs 自动记忆：你用 CLAUDE.md 编写规则和指令；Claude 用自动记忆记录它学到的模式和偏好。

8.3 设置文件 (settings.json)

Claude Code 通过多层 settings.json 进行配置：

层级	路径	用途
托管策略	组织配置路径	IT/DevOps 管理的强制设置
用户设置	`~/.claude/settings.json`	你的全局偏好
项目设置	`./.claude/settings.json`	团队共享的项目配置
本地设置	`./.claude/settings.local.json`	个人项目配置（不提交）

常用设置示例

{
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(git status)", "Bash(git diff)"]
  },
  "autoMemoryEnabled": true,
  "claudeMdExcludes": ["**/other-team/CLAUDE.md"]
}

8.4 规则系统 (.claude/rules/)

对于大型项目，将指令组织到 .claude/rules/ 目录的多个文件中：

your-project/
├── .claude/
│   ├── CLAUDE.md
│   └── rules/
│       ├── code-style.md      # 代码样式指南
│       ├── testing.md         # 测试约定
│       ├── security.md        # 安全要求
│       └── frontend/
│           └── components.md  # 前端组件规范

路径范围限定

使用 YAML frontmatter 将规则限定到特定文件：

---
paths:
  - "src/api/**/*.ts"
---
# API 开发规则
- 所有 API 端点必须包括输入验证
- 使用标准错误响应格式

9. 扩展系统

扩展能力对比

机制	用途	何时使用
Skills	可复用工作流、领域知识	团队共享的工作流、特定场景的指令
Hooks	自动化触发器	必须每次发生且无例外的操作（如格式化、lint）
MCP	连接外部工具	集成 Notion、Figma、数据库、Jira 等
Subagents	隔离的专门任务	需要独立上下文的任务（如安全审查）
Plugins	打包的扩展组合	社区分享的功能包

9.1 Skills — 可复用工作流

Skills 将特定于项目、团队或领域的知识和可重复工作流打包。

创建 Skill

在 .claude/skills/ 下创建 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
3. Search the codebase for relevant files
4. Implement the necessary changes
5. Write and run tests to verify
6. Create a descriptive commit message
7. Push and create a PR

调用：/fix-issue 1234

disable-model-invocation: true 用于具有副作用、需手动触发的工作流。

9.2 Hooks — 自动化触发器

Hooks 在 Claude Code 工作流中的特定事件点自动运行 shell 脚本。与 CLAUDE.md 指令不同，hooks 是确定性的——保证操作发生。

常见 Hook 事件

事件	触发点
`PreToolUse`	工具使用前
`PostToolUse`	工具使用后
`Notification`	Claude 需要输入时
`Stop`	Claude 完成响应时
`PreCompact`	压缩前
`SessionStart`	会话启动时

示例：每次文件编辑后运行 ESLint

在 .claude/settings.json 中：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "command": "npx eslint --fix ${CLAUDE_TOOL_INPUT_FILE_PATH}"
      }
    ]
  }
}

9.3 MCP — 外部工具连接

Model Context Protocol (MCP) 是一个开放标准，用于将 AI 工具连接到外部数据源。

通过 MCP，Claude Code 可以：

读取 Google Drive 中的设计文档
更新 Jira 中的工单
从 Slack 拉取数据
查询数据库
集成 Figma 设计
使用你自己的自定义工具

添加 MCP 服务器

claude mcp add <name> <command>

或通过 /mcp 命令在会话中管理。

9.4 Subagents — 子代理委派

Subagents 在自己的独立上下文中运行，拥有自己的工具集。适合需要专门关注的任务。

创建 Subagent

在 .claude/agents/ 下创建配置：

---
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.

使用方式："use subagent to review this code for security issues"

9.5 Plugins — 插件市场

Plugins 将 skills、hooks、subagents 和 MCP 服务器捆绑为可安装单元。

运行 /plugin 浏览市场，一键安装社区和 Anthropic 提供的插件包。

10. 权限与安全

权限模式

按 Shift+Tab 循环切换：

模式	行为	适用场景
默认	文件编辑和 shell 命令需批准	日常使用
自动接受编辑	编辑文件和常见文件系统命令不询问，其他命令仍需批准	信任当前任务时
Plan Mode	仅使用只读工具，不进行更改	研究和分析
Auto Mode	后台安全检查评估操作，分类器自动审批	完全自主运行（研究预览）

允许特定命令

在 .claude/settings.json 中允许列表常用安全命令：

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(git log *)"
    ]
  }
}

检查点（Checkpoints）

每次文件编辑前，Claude 会自动创建快照。如果出现问题：

按 Esc 两次 — 打开回退菜单
或说 “撤销那个”
或运行 /rewind

检查点是会话本地的，独立于 Git。仅涵盖文件更改，不涵盖外部副作用（数据库、API、部署）。

沙箱

启用操作系统级隔离，限制文件系统和网络访问：

{
  "sandbox": {
    "enabled": true
  }
}

11. 日常工作流

探索代码库

"这个项目做什么？"
"日志如何工作？"
"我如何创建新的 API 端点？"
"foo.rs 第 134 行的 async move { ... } 做什么？"
"CustomerOnboardingFlowImpl 处理哪些边界情况？"

Bug 修复

"用户注册表单有 bug，可以提交空表单 - 修复它"

# 更具体的版本：
"用户报告会话超时后登录失败。
 检查 src/auth/ 中的认证流程，特别是 token 刷新。
 编写一个失败的测试来重现问题，然后修复它。"

功能实现

"添加用户注册表单的输入验证"

# 更好的版本：
"实现 validateEmail 函数。
 测试用例：'user@example.com' → true，'invalid' → false。
 实现后运行测试。"

重构

"重构身份验证模块以使用 async/await 而不是回调"

编写测试

"为计算器函数编写单元测试"

代码审查

"审查我的更改并建议改进"

Git 操作

"用描述性消息提交我的更改"
"创建一个名为 feature/oauth 的新分支"
"帮我解决合并冲突"

文档更新

"使用安装说明更新 README"

12. 最佳实践

黄金法则

给 Claude 验证自己的方式 — 提供测试用例、屏幕截图或预期输出
先探索，再规划，最后编码 — 使用 Plan Mode 先研究，后实现
提示具体明确 — 指定文件、约束和示例模式
委派，不要微管理 — 描述目标，让 Claude 决定如何达成
经常清理上下文 — 不相关任务之间 /clear

四阶段工作流

1. 探索（Plan Mode）
   "read /src/auth and understand how we handle sessions"

2. 规划（Plan Mode）
   "I want to add Google OAuth. What files need to change? Create a plan."

3. 实现（默认模式）
   "implement the OAuth flow from your plan. write tests and run them."

4. 提交（默认模式）
   "commit with a descriptive message and open a PR"

提示对比：差 vs 好

差的提示	好的提示
“修复错误”	“修复登录错误，用户输入错误凭证后看到空白屏幕”
“添加测试”	“为 foo.py 编写测试，涵盖用户已注销的边界情况。避免 mock”
“添加日历小部件”	“查看 HotDogWidget.php 的实现模式，按照该模式实现日历小部件”
“让仪表板更好看”	“[粘贴截图] 实现此设计。截图结果并与原设计比较”

避免的常见失败模式

问题	表现	修复
厨房水槽会话	不相关任务堆在一个会话	`/clear` 重置
反复纠正	纠正 Claude 两次以上仍是错的	`/clear` 后用更好的提示重新开始
过度指定的 CLAUDE.md	文件太长，Claude 忽略一半	无情修剪，删掉显而易见的规则
信任但未验证	Claude 生成看起来合理但有边界 bug 的代码	始终提供验证（测试/脚本/截图）
无限探索	"调查某些东西"不加限定	限定范围或用 subagents

13. 会话管理

基本操作

操作	命令
继续最近会话	`claude --continue` 或 `claude -c`
恢复指定会话	`claude --resume` 或 `claude -r`
恢复特定 PR 会话	`claude --from-pr`
分叉会话	`--fork-session` 或 `/branch`
命名会话	`/rename oauth-migration`
会话选择器	`/resume`

会话存储

对话保存在 ~/.claude/projects/ 下的 JSONL 文件中。会话是独立的——每个新会话以全新上下文开始。

并行会话

方法	说明
Worktrees	在隔离的 git 检出差额中运行会话
桌面应用	可视化多会话管理
Web 版	云端独立 VM 运行
Agent teams	多会话自动协调

Writer/Reviewer 模式

会话 A (Writer)：为 API 端点实现速率限制器
会话 B (Reviewer)：审查 @src/middleware/rateLimiter.ts 中的实现，查找边界情况
[会话 B 输出反馈]
会话 A：解决这些问题

14. CLI 命令参考

启动选项

claude                          # 启动交互模式
claude "task"                   # 运行一次性任务
claude -p "query"               # 运行查询后退出（非交互）
claude -p "query" --output-format json    # JSON 格式输出
claude -p "query" --output-format stream-json  # 流式 JSON
claude -c                       # 继续最近对话
claude -r                       # 恢复之前的对话
claude --model <name>           # 指定模型
claude --permission-mode auto   # 使用 auto mode
claude --add-dir <path>         # 添加额外可访问目录
claude --worktree               # 在隔离 worktree 中运行
claude --teleport               # 拉入远程会话
claude --verbose                # 详细输出（调试用）

会话内命令

命令	功能
`/help`	显示帮助
`/clear`	清除对话历史
`/compact`	压缩上下文
`/context`	查看上下文使用
`/model`	切换模型
`/login`	切换账户
`/init`	创建 CLAUDE.md
`/memory`	查看/编辑记忆
`/mcp`	管理 MCP 服务器
`/hooks`	查看 hooks 配置
`/permissions`	配置权限
`/rewind`	回退到之前状态
`/resume`	恢复会话
`/rename`	命名会话
`/branch`	分叉会话
`/doctor`	诊断安装问题
`/plugin`	浏览插件市场
`/schedule`	创建定时任务
`/statusline`	配置状态栏
`/agents`	配置自定义 subagents
`/goal`	设置完成条件

键盘快捷键

快捷键	功能
`Esc`	立即停止 Claude
`Esc + Esc`	打开回退菜单
`Shift+Tab`	循环切换权限模式
`Tab`	命令补全
`↑`	命令历史
`Ctrl+R`	跨项目搜索命令历史
`Ctrl+G`	在文本编辑器打开计划
`/`	查看所有命令和 skills

管道和脚本

# 分析日志
tail -200 app.log | claude -p "Slack me if you see any anomalies"

# CI 中自动翻译
claude -p "translate new strings into French and raise a PR"

# 批量安全审查
git diff main --name-only | claude -p "review these files for security issues"

15. 高级特性

15.1 计划模式与 Ultraplan

Plan Mode（按 Shift+Tab 两次）：仅使用只读工具，生成执行计划供你审查。

Ultraplan：从 CLI 启动，在云端起草计划，然后远程或在终端执行：

claude --ultraplan "add support for multiple payment methods"

15.2 代码审查

基本："审查我的更改"
Ultrareview：云端多代理深度代码审查 /ultrareview
GitHub Code Review：每个 PR 自动审查
GitHub Actions / GitLab CI：CI/CD 中自动化审查

15.3 定时任务

Routines：在 Anthropic 管理的基础设施上按计划运行
桌面计划任务：本地机器上运行
/loop：CLI 会话中重复提示

15.4 Agent Teams

启动多个 Claude Code 实例协同工作，共享任务、收发消息、集中管理。

15.5 Agent SDK

使用 Python 或 TypeScript 构建自定义代理，完全控制编排、工具访问和权限。

15.6 Computer Use

Claude 可以打开应用、点击、输入、查看屏幕（目前仅 macOS CLI）。适合测试原生应用、调试可视化问题。

15.7 远程控制

通过 claude.ai/code 或 Claude 手机应用从任何设备继续本地会话。

15.8 Chrome 扩展

将 Claude Code 连接到 Chrome 浏览器，测试 Web 应用、调试控制台日志、自动填写表单。

16. 故障排除

常见问题

问题	解决方案
命令未找到	检查 PATH 配置，重新安装
登录失败	检查网络、代理设置；尝试 `/login` 重新认证
高 CPU/内存使用	`/clear` 重置上下文；检查是否长时间运行
卡住/挂起	按 `Esc` 停止；如果无效，重启终端
自动压缩循环错误	单个文件或工具输出过大，拆分为更小的操作
CLAUDE.md 不生效	运行 `/memory` 验证加载，检查是否有冲突指令
权限提示过多	配置权限允许列表或使用 Sandbox
网络问题	检查企业网络配置（代理、CA 证书、mTLS）

诊断工具

/doctor — 诊断安装问题
/context — 查看上下文占用
/hooks — 检查 hooks 配置
/mcp — 检查 MCP 服务器状态
/memory — 查看记忆文件加载情况
--verbose — 详细输出模式

17. 扩展阅读

主题	链接
官方文档	https://code.claude.com/docs/zh-CN
更新日志	https://code.claude.com/docs/zh-CN/changelog
CLI 完整参考	https://code.claude.com/docs/zh-CN/cli-reference
Agent SDK	https://code.claude.com/docs/zh-CN/agent-sdk/overview
最佳实践	https://code.claude.com/docs/zh-CN/best-practices
常见工作流	https://code.claude.com/docs/zh-CN/common-workflows
扩展功能	https://code.claude.com/docs/zh-CN/features-overview
安全指南	https://code.claude.com/docs/zh-CN/security
Discord 社区	加入获取提示和支持

本文档基于 Claude Code 官方中文文档整理，以模块化结构呈现。每个模块相对独立，可根据需要跳转阅读。建议按顺序通读第一遍，后续作为参考手册查阅。

https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

2026年 AI 编程工具算力避坑指南：深度解析 Cursor 定价机制与企业降本全攻略

AI编程社区

2026年实测：用Gemini镜像站高效解决Java与PHP开发难题

Java的深度与PHP的灵活，决定了开发者在日常工作中必然会遇到各种复杂场景。AI的出现不是要取代扎实的基础知识，而是给每一位开发者提供了一个能即时查阅、推理和生成示例的技术顾问。在日常编程中，建议形成“报错→粘贴→分析→验证”的快速回路。遇到异常堆栈，直接发给AI获取分析路径；在编写关键算法前，让AI先给出几种实现对比；在进行代码审查时，用AI发现潜在的边界问题。所有AI给出的方案，最终都需经过

AI编程社区

Cursor + GitOps：自动化运维新姿势，开启“嘴炮运维”新时代

AI编程社区

所有评论(0)

查看更多评论

Aetik

@Aetik

已为社区贡献1条内容

ClaudeCode新手入门全指南

Aetik

Claude Code 新手入门全指南

目录

1. 概述：Claude Code 是什么

可用界面一览

2. 环境与界面选择

选择决策树

账户要求

3. 安装与登录

终端 CLI 安装

登录

VS Code 扩展安装

4. 第一个会话

启动

第一个问题

第一次代码更改

第一次 Git 操作

基本命令速查

5. 核心概念：代理循环

三阶段循环

两大驱动组件

Claude 能访问什么

6. 工具系统

五大类内置工具

工具使用示例

7. 上下文窗口管理

什么是上下文窗口

自动压缩（Compaction）

手动管理上下文的三种方式

Skills 和 Subagents 的上下文优势

8. 配置体系

8.1 CLAUDE.md — 持久指令

文件位置与范围

编写原则

示例 CLAUDE.md

导入其他文件

使用 /init 自动生成

8.2 自动记忆

8.3 设置文件 (settings.json)

常用设置示例

8.4 规则系统 (.claude/rules/)

路径范围限定

9. 扩展系统

扩展能力对比

9.1 Skills — 可复用工作流

创建 Skill

9.2 Hooks — 自动化触发器

常见 Hook 事件

示例：每次文件编辑后运行 ESLint

9.3 MCP — 外部工具连接

添加 MCP 服务器

9.4 Subagents — 子代理委派

创建 Subagent

9.5 Plugins — 插件市场

10. 权限与安全

权限模式

允许特定命令

检查点（Checkpoints）

沙箱

11. 日常工作流

探索代码库

Bug 修复

功能实现

重构

编写测试

代码审查

Git 操作

文档更新

12. 最佳实践

黄金法则

四阶段工作流

提示对比：差 vs 好

避免的常见失败模式

13. 会话管理

基本操作

会话存储

并行会话

Writer/Reviewer 模式

14. CLI 命令参考

使用 `/init` 自动生成