国内镜像站：http://aicanapi.com/

教程手册：01_人工客服 - 艾可API中文文档

📋 目录

• 🎯 5分钟极速上手

• 📦 全平台安装详解

• ⚡ 核心功能实战演练

• 🔧 个性化配置指南

• 🧠 Think模式深度解析

• 🔌 MCP生态完全攻略

• 💾 记忆系统高效用法

• 🎮 程序员工作流整合

• 💰 成本控制与优化

• 🛠️ 常见问题速查手册

---

🎯 5分钟极速上手

立即安装体验

# 1. 检查Node.js环境（需要v18+）
node --version

# 2. 一键安装Claude Code
npm install -g @anthropic-ai/claude-code

# 3. 验证安装
claude --version

# 4. 首次启动认证
claude

立即体验强大功能

# 快速代码生成
claude -p "用Python写一个快速排序，带详细注释"

# 项目分析
claude "分析当前目录的项目结构"

# 代码调试
claude "帮我修复这个JavaScript函数的bug"

📦 全平台安装详解

🪟 Windows用户最佳方案

powershell

# 推荐使用WSL2获得最佳体验
# 以管理员身份运行PowerShell
wsl --install -d Ubuntu

# WSL中继续安装
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装Claude Code
npm install -g @anthropic-ai/claude-code

🍎 macOS用户一键安装

# 使用Homebrew（推荐）
brew install node@20
npm install -g @anthropic-ai/claude-code

# 或者直接安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

🐧 Linux用户专属命令

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install nodejs
npm install -g @anthropic-ai/claude-code

⚡ 核心功能实战演练

1. 智能代码生成

# 生成React组件
claude -p "创建一个用户登录表单组件，包含验证功能"

# 生成API接口
claude -p "用Express.js写一个用户注册的REST API"

# 生成数据库模型
claude -p "设计一个博客系统的MySQL表结构"

2. 代码审查与优化

# 审查代码质量
claude "审查src/utils/这个目录的代码质量"

# 性能优化
claude "优化这个函数的性能，目前感觉有点慢"

# 安全检查
claude "检查这个认证模块的安全漏洞"

3. 项目分析重构

# 架构分析
claude "分析这个项目的整体架构，给出改进建议"

# 代码重构
claude "将这个回调地狱重构为async/await模式"

# 依赖分析
claude "分析package.json，找出可以升级或替换的依赖"

🔧 个性化配置指南

环境变量配置

# 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_API_KEY="你的API密钥"
export ANTHROPIC_MODEL="claude-3-5-sonnet-20241022"

# 国内用户优化
export HTTP_PROXY="http://127.0.0.1:1080"
export HTTPS_PROXY="http://127.0.0.1:1080"

用户记忆配置

创建 ~/.claude/CLAUDE.md：

# 我的编程偏好

## 技术栈偏好
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL + Redis
- 移动端：React Native

## 代码风格
- 缩进：2个空格
- 命名：camelCase（JS/TS），snake_case（Python）
- 注释：中英文混合，详细说明复杂逻辑
- 文件组织：按功能模块划分

## 开发规范
- 必须写单元测试
- 错误处理要完善
- 日志记录要清晰
- 文档要及时更新

项目记忆配置

在项目根目录创建 .CLAUDE.md：

# 项目专属配置

## 项目信息
- 名称：电商后台管理系统
- 技术栈：Vue 3 + Element Plus + Node.js
- 代码规范：ESLint + Prettier

## 特殊要求
- API路径前缀：/api/v1/
- 认证方式：JWT
- 数据库：MySQL 8.0
- 缓存：Redis

## 常用命令
- 开发：npm run dev
- 构建：npm run build
- 测试：npm run test
- 部署：npm run deploy

🧠 Think模式深度解析

四种思考模式对比

模式	使用场景	示例命令	预期耗时
think	简单问题、代码审查	think 这个函数有什么问题	2-5秒
think hard	算法设计、架构思考	think hard 设计一个推荐系统	5-15秒
think harder	复杂系统设计	think harder 微服务架构迁移方案	15-30秒
ultrathink	极致复杂问题	ultrathink 重构整个单体应用	30-60秒

实战用例

# 基础思考：快速代码审查
think 这个React组件是否可以优化

# 深度思考：系统设计
think hard 设计一个高并发的秒杀系统

# 极致思考：架构重构
ultrathink 将单体应用拆分为微服务的最佳方案

🔌 MCP生态完全攻略

必装MCP服务器

# 1. 文件系统访问（核心必备）
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

# 2. GitHub集成
claude mcp add github -e GITHUB_TOKEN=你的token -- npx -y @modelcontextprotocol/server-github

# 3. 数据库连接
claude mcp add db -e DATABASE_URL=postgresql://user:pass@localhost/db -- npx -y @modelcontextprotocol/server-postgres

# 4. 网页自动化
claude mcp add browser -- npx -y @modelcontextprotocol/server-puppeteer

# 5. 搜索引擎
claude mcp add search -e BRAVE_API_KEY=你的key -- npx -y @modelcontextprotocol/server-brave-search

MCP管理命令

# 查看已安装服务器
claude mcp list

# 测试服务器连接
claude mcp test fs

# 删除服务器
claude mcp remove browser

# 查看MCP状态
/mcp

实战应用场景

# 使用文件系统MCP操作文件
claude "在src/components下创建一个新的React组件"

