1
2
3
4
5
6
7
8
9
10
11

# 1. 确保已安装 Node.js（v18+）
node --version
# 2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 3. 验证安装
claude --version
# 4. 启动并认证
claude

1
2
3
4
5
6
7
8

# 快速执行任务
claude -p "创建一个 Python 快速排序函数"
# 跳过权限确认（提高效率）
claude --dangerously-skip-permissions
# 继续上次对话
claude --continue

1
2
3
4
5
6
7
8

# 在 PowerShell（管理员模式）中运行
wsl --install
# 查看可用发行版
wsl --list --online
# 安装特定发行版（推荐 Ubuntu）
wsl --install -d Ubuntu

1
2
3
4
5

# 重启后，在 WSL 终端中更新系统
sudo apt update && sudo apt upgrade -y
# 安装必要工具
sudo apt install -y curl wget git build-essential

1
2
3
4
5
6
7

# 使用 NodeSource 仓库（推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
npm --version

1
2
3
4
5

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

1
2
3
4
5
6
7
8

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node@20
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

1

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

1
2
3
4
5
6
7
8
9

# 更新包列表
sudo apt update
# 安装 Node.js
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

1
2
3
4
5
6

# 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install nodejs
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

1
2
3
4
5

# 安装 Node.js
sudo pacman -S nodejs npm
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

1
2
3
4
5
6
7
8
9

# 检查版本
claude --version
# 输出：Claude Code v1.0.0
# 检查帮助
claude --help
# 测试基本功能
claude -p "echo 'Hello Claude Code'"

1
2
3
4
5
6
7

# 启动 Claude Code
claude
# 系统提示：
# Welcome to Claude Code!
# To get started, you need to authenticate with your Anthropic account.
# Press Enter to open your browser and complete authentication...

1
2
3
4
5

# 手动初始化
claude init
# 如果浏览器无法自动打开
claude auth login --manual

1
2

✓ Authentication successful!
✓ Claude Code is ready to use.

1
2
3
4
5
6
7
8

# 设置 API 密钥（如果需要）
export ANTHROPIC_API_KEY=your_api_key
# 设置自定义模型
export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022
# 设置基础 URL（用于代理）
export ANTHROPIC_BASE_URL=https://your-proxy.com/v1

1
2
3
4
5
6

# 添加到 shell 配置文件
echo 'export ANTHROPIC_API_KEY=your_api_key' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022' >> ~/.bashrc
# 重新加载配置
source ~/.bashrc

1
2
3
4
5
6
7

# 设置代理
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
# 设置 npm 代理
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

1
2
3
4
5

# 使用淘宝 npm 镜像
npm config set registry https://registry.npmmirror.com
# 临时使用镜像安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 跳过权限确认（危险但高效）
claude --dangerously-skip-permissions
# 指定配置文件
claude --config /path/to/config.json
# 调试模式
claude --debug
# 静默模式
claude --quiet
# 指定工作目录
claude --cwd /path/to/project

1

用户：think 这个函数有什么问题？

1

用户：think hard 设计一个高并发的用户认证系统

1

用户：ultrathink 分析这个分布式系统的性能瓶颈并提出优化方案

1
2
3
4
5
6
7
8

# 基本语法
claude mcp add <名称> [选项] -- <命令> [参数...]
# 添加文件系统访问
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects
# 添加 GitHub 集成
claude mcp add github -s user -e GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
      "env": {}
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

1

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects ~/Desktop

1

claude mcp add github -s user -e GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

1

claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

1

claude mcp add postgres -s user -e DATABASE_URL=postgresql://user:pass@localhost/db -- npx -y @modelcontextprotocol/server-postgres

1

claude mcp add fetch -s user -- npx -y @kazuph/mcp-fetch

1

claude mcp add search -s user -e BRAVE_API_KEY=your_key -- npx -y @modelcontextprotocol/server-brave-search

1

claude mcp add slack -s user -e SLACK_TOKEN=your_token -- npx -y @modelcontextprotocol/server-slack

1

claude mcp add time -s user -- npx -y @modelcontextprotocol/server-time

1

claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory

1

claude mcp add thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking

1
2
3
4
5
6
7
8
9
10
11

# 查看已安装的 MCP 服务器
claude mcp list
# 删除 MCP 服务器
claude mcp remove <server_name>
# 测试 MCP 服务器
claude mcp test <server_name>
# 查看 MCP 状态
/mcp

1

API Error 400: "tools.11.custom.name: String should match pattern '^[a-zA-Z0-9_-]{1,64}'"

1

MCP server 'my-server' not found

1

Error: Cannot find module 'C:UsersusernameDocuments'

1
2

# 正确方式
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem C:/Users/username/Documents

