Claude Code 是 Anthropic 推出的终端级 AI 编程代理，与传统代码补全工具不同，它是一个能理解整个项目的"系统级协作者"，可以在终端中通过自然语言对话完成代码编写、调试、重构等任务

---

一、安装与基础设置

1.1 安装 Claude Code

bash

# 全局安装
npm install -g @anthropic-ai/claude-code

# 查看版本确认安装成功
claude --version

# 更新到最新版本
sudo npm i -g @anthropic-ai/claude-code
sudo claude update

1.2 首次启动与 Token 配置

首次启动需要配置 API Token

bash

mkdir -p ~/.claude && cat > ~/.claude/settings.json << 'EOF'
{
   "env": {
    "ANTHROPIC_BASE_URL": "https://teniuapi.online",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "glm-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5"
  }
}
EOF

配置解释：

ANTHROPIC_AUTH_TOKEN：在https://teniuapi.online上注册成功后用户自己新建的令牌

ANTHROPIC_MODEL：你选择的模型，可以是glm-5、claude-opus-4-6、kimi、MiniMax等任一模型

配置 API Token后，就可以启动了：

bash

cd your-project
claude

---

二、Claude Code 核心功能

2.1 斜杠命令体系

Claude Code 的核心交互方式是通过斜杠命令。

高频命令（每天必用）

命令用途说明/help查看帮助忘记功能时随手查/model切换模型简单任务切小模型节省 token/cost查看费用每次结束前看看花了多少钱/memory编辑记忆让 AI 记住项目约定和偏好/clear开启新对话对话过长时会变慢，用此命令重置

项目初始化命令

命令用途/init扫描代码库，自动生成 CLAUDE.md 项目配置文件/config修改配置（权限、行为偏好等）

进阶命令

命令用途/review让 AI 做 Code Review/mcp配置 MCP 服务器，连接外部工具

技巧：第一次打开新项目，先跑 /init。它会扫描代码库自动生成项目描述文件，后续 AI 理解代码会准确得多

2.2 三种交互模式

模式触发方式适用场景Interactive mode默认需要确认每一次改动Auto-accept modeShift+Tab任务简单明确，完全信任 AIPlan modeShift+Tab 两次先制定执行计划，不直接改代码

建议流程：先用 Plan mode 讨论方案，确认后再执行

2.3 键盘快捷键

快捷键用途Ctrl + C打断当前 AI 执行（跑偏时赶紧刹车）Ctrl + O切换详细输出模式（看 AI 思考过程）Shift + Tab切换权限模式（信任模式 vs 确认模式）Esc + Esc救命键——撤销上一次文件改动

2.4 精准引用：@ 和 ! 符号

bash

# 用 @ 引用文件，精准提供上下文
请帮我 review @src/utils/auth.ts 这个文件的安全性

# 用 ! 执行 Shell 命令
! npm run test

用 @ 符号直接引用文件路径，AI 会自动读取文件内容；用 ! 前缀无需切换窗口就能执行命令，测试结果还会作为上下文供 AI 分析

2.5 扩展思考模式（ultrathink）

遇到架构设计、复杂算法等需要深度推理的任务时，可以让 AI 先进行深入思考再给出方案：

bash

请先进入 ultrathink 模式，分析这个架构设计，然后给出优化方案

---

三、Skill 详解与使用

3.1 什么是 Skill？

Skill（技能） 是 Claude Code 的模块化功能扩展系统，相当于"一键启动的标准操作流程"。你可以把经常重复的任务（如创建新 API、编写单元测试、做代码审查）封装成 Skill，之后只需调用名称即可执行完整流程

3.2 Skill 的核心特性

• 自动调用：Claude 会根据用户请求和 Skill 描述自动判断何时使用

• 渐进式加载：启动时只加载名称和描述，需要时才加载完整内容

• 跨平台兼容：支持 Claude.ai、API 接口和 Claude Code

• 可执行代码：允许包含脚本文件

3.3 Skill 存储位置

类型路径适用场景个人 Skill~/.claude/skills/个人工作流、实验功能项目 Skill.claude/skills/团队协作、项目特定知识插件 Skill通过插件系统安装分发和管理

3.4 创建 Skill 的步骤

步骤 1：创建目录和文件

bash

# 创建个人 Skill
mkdir -p ~/.claude/skills/my-skill
touch ~/.claude/skills/my-skill/SKILL.md

# 或创建项目 Skill
mkdir -p .claude/skills/my-skill
touch .claude/skills/my-skill/SKILL.md

步骤 2：编写 SKILL.md

markdown

---
name: api-creator
description: 创建符合 RESTful 规范的 API 接口，包含路由、控制器、验证器和测试用例
---

# API Creator Skill

## 功能说明
创建一个完整的 RESTful API 接口，包括：
1. 路由定义
2. 控制器逻辑
3. 请求验证器
4. 单元测试用例

## 使用示例
输入："创建一个用户登录的 API 接口"

## 技术规范
- 使用 Laravel/PHP 框架
- 遵循 RESTful 设计原则
- 包含请求参数验证
- 返回统一格式的 JSON 响应
{
    "code": 0,
    "message": "success",
    "data": {}
}

• name：仅用小写字母、数字和连字符，≤64 字符

• description：清楚说明功能和使用时机，≤1024 字符

步骤 3：测试 Skill

bash