# 使用GitHub MCP管理代码
claude "查看最近的issue并回复"

# 使用数据库MCP查询数据
claude "查询用户表中最近注册的10个用户"

💾 记忆系统高效用法

编辑记忆文件

# 编辑用户记忆
/edit

# 编辑项目记忆
/edit project

智能记忆应用

# 基于记忆生成代码（会记住你的偏好）
claude "创建一个用户管理页面"

# 更新记忆
claude "记住我更喜欢使用axios而不是fetch"

# 查询记忆
claude "我之前设置的代码风格是什么"

🎮 程序员工作流整合

1. 日常开发流程

# 晨会后规划任务
claude "根据PRD，帮我拆分今天的开发任务"

# 开发新功能
claude "实现用户个人资料编辑功能"

# 写测试用例
claude "为这个用户服务编写单元测试"

# 代码提交
claude "生成符合Conventional Commits的提交信息"

2. 代码审查流程

# 审查自己的代码
claude "审查我刚写的这个组件，找出潜在问题"

# 审查团队代码
claude "分析这个PR的代码变更，给出审查意见"

# 安全检查
claude "检查这个API接口有没有安全漏洞"

3. 故障排查流程

# 分析错误日志
tail -f error.log | claude -p "分析这个错误堆栈，找出根本原因"

# 性能优化
claude "分析这个性能报告，找出瓶颈所在"

# 数据库优化
claude "分析这个慢查询，给出优化建议"

4. 文档编写流程

# API文档
claude "为这些REST接口生成OpenAPI文档"

# 项目文档
claude "为这个项目生成详细的README.md"

# 技术方案文档
claude "将我们的技术讨论整理成设计文档"

💰 成本控制与优化

Token节省技巧

# 1. 定期压缩对话
/compact

# 2. 使用精准的文件路径
claude "修复src/components/Button.js中的样式问题"

# 3. 创建.claudeignore文件
echo -e "node_modules/\ndist/\n*.log\n.env" > .claudeignore

智能使用Think模式

# 简单问题 - 基础模式
think 这个变量名合适吗

# 中等复杂度 - 深度模式  
think hard 设计这个数据库表结构

# 高复杂度 - 极致模式（谨慎使用）
ultrathink 设计整个系统架构

使用统计监控

# 查看使用情况
claude stats

# 查看当前对话Token数
claude token-count

# 设置使用限额
claude set-limit --daily 5000

🛠️ 常见问题速查手册

安装问题

问题：命令未找到

# 解决方案
npm config get prefix
# 将输出路径添加到PATH环境变量
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

问题：权限错误

# 解决方案
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile

认证问题

问题：认证失败

# 检查并重新安装
claude mcp test server_name
claude mcp remove server_name
claude mcp add server_name ...

# 重新认证
claude logout
claude init

# 手动认证
claude auth login --manual

网络问题

问题：连接超时

# 设置代理
export HTTP_PROXY=http://127.0.0.1:1080
export HTTPS_PROXY=http://127.0.0.1:1080

# 使用国内镜像
npm config set registry https://registry.npmmirror.com

MCP问题

问题：MCP服务器启动失败

🚀 进阶实战技巧

1. 批量操作

# 批量重命名
claude "将所有.js文件改为.ts文件"

# 批量重构
claude "将所有的var改为const"

# 批量测试
claude "为所有工具函数生成测试用例"

2. 多语言支持

# 代码翻译
claude "将这些Python函数翻译成JavaScript"

# 文档翻译
claude "将README翻译成中文"

# 注释翻译
claude "将所有英文注释翻译成中文"

3. 学习新技术

# 学习新框架
claude "教我使用Next.js 14的新特性"

# 学习新语言
claude "帮我用Rust重写这个Python函数"

# 学习新工具
claude "教我使用Docker部署这个应用"

📚 完整命令速查

基础命令

claude                    # 启动交互模式
claude -p "任务描述"      # 快速执行任务
claude -c                 # 继续上次对话
claude -r                 # 选择历史对话
claude --help            # 查看帮助

高级选项

claude --dangerously-skip-permissions    # 跳过权限确认
claude --debug                          # 调试模式
claude --quiet                         # 静默模式
claude --auto-compact                  # 自动压缩对话

会话命令

/compact        # 压缩对话
/clear          # 清除历史  
/history        # 查看历史
/edit          # 编辑记忆
/model         # 切换模型
/exit          # 退出

🎯 立即开始你的AI编程之旅

今日练习任务

1. ✅ 安装Claude Code并完成认证

2. ✅ 配置你的用户记忆文件

3. ✅ 安装文件系统MCP服务器

4. ✅ 使用Think模式分析一个现有项目

5. ✅ 让Claude帮你写一个实用工具函数

进阶挑战

• 🔄 将Claude集成到你的日常开发流程中

• 🔄 配置项目专属的记忆文件

• 🔄 建立团队的Claude使用规范

• 🔄 开发自定义MCP服务器

最佳实践提醒

• 🎯 精准描述：提供详细的需求背景

• 🎯 分步进行：复杂任务拆分成小步骤

• 🎯 及时反馈：告诉Claude生成的代码是否满意

• 🎯 善用记忆：配置好记忆文件提升效率

• 🎯 成本意识：合理使用Think模式

现在就开始吧！打开终端，输入 claude，开启你的AI编程新纪元！ 🚀