1
2
3
4
5
6
7
8
9

# 启用调试模式
claude --mcp-debug
# 查看日志文件
tail -f ~/Library/Logs/Claude/mcp*.log  # macOS
type "%APPDATA%\Claude\logs\mcp*.log"   # Windows
# 手动测试服务器
npx -y @modelcontextprotocol/server-filesystem ~/Documents

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 用户偏好设置
## 编程语言偏好
- 主要语言：Python, JavaScript, TypeScript
- 框架偏好：React, FastAPI, Express
## 代码风格
- 缩进：4个空格
- 变量命名：camelCase（JS）, snake_case（Python）
- 函数命名：动词开头，描述性强
- 注释：中文，详细说明

## 开发环境
- 编辑器：VS Code, Cursor
- 终端：zsh with oh-my-zsh
- 版本控制：Git with conventional commits

## 工作习惯
- 测试驱动开发（TDD）
- 代码审查必须
- 文档先行
- 安全第一

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# 项目配置
## 项目信息
- 项目名称：电商平台 API
- 技术栈：Node.js + Express + PostgreSQL + Redis
- 开发环境：Node 20.x, npm 10.x
- 部署环境：Docker + Kubernetes
## 架构说明
- 采用微服务架构
- API 网关：Kong
- 认证：JWT + Redis session
- 数据库：主从分离，读写分离
## 编码规范
- ESLint + Prettier
- 函数命名：camelCase
- 文件命名：kebab-case
- 提交信息：Conventional Commits
## 环境变量
- DATABASE_URL：数据库连接
- REDIS_URL：Redis 连接
- JWT_SECRET：JWT 密钥
- API_PORT：API 端口（默认3000）
## 常用命令
- 启动开发：`npm run dev`
- 运行测试：`npm test`
- 构建项目：`npm run build`
- 数据库迁移：`npm run migrate`
- 代码检查：`npm run lint`
## 注意事项
- 数据库操作必须使用事务
- 异步操作要有错误处理
- 日志记录要详细
- 监控告警要及时

1
2
3
4
5
6
7
8
9
10
11

# 编辑用户记忆
/edit
# 编辑项目记忆（在项目目录中）
/edit project
# 查看当前记忆内容
claude "显示我的偏好设置"
# 更新记忆内容
claude "记住我喜欢使用 TypeScript 而不是 JavaScript"

1
2
3
4
5
6
7
8

# 分析整个项目
claude "分析这个项目的架构，给出改进建议"
# 分析特定目录
claude "分析 src/components 目录的组件设计"
# 生成架构图
claude "为这个项目生成 Mermaid 架构图"

1
2
3
4
5
6
7
8

# 重构为设计模式
claude "将这个类重构为单例模式"
# 性能优化
claude "优化这个函数的性能，减少时间复杂度"
# 代码清理
claude "清理这个文件中的重复代码"

1
2
3
4
5
6
7
8

# 生成单元测试
claude "为 src/utils/auth.js 生成完整的单元测试"
# 生成集成测试
claude "为用户注册 API 生成集成测试"
# 测试覆盖率分析
claude "分析测试覆盖率，找出未测试的代码"

1
2
3
4
5
6
7
8

# 生成 API 文档
claude "为所有 API 端点生成 OpenAPI 3.0 文档"
# 生成 README
claude "为这个项目生成详细的 README.md"
# 生成代码注释
claude "为所有公共函数添加 JSDoc 注释"

1
2
3
4
5
6
7
8

# 智能提交
claude "分析代码变更，生成合适的 commit message"
# 代码审查
claude "审查这个 PR 的代码变更"
# 分支管理
claude "创建 feature 分支并实现用户登录功能"

1
2
3
4
5
6
7
8

# 设计数据库
claude "为电商系统设计数据库表结构"
# 生成迁移文件
claude "生成用户表的数据库迁移文件"
# 查询优化
claude "优化这个 SQL 查询的性能"

1
2
3
4
5
6
7
8

# 生成 Dockerfile
claude "为这个 Node.js 项目生成优化的 Dockerfile"
# Kubernetes 配置
claude "生成 Kubernetes 部署配置文件"
# CI/CD 流水线
claude "创建 GitHub Actions 工作流"

1
2
3
4
5
6
7
8

# 日志分析
tail -f app.log | claude -p "分析错误日志，找出问题根源"
# 性能分析
claude "分析这个性能报告，找出瓶颈"
# 内存泄漏检测
claude "检查这个代码是否有内存泄漏"

1
2
3
4
5
6
7
8

# 安全扫描
claude "扫描这个项目的安全漏洞"
# 依赖检查
claude "检查 package.json 中的安全漏洞"
# 代码安全
claude "审查这个代码的安全性"

