Claude Code 从入门到精通

本教程面向初次接触 AI 编程助手的开发者，涵盖安装、认证配置、多种使用方式、终端技巧、Skills 自定义，以及常见问题解答。Wiki 风格编写，可按章节跳转。

本文适合谁

第一次听说 Claude Code，想从零跑通
已安装但卡在 API Key、Base URL、401/404 报错
想系统了解终端斜杠命令、/ 唤醒 Skill、CC Switch 多 Provider 切换

你将学到什么

如何安装 Claude Code 并做健康检查
三种认证方式如何选择（官方登录 / CC Switch / 手动 settings.json）
终端、VS Code 插件、Desktop 等多种用法
斜杠命令与 Skills 的入门与自定义
常见报错的排查步骤

章节	内容
1. 简介	Claude Code 是什么、典型场景
2. 安装与环境检查	npm 安装、验证、Windows 排错
3. 认证方式对比	三种方式选型与新手推荐路径
4. 方式 A：官方登录	`/login` 订阅用户
5. 方式 B：CC Switch	可视化 Provider 管理（推荐）
6. 方式 C：手动 settings.json	手写 API Key 与 Base URL
7. 多种使用方式	终端、VS Code、IDE、Desktop
8. 终端入门	项目目录、CLI 参数、权限提示
9. 终端技巧与斜杠命令	`/` 菜单、Skill、快捷键
10. 项目级配置	CLAUDE.md、.claude 目录
11. Skills 自定义	创建与调用自定义 Skill
12. 常见问题 FAQ	401、404、配置不生效等
13. 学习路径	Level 1～4 进阶路线
14. 参考链接	官方文档与延伸阅读

1. 简介

本章目标： 理解 Claude Code 的定位，知道它适合解决什么问题。

Claude Code 是什么？

Claude Code 是 Anthropic 推出的 AI 编程助手 ，运行在本地终端（或 VS Code 等 IDE）中。与普通网页聊天不同，它会在 当前项目目录 下工作：读取文件结构、分析代码、修改 Bug、生成页面、写测试、产出文档。

一句话对比：

工具	特点
网页版 Claude	通用对话，不自动读本地项目
GitHub Copilot	编辑器内补全为主
Cursor	IDE 一体化 AI 编辑
Claude Code	CLI + 项目上下文 + 斜杠命令 / Skill 工作流

典型使用场景

分析陌生项目的目录结构和技术栈
阅读并解释某段代码的逻辑
生成前端页面或 API 接口代码
定位并修复 Bug
重构函数或组件
编写 README、测试用例
提交前做代码审查（/code-review）

官方文档

最新安装方式、环境变量、命令列表以官方为准：

文档首页：Overview - Claude Code Docs
设置说明：Claude Code settings - Claude Code Docs
环境变量：Environment variables - Claude Code Docs
命令参考：Commands - Claude Code Docs

2. 安装与环境检查

本章目标： 在本机安装 Claude Code，确认 claude 命令可用。

前置条件

Claude Code 通过 npm 全局安装，需要先安装 Node.js（自带 npm）。

检查版本：

复制代码

node -v
npm -v

若能正常输出版本号（建议 Node.js 18+），即可继续。

安装

复制代码

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

验证安装

复制代码

claude --version

进入交互界面：

复制代码

claude

成功标志： 出现 Claude Code 的输入提示符，可输入自然语言或 / 命令。

健康检查（安装后第一件事）

在交互界面输入：

复制代码

/doctor

或在终端直接运行：

复制代码

claude doctor

/doctor 会检查安装、配置、网络等项，并按状态图标列出结果。有问题时可按 f 让 Claude 尝试自动修复。

Windows 用户注意

若提示 claude 不是内部或外部命令：

确认 Node.js 和 npm 已安装
查看 npm 全局路径：npm config get prefix
将该路径下的 bin（或 Windows 下的根目录）加入系统 PATH
关闭并重新打开 PowerShell 或终端