# 检查路径是否正确
ls ~/.claude/skills/my-skill/SKILL.md

# 启用调试模式测试
DEBUG=claude:skills claude code

3.5 使用现成的 Skill 包

有一个开箱即用的 Skill 包 @codihaus/claude-skills，覆盖了完整开发流程https://www.npmjs.com/package/@codihaus/claude-skills?activeTab=dependents：

快速初始化

bash

npx @codihaus/claude-skills init

可用 Skill 列表

Skill用途/debrief从需求创建 BRD 和用例/dev-scout探索和记录现有代码库/dev-arch制定架构决策/dev-specs创建实现规格说明/dev-coding根据规格实现功能/dev-test自动化 UI 测试/dev-review代码审查/dev-changelog记录实现内容

管理命令

bash

# 初始化到项目
npx @codihaus/claude-skills init

# 更新到最新版本
npx @codihaus/claude-skills update

# 查看可用 Skill
npx @codihaus/claude-skills list

# 检查项目配置
npx @codihaus/claude-skills doctor

# 自动修复问题
npx @codihaus/claude-skills doctor --fix

3.6 自定义命令（轻量级 Skill）

在 .claude/commands/ 目录下创建 .md 文件，可以定义自己的命令，相当于 Skill 的简化版https://www.mintlify.com/shanraisshan/claude-code-best-practice/concepts/commandshttps://developer.aliyun.com/article/1716291：

示例：创建 .claude/commands/review-pr.md

markdown

---
description: 对 PR 做完整的 Code Review
model: sonnet
---

请对当前分支的所有改动做一次完整的 Code Review，重点关注：

1. 潜在的安全漏洞
2. 性能问题
3. 代码规范
4. 潜在 bug

输出格式用表格，包含：文件名、问题描述、严重程度（高/中/低）、建议修复方案。

之后在 Claude Code 中直接输入 /review-pr 即可调用。

---

---

四、完整示例：用 Claude Code 开发一个登录 API

场景说明

开发一个用户登录 API，要求包含：

• 邮箱/密码验证

• JWT token 返回

• 输入验证

• 单元测试

Step 1：初始化项目

bash

# 进入项目目录
cd my-api-project

# 启动 Claude Code
claude

Step 2：初始化项目配置

在 Claude Code 中输入：

text

/init

Claude 会扫描项目结构，生成 CLAUDE.md 文件，记录技术栈和项目规范。

Step 3：使用 Plan mode 讨论方案

按两次 Shift+Tab 进入 Plan mode，然后输入：

text

我需要开发一个用户登录 API，技术栈使用 Node.js + Express + TypeScript。
请先分析需求，制定技术方案，不要直接写代码。

Claude 会输出类似这样的方案：

text

## 技术方案

### 1. 文件结构
- src/controllers/auth.controller.ts - 登录控制器
- src/services/auth.service.ts - 认证逻辑
- src/middlewares/validation.ts - 请求验证
- src/types/auth.types.ts - 类型定义

### 2. 依赖包
- jsonwebtoken - 生成 JWT
- bcrypt - 密码哈希比对
- zod - 输入验证
- jest - 单元测试

### 3. API 设计
POST /api/auth/login
Request: { email: string, password: string }
Response: { token: string, user: { id, email } }

确认方案后，我将开始实现。

Step 4：确认后执行

text

方案确认，请开始实现。

Step 5：创建 Skill 复用工作流（可选）

将登录 API 的开发流程保存为 Skill，下次直接复用：

bash

# 创建 Skill 文件
mkdir -p .claude/skills/login-api

编辑 .claude/skills/login-api/SKILL.md：

markdown

---
name: login-api-creator
description: 创建用户登录 API，包含 JWT、验证器和测试
---

# Login API Creator

## 功能
创建完整的用户登录 API：
1. 邮箱/密码验证
2. JWT token 生成
3. 请求验证中间件
4. 单元测试

## 技术规范
- Node.js + Express + TypeScript
- 使用 zod 进行输入验证
- JWT 有效期 7 天
- 密码错误最多尝试 5 次

之后只需输入 /login-api-creator 即可快速创建标准登录 API。

Step 6：测试验证

bash

# 运行测试
! npm run test

# 如果有报错，直接说 "帮我修复测试失败的问题"

Step 7：代码审查

text

/review

Claude 会对本次改动进行全面的 Code Review，输出问题列表和修复建议。

---

六、效率提升技巧

6.1 黄金使用流程

1. Plan mode 先行：复杂任务先让 AI 出方案，确认后再执行

2. 验证闭环：让 AI 生成代码后，再让 AI 自检一遍，质量可提升 2-3 倍

3. 用好 /init：每次大改动后重新运行，让项目理解保持最新

6.2 并行作战策略

开多个终端窗口，每个跑一个独立任务，配合 Subagent 机制，实测整体效率可提升到单实例的 19 倍以上

6.3 CLAUDE.md 动态进化

每次 Code Review 发现的共性问题，追加到 CLAUDE.md 中，让 AI 越来越"懂"你的项目

6.4 常用场景速查

场景操作理解现有项目/init → 查看生成的 CLAUDE.md写新功能Plan mode → 确认方案 → 执行修 Bug粘贴报错信息 → "修复这个问题"重构代码"分析这段代码，给出重构方案"代码审查/review写单元测试选中函数 → "生成完整的单元测试"