1
2
3
4
5
6
7
8

# 国际化
claude "为这个 React 应用添加 i18n 支持"
# 翻译
claude "将这些英文注释翻译成中文"
# 本地化
claude "为中国用户优化这个应用"

1
2
3
4
5

# 定期压缩对话
/compact
# 自动压缩（推荐）
claude --auto-compact

1
2
3
4
5

# 指定具体文件
claude "修复 src/auth.js 中的 bug"
# 而不是
claude "修复认证相关的 bug"

1
2
3
4
5

# 创建 .claudeignore 文件
echo "node_modules/" >> .claudeignore
echo "dist/" >> .claudeignore
echo "*.log" >> .claudeignore
echo ".env" >> .claudeignore

1
2
3
4
5
6
7
8

# 查看使用统计
claude stats
# 查看当前对话 Token 数
claude token-count
# 设置使用限制
claude set-limit --daily 1000

1
2
3
4
5
6
7
8
9
10
11

# 更新包列表
pkg update && pkg upgrade
# 安装必要工具
pkg install nodejs git openssh
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 配置存储权限
termux-setup-storage

1
2
3
4
5
6
7

# 安装 oh-my-zsh
pkg install zsh
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
# 配置快捷键
mkdir ~/.termux
echo "extra-keys = [['ESC','/','-','HOME','UP','END','PGUP'],['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']]" > ~/.termux/termux.properties

1
2
3
4
5

# 安装 Node.js
apk add nodejs npm
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

1
2
3
4
5

# 连接到远程服务器
ssh user@your-server.com
# 在服务器上使用 Claude Code
claude

1
2
3
4
5
6
7
8
9

# 检查 PATH
echo $PATH
# 查看 npm 全局路径
npm config get prefix
# 添加到 PATH
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

1
2
3
4
5

# 设置 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile

1
2
3
4
5
6
7
8
9

# 检查网络
ping anthropic.com
# 设置代理
export HTTP_PROXY=http://proxy:port
export HTTPS_PROXY=http://proxy:port
# 使用镜像源
npm config set registry https://registry.npmmirror.com

1
2
3
4
5
6
7
8

# 清除认证信息
claude logout
# 重新认证
claude init
# 手动认证
claude auth login --manual

1
2
3
4
5

# 检查环境变量
echo $ANTHROPIC_API_KEY
# 重新设置
export ANTHROPIC_API_KEY=your_new_key

1
2
3
4
5
6
7
8

# 清理缓存
claude cache clear
# 压缩对话
/compact
# 限定范围
claude "只分析 src 目录"

1
2
3
4
5

# 重启 Claude Code
claude restart
# 清理日志
claude logs clear

1
2
3
4
5
6
7
8
9

# 检查服务器状态
claude mcp test <server_name>
# 查看错误日志
claude mcp logs <server_name>
# 重新安装服务器
claude mcp remove <server_name>
claude mcp add <server_name> ...

1
2
3
4
5
6
7
8

# 检查 MCP 列表
claude mcp list
# 重启 MCP 服务
claude mcp restart
# 检查权限
ls -la ~/.claude.json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 跳过权限确认
claude --dangerously-skip-permissions
# 指定配置文件
claude --config /path/to/config.json
# 调试模式
claude --debug
# 静默模式
claude --quiet
# 指定工作目录
claude --cwd /path/to/project
# 自动压缩
claude --auto-compact
# MCP 调试
claude --mcp-debug

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 添加 MCP 服务器
claude mcp add <name> [options] -- <command> [args...]
# 删除 MCP 服务器
claude mcp remove <name>
# 列出 MCP 服务器
claude mcp list
# 测试 MCP 服务器
claude mcp test <name>
# 查看 MCP 日志
claude mcp logs <name>
# 重启 MCP 服务
claude mcp restart [name]

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 初始化认证
claude init
# 登录
claude auth login
# 登出
claude auth logout
# 查看认证状态
claude auth status
# 刷新 token
claude auth refresh

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 查看配置
claude config show
# 设置配置
claude config set <key> <value>
# 重置配置
claude config reset
# 导出配置
claude config export > config.json
# 导入配置
claude config import config.json

1
2
3
4
5
6
7
8

# 清理缓存
claude cache clear
# 查看缓存大小
claude cache size
# 缓存统计
claude cache stats

1
2
3
4
5
6
7
8

# 查看日志
claude logs show
# 清理日志
claude logs clear
# 日志级别
claude logs level debug|info|warn|error

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 2. 完成认证
claude init
# 3. 添加基础 MCP 服务器
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents
# 4. 配置记忆文件
/edit
# 5. 体验 Think 模式
think 创建一个 React 组件