若经常做开发，也可考虑在 WSL 中安装，行为更接近 Linux/macOS 环境。

更新到最新版

复制代码

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

更新后可在会话内运行 /release-notes 查看变更，再运行 /help 确认新命令是否可用。

3. 认证方式对比

本章目标： 选择适合自己的登录/接入方式，避免在 Key 和 Base URL 上反复踩坑。

Claude Code 需要能访问 Anthropic 模型服务。国内用户常见三种配置方式：

方式	适合谁	优点	注意
官方 `/login`	有 Claude Pro/Max 订阅	零配置、最省心	需能访问 Anthropic 账号体系
CC Switch（推荐新手）	多模型/多平台、第三方 API	可视化、Claude Code 热切换 Provider、统一管理 MCP/Skills	需额外安装桌面应用
手动 settings.json	想完全掌控配置	透明、可脚本化、便于团队文档化	易填错 Base URL 或 Key

新手推荐路径

建议按此顺序操作，15 分钟内可完成首次跑通：

完成第 2 章安装，运行 /doctor

有 Claude 订阅 → 进入第 4 章使用 /login

无订阅、使用第三方 API → 进入第 5 章安装 CC Switch 添加 Provider

熟悉后如需细调，再阅读第 6 章了解底层配置文件

4. 方式 A：官方登录

本章目标： 使用 Anthropic 官方账号订阅，无需手写 API 配置。

操作步骤

在终端进入任意目录，运行 claude
输入 /login，或在启动引导中选择登录
按提示在浏览器中完成 Anthropic 账号授权

返回终端，发送测试消息：

复制代码

请用一句话回复：Claude Code 已正常工作。

成功标志： 收到正常回复，且 /doctor 无认证相关报错。

命令	用途
`/login`	登录 Anthropic 账号
`/logout`	退出当前账号
`/upgrade`	查看或升级 Pro/Max 计划（视账号显示）

说明

官方登录 不需要 配置 ANTHROPIC_BASE_URL 或 ANTHROPIC_AUTH_TOKEN
若同时使用 CC Switch 或 settings.json，注意避免 env 变量冲突；一般选一种主认证方式即可

5. 方式 B：CC Switch

本章目标： 用 CC Switch 可视化管理 API Provider，适合第三方 API 与多模型切换。

CC Switch 是什么？

CC Switch 是一款开源 桌面应用 ，统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等 AI 编程 CLI 的 Provider 配置。源码：https://github.com/farion1231/cc-switch

为什么值得学：

不用手改 JSON，降低填错 Base URL 的概率
内置 50+ Provider 预设，也可自定义
Claude Code 支持热切换 ：切换 Provider 后通常 无需重启终端（其他 CLI 多数需重启）
可统一管理 MCP、Skills、Prompts、会话与用量统计

安装

打开官网：CC Switch 官方网站 - AI 编程 CLI 统一管理工具
进入 Releases 下载对应系统安装包（Windows / macOS / Linux）
按安装向导完成安装（macOS 推荐 .dmg，已签名公证）

首次使用流程

启动 CC Switch，在 Claude Code 工具页点击「添加 Provider」
选择内置预设（如你的 API 中转平台）或「自定义」
填入：
- API Key （如 sk-xxxxxxxx，勿泄露真实 Key）
- Base URL （以 Provider 文档为准，见 Base URL 陷阱）
- 模型名称 （从平台后台复制完整 ID，不要猜 claude 或 sonnet）
保存后，将该 Provider 设为当前生效
打开终端，进入测试目录，运行 claude，发送一句话测试

成功标志： Claude Code 正常回复，CC Switch 中可见请求/用量（若已开启统计）。

[待补图：CC Switch 添加 Provider 界面]

进阶功能（入口即可）

功能	说明
系统托盘	右键快速切换 Provider
Local Routing	本地代理、格式转换、失败自动 failover
共享配置片段	切换 Provider 时保留 MCP/插件等公共配置；编辑 Provider → 共享配置面板 →「从当前 Provider 提取」
MCP / Skills	在 CC Switch 中集中管理，写入 Claude Code 配置

与手动 settings.json 的关系

CC Switch 会将 Provider 信息写入 Claude Code 使用的配置（如 ~/.claude/settings.json 或相关 env）。若你曾手改文件，可在 CC Switch 中「从当前 Provider 提取」同步回来，避免两套配置不一致。

CC Switch 常见问题

切换 Provider 后 Claude Code 仍用旧配置？

确认 CC Switch 中已将该 Provider 设为当前
Claude Code 会话若已打开，可新开终端再试；多数情况支持热切换

切换 Provider 后插件/MCP 配置丢失？

使用「共享配置片段」功能，创建新 Provider 时勾选「写入共享配置」

6. 方式 C：手动 settings.json

本章目标： 理解底层配置文件，适合进阶用户或无法使用 CC Switch 的环境。

配置文件路径

系统	路径
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`（如 `C:\Users\你的用户名\.claude\settings.json`）

若 .claude 目录不存在，可手动创建：

复制代码

# macOS / Linux
mkdir -p ~/.claude

# Windows PowerShell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

通用配置模板

将下列内容写入 settings.json，替换为你的真实 Key 和网关地址：

复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的-api-网关地址",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

示例（第三方平台，仅供参考）： 部分教程（如 CSDN 国内使用指南）使用 TransAI 平台，Base URL 为 https://transitai.chat。你的平台请以 官方说明 为准，不要照搬。

字段说明

字段	含义
`ANTHROPIC_BASE_URL`	API 请求地址；填错易出现 404
`ANTHROPIC_AUTH_TOKEN`	API Key，等同于 Bearer Token
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	设为 `"1"` 可关闭部分非必要流量
`CLAUDE_CODE_ATTRIBUTION_HEADER`	设为 `"0"` 可关闭 attribution 头（部分中转平台需要）

Base URL 陷阱

不同平台对 Base URL 要求不同：

有的填根路径：https://api.example.com
有的要加 /v1：https://api.example.com/v1

以你使用的 Provider 文档为准。 填错常见现象：404、接口路径错误、连接失败。

验证配置

保存 settings.json，确认 JSON 格式正确（注意逗号、引号）
关闭已打开的 Claude Code 会话，重新打开终端

运行：

复制代码

mkdir claude-code-test
cd claude-code-test
claude

输入：

复制代码

请用一句话回复：Claude Code 已经可以正常工作。

成功标志： 收到正常回复。

安全提示： 不要把真实 API Key 提交到 Git、发到群聊或截图公开。泄露后立即在平台后台删除并重建 Key。

7. 多种使用方式

本章目标： 了解 Claude Code 在不同界面下的入口，按习惯选择终端或编辑器。

方式	怎么进入	适合场景
终端交互	项目目录执行 `claude`	全功能、斜杠命令、长时间任务
一次性 CLI	`claude "帮我分析目录结构"`	快速问答，不进交互
VS Code 插件	扩展市场安装 Claude Code	编辑器内对话、结合当前文件
IDE 集成	会话内 `/ide`	查看与 VS Code / Cursor 等联动状态
Desktop 应用	`/desktop` 或 `/app`	macOS/Windows + 订阅，图形界面继续会话
远程继续	`/remote-control`、`/teleport`	跨设备继续同一会话

7.1 终端交互（最完整）

复制代码

cd /path/to/your-project
claude

在提示符下直接输入自然语言，或以 / 开头输入命令（见第 9 章）。

7.2 一次性命令

复制代码

claude "列出当前目录下的 Markdown 文件，并说明各自主题"
claude -p "只输出项目使用的框架名称，一行即可"

适合脚本、CI 或快速查询。-p / --print 用于非交互输出（具体选项以 claude --help 为准）。

7.3 VS Code 插件

安装：

打开 VS Code，Ctrl + Shift + X 打开扩展市场
搜索 Claude Code，安装 Anthropic 官方扩展
安装后可在侧边栏或命令面板（Ctrl + Shift + P）中找到 Claude Code 入口

配置（第三方 API 时）：

在 设置 → 扩展 → Claude Code（或命令面板搜索 Claude Code 设置）中填写：

配置项	说明
API Key	如 `sk-xxxxxxxx`
Base URL / API Endpoint	与 settings.json 中 `ANTHROPIC_BASE_URL` 一致
Model	从平台后台复制完整模型 ID

成功标志： 在 VS Code 中打开项目文件夹，发送「请用一句话确认已连接」，收到正常回复。

重要： VS Code 插件配置 独立于 终端 ~/.claude/settings.json。若终端能用、插件不能用，请 分别检查 插件内的 Key、Base URL、Model。使用 CC Switch 时，确认当前 Provider 已生效后再测插件。

7.4 IDE 集成与 Desktop

在 Claude Code 会话中输入 /ide，查看当前 IDE 连接状态
已订阅且系统为 macOS/Windows 时，可用 /desktop 在 Claude Code Desktop 应用中继续当前会话

7.5 远程与会话迁移

命令	用途
`/remote-control`	从其他设备继续本地会话
`/teleport`	将 Web 端会话拉入当前终端
`/resume`	恢复历史会话

8. 终端入门

本章目标： 在真实项目中安全、高效地使用 Claude Code。

在项目目录中启动

Claude Code 依赖 当前工作目录 的上下文。请 cd 到项目根目录再运行：

复制代码

cd my-project
claude

若需额外只读目录，会话内可用 /add-dir <路径> 添加（配置发现仍以主项目 .claude 为准）。

新手推荐测试流程

不要第一次在大型生产项目上直接改代码。

第一步：空目录冒烟测试

复制代码

mkdir claude-smoke-test && cd claude-smoke-test
claude

帮我创建一个简单的 index.html，包含标题、输入框和按钮。

第二步：真实项目 --- 先分析，后修改

复制代码

cd my-real-project
claude

先不要修改任何代码。请分析当前项目结构，并告诉我主要技术栈和入口文件在哪里。

确认分析准确后，再逐步授权修改：

复制代码

请说明你将如何优化登录页表单布局，先给方案，不要改文件。

方案可以，请开始修改，改完后告诉我改了哪些文件。

常用 CLI 参数

参数	用途
`claude --help`	查看所有 CLI 选项
`claude --continue`	继续上一次会话（同项目）
`claude --model <name>`	指定模型启动
`claude doctor`	安装与配置诊断

会话内换模型可用 /model；CLI 与斜杠命令等价关系以 /help 为准。

权限提示（Allow / Deny）

首次让 Claude 读文件、跑命令、改代码时，终端会询问是否允许。这是 正常的安全机制：

Allow：允许本次或按规则记住
Deny：拒绝该操作

可在会话内用 /permissions 管理 allow/ask/deny 规则；项目级规则写在 .claude/settings.json。

警示： 在未经审核的生产仓库上，不要一次性 Allow 所有危险命令。大改动前先用 /plan 或「只分析不改文件」确认方案。

9. 终端技巧与斜杠命令

本章目标： 掌握 / 命令菜单与 Skill，提升日常效率。

核心概念

概念	说明
`/` 菜单	在输入框输入 `/`，弹出当前版本可用的全部命令，可继续输入字母过滤
内置命令	由 Claude Code 实现的固定逻辑，如 `/clear`、`/model`
Skill	以 `SKILL.md` 定义的指令包；你可 `/skill-name` 手动调用，Claude 也会在相关时自动选用
版本差异	命令随版本变化；以本机 `/help` 输出为准

命令 必须出现在消息开头 。/code-review 只看 src/ 中，/code-review 后的文字会作为参数传入。

按场景常用命令

场景	代表命令	一句话用途
会话管理	`/clear`、`/compact`、`/resume`	清空上下文 / 压缩历史 / 恢复旧会话
模型与模式	`/model`、`/plan`、`/effort`	切换模型 / 先规划再实施 / 调节推理强度
项目初始化	`/init`、`/memory`	生成 `CLAUDE.md` / 编辑记忆文件
代码质量	`/code-review`、`/diff`、`/review`	审查本地 diff / 交互看改动 / 审查 GitHub PR
Skills	`/skills`、`/reload-skills`	列出 Skill；磁盘新增 Skill 后热加载
诊断	`/doctor`、`/debug`	安装检查 / 开启调试日志
上下文	`/context`、`/cost`	查看上下文占用 / 用量（`/cost` 为 `/usage` 别名）

输入 /help 可查看 当前安装版本 的完整列表；更新后先 /release-notes 再 /help。

Skill 与 `/` 的关系

bundled Skill 示例：/code-review、/batch、/debug、/loop 等，用法与自定义 Skill 相同
输入 /skills 列出所有 Skill；按 t 按 token 排序，Space 可隐藏不在菜单中显示的 Skill
新增或修改 ~/.claude/skills/ 或 .claude/skills/ 后，运行 /reload-skills 无需重启 Claude Code

快捷键（因终端而异）

快捷键	用途
`Shift + Tab`	切换 Normal / Plan 等模式（版本相关）
`Option + P`（macOS）/ `Alt + P`（Windows）	不清空输入的情况下切换模型
`Shift + Enter`	多行输入；若无效，运行 `/terminal-setup` 配置终端

在 VS Code、Cursor 内置终端中，建议运行一次 /terminal-setup 以绑定 Shift+Enter。

工作流示例

新项目第一天：

复制代码

/init
/memory
/mcp

大功能开发：

复制代码

/plan 实现用户导出 CSV 功能

提交前：

复制代码

/diff
/code-review --fix

对话太长：

复制代码

/compact 保留与认证模块相关的讨论

10. 项目级配置

本章目标： 让 Claude 长期「理解」你的项目规则与权限。

CLAUDE.md

项目根目录下的 项目说明书。Claude 在新会话中会读取，用于约定：

技术栈与目录结构
编码规范、测试命令
禁止事项（如不要改哪些目录）

生成起点：在项目根运行 /init，会创建 starter CLAUDE.md，再用 /memory 细化。

用户级 vs 项目级配置

位置	作用域	典型内容
`~/.claude/settings.json`	本机所有项目	`env`（API Key）、个人默认权限
`.claude/settings.json`	当前仓库	项目 permissions、hooks、团队 env
`~/.claude/skills/`	全局 Skill	个人常用工作流
`.claude/skills/`	当前仓库	项目专属 Skill，可随 Git 共享

项目级 permissions 示例（仅示意）：

复制代码

{
  "permissions": {
    "allow": ["Read(src/**)", "Edit(src/**)"],
    "deny": ["Edit(.env*)"]
  }
}

具体 schema 以官方 Settings 文档为准。

.claude 目录结构（常见）

复制代码

my-project/
├── CLAUDE.md
└── .claude/
    ├── settings.json
    └── skills/
        └── my-team-skill/
            └── SKILL.md

11. Skills 自定义

本章目标： 创建可复用的 /my-skill 工作流。

什么是 Skill？

Skill 是一个文件夹 + SKILL.md 文件，内含告诉 Claude 如何完成某类任务 的说明。与内置 /code-review 类似，你可以：

手动输入 /my-skill 调用
让 Claude 在相关场景下自动加载（除非设置了 disable-model-invocation: true）

官方说明：Extend Claude with skills - Claude Code Docs

存放位置

路径	作用域
`~/.claude/skills/<skill-name>/SKILL.md`	本机所有项目
`.claude/skills/<skill-name>/SKILL.md`	仅当前仓库（可提交 Git）

文件夹名建议 小写 + 连字符 ，如 release-checklist。

最小示例

创建 ~/.claude/skills/hello-skill/SKILL.md：

复制代码

---
name: hello-skill
description: 用中文打个招呼并列出当前 git 分支
---

当用户调用此 Skill 时：
1. 用中文简短问候
2. 运行 git branch --show-current 并告知当前分支
3. 不要修改任何文件

在 Claude Code 中：

复制代码

/reload-skills
/hello-skill

常用 frontmatter

字段	说明
`name`	Skill 名称，对应 `/name`
`description`	描述；Claude 据此判断是否自动 invoke
`disable-model-invocation: true`	仅用户可手动调用（如 deploy、commit）
`allowed-tools`	限制 Skill 激活时可用的工具

排错 checklist

Skill 未出现在 / 菜单时：

路径是否在 skills/ 下且文件名为 SKILL.md
文件夹名是否与 /命令名 一致（小写、连字符）
是否运行了 /reload-skills
运行 /context 查看是否有 Skill 被排除（描述过长等）

12. 常见问题 FAQ

本章目标： 按现象快速定位认证、配置与使用问题。

以下每题结构：现象 → 原因 → 操作清单 → 仍不行时

401 Unauthorized

现象： 请求失败，提示未授权。

原因： API Key 错误、不完整、含空格、已删除，或写入了错误配置项。

操作清单：

在 CC Switch 或 ~/.claude/settings.json 中确认 ANTHROPIC_AUTH_TOKEN（或插件中的 API Key）
重新从平台后台 完整复制 Key，粘贴后检查首尾无空格
保存配置，关闭 Claude Code，重开终端再试
若 Key 曾泄露，在平台删除并新建

仍不行： 运行 /doctor 和 /debug 401 问题，检查是否同时存在官方 /login 与 env Token 冲突。

404 或接口路径错误

现象： 连接失败、404、path not found。

原因： ANTHROPIC_BASE_URL 填错（多/少 /v1、协议错误或域名拼写错误）。

操作清单：

对照 Provider 文档确认 Base URL 格式
CC Switch 或 settings.json 中修正后切换/保存 Provider
新开终端测试一句话回复

仍不行： 用 curl 或平台提供的测试工具验证 Key + URL 是否在本机可达。

model not found

现象： 提示找不到模型。

原因： 模型 ID 与平台不一致；账号无该模型权限。

操作清单：

登录 API 平台，从模型列表 复制完整 ID （不要猜 claude-sonnet 简写）
在 CC Switch Provider 或 VS Code 插件 Model 字段中粘贴
确认账户余额与模型权限

配置不生效

现象： 改了 settings.json 但行为不变。

原因： 路径错误、JSON 语法错误、未重启、或被 CC Switch 覆盖。

操作清单：

确认路径：~/.claude/settings.json（Windows 见第 6 章）
用 JSON 校验器检查逗号、引号
关闭所有 claude 会话，重开终端
若使用 CC Switch，在应用中确认 当前 Provider 并避免与手改文件冲突

终端能用，VS Code 插件不能用

现象： 终端 claude 正常，插件无响应或报错。

原因： 插件使用 独立配置，未读取终端 settings.json。

操作清单：

VS Code 设置中单独填写 API Key、Base URL、Model
保存后重载窗口（Developer: Reload Window）
在插件中发送一句话测试

CC Switch 切换 Provider 无效

现象： 已切换 Provider，Claude Code 仍连旧服务。

操作清单：

确认 CC Switch 中该 Provider 为 当前生效
新开终端运行 claude（Claude Code 多数情况支持热切换）
检查共享配置是否写入成功

找不到某个斜杠命令

现象： 文档里有 /xxx，本机 /help 没有。

原因： Claude Code 版本过旧；或该命令仅特定计划/平台可用。

操作清单：

复制代码

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

会话内：/release-notes → /help

请求很慢或超时

现象： 简单问题也等待很久。

原因： 大型仓库上下文过多、网络延迟、模型繁忙。

操作清单：

先用小目录冒烟测试，排除配置问题
会话内 /compact 压缩历史
用 /context 查看上下文占用
复杂任务改用 /plan 分步执行

余额不足

现象： 平台返回额度不足。

操作清单： 登录 API 平台查看余额与调用记录；新手先用小任务验证，避免一上来分析超大 monorepo。

13. 从入门到精通学习路径

本章目标： 按阶段系统提升，避免一次啃完所有高级功能。

Level 1 --- 入门（第 1 天）

安装 Claude Code，claude --version 与 /doctor 通过
完成一种认证方式（/login 或 CC Switch / settings.json）
空目录生成简单 HTML， /clear 开始新会话
阅读第 8 章「先分析后修改」流程

Level 2 --- 日常（第 1 周）

在真实仓库中只分析、不改代码，验证技术栈判断正确
大改动前使用 /plan
提交前 /diff + /code-review
配置项目 CLAUDE.md（/init + /memory）

Level 3 --- 进阶（第 2～4 周）

CC Switch 配置 2 个以上 Provider 并熟练切换
编写 1 个个人 Skill（如发布检查清单），/reload-skills 验证
在项目 .claude/settings.json 中设置 permissions
尝试 /mcp 连接一个 MCP 服务器

Level 4 --- 精通

/batch 或 subagent 并行处理大范围重构
团队共享 .claude/skills/ 与 CLAUDE.md 规范
配置 Hooks 自动化（如保存后 lint）
/insights 回顾使用习惯并优化工作流

14. 参考链接

资源	链接
Claude Code 官方文档	Overview - Claude Code Docs
设置（Settings）	Claude Code settings - Claude Code Docs
环境变量	Environment variables - Claude Code Docs
命令参考	Commands - Claude Code Docs
Skills 扩展	Extend Claude with skills - Claude Code Docs
CC Switch 官网（中文文档）	CC Switch 官方网站 - AI 编程 CLI 统一管理工具
CC Switch GitHub	https://github.com/farion1231/cc-switch
CSDN 参考（国内 API 配置向）	Claude Code 国内使用教程：终端和 VS Code 插件配置完整流程-CSDN博客

Claude Code 从入门到精通

目录

1. 简介

Claude Code 是什么？

典型使用场景

官方文档

2. 安装与环境检查

前置条件

安装

验证安装

健康检查（安装后第一件事）

Windows 用户注意

更新到最新版

3. 认证方式对比

新手推荐路径

4. 方式 A：官方登录

操作步骤

相关命令

说明

5. 方式 B：CC Switch

CC Switch 是什么？

安装

首次使用流程

进阶功能（入口即可）

与手动 settings.json 的关系

CC Switch 常见问题

6. 方式 C：手动 settings.json

配置文件路径

通用配置模板

字段说明

Base URL 陷阱

验证配置

7. 多种使用方式

7.1 终端交互（最完整）

7.2 一次性命令

7.3 VS Code 插件

7.4 IDE 集成与 Desktop

7.5 远程与会话迁移

8. 终端入门

在项目目录中启动

新手推荐测试流程

常用 CLI 参数

权限提示（Allow / Deny）

9. 终端技巧与斜杠命令

核心概念

按场景常用命令

Skill 与 / 的关系

快捷键（因终端而异）

工作流示例

10. 项目级配置

CLAUDE.md

用户级 vs 项目级配置

.claude 目录结构（常见）

11. Skills 自定义

什么是 Skill？

存放位置

最小示例

常用 frontmatter

排错 checklist

12. 常见问题 FAQ

401 Unauthorized

404 或接口路径错误

model not found

配置不生效

终端能用，VS Code 插件不能用

CC Switch 切换 Provider 无效

找不到某个斜杠命令

请求很慢或超时

余额不足

13. 从入门到精通学习路径

Level 1 --- 入门（第 1 天）

Level 2 --- 日常（第 1 周）

Level 3 --- 进阶（第 2～4 周）

Level 4 --- 精通

14. 参考链接

Skill 与 `/` 的关系