Joseph19820124claude-code-guide Claude Code 完整使用指南 - AI编程助手工具的详细教程和最佳实践 --知识铺

1
2
3
4
5
6
7
8
9

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

# 验证安装
claude --version

# 导航到项目目录并启动
cd your-project-directory
claude

1
2
3

# 在PowerShell中以管理员身份运行
wsl --install
# 重启计算机并设置Ubuntu

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# Ubuntu/Debian/WSL用户
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# macOS用户(使用Homebrew)
brew install node

# 验证安装
node --version
npm --version

1
2
3
4
5
6
7
8
9

# 创建全局包目录
mkdir -p ~/.npm-global

# 配置npm使用新目录
npm config set prefix ~/.npm-global

# 添加到PATH环境变量(添加到~/.bashrc, ~/.zshrc, 或 ~/.profile)
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

1
2
3
4
5

# 全局安装Claude Code(不要使用sudo)
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

1
2
3
4
5

# 导航到项目目录
cd your-project-directory

# 启动Claude Code进行首次设置
claude

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

# 导航到项目目录
cd /path/to/your/project

# 启动交互模式
claude

# 使用特定模型启动
claude --model claude-opus-4

# 继续之前的对话
claude --continue

# 打印模式(非交互式)
claude -p "your prompt here"

1
2
3
4
5

claude
> 我们的身份验证系统是如何工作的？
> 主要的数据模型有哪些？
> 解释一下主要的架构模式
> 总结这个项目的结构

1
2
3
4

> 重构client.py中的代码
> 为这个函数添加文档
> 修复auth模块中的类型错误
> 创建一个用于用户登录的新组件

1
2
3
4

> 提交我的更改
> 创建一个PR
> 在main分支上进行rebase并解决冲突
> 哪个提交添加了markdown的测试？

1
2
3
4

> 运行测试并修复任何失败的测试
> 为登录函数添加单元测试
> 修复这个文件中的代码检查错误
> 优化这个函数的性能

1
2
3
4
5
6
7
8
9

# 创建新项目目录
mkdir claude-code-hello-world
cd claude-code-hello-world

# 初始化git仓库
git init

# 启动Claude Code
claude

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 获取项目概览
> 总结这个项目

# 创建简单的Python hello world程序
> 创建一个简单的Python hello world程序

# 创建JavaScript版本
> 创建一个hello world程序并保存为hello.js

# 创建文档
> 创建一个README.md文件来解释这个项目

1
2
3
4
5
6
7
8

# 创建更复杂的版本
> 创建一个Python程序，每秒打印"Hello World"持续30秒，并在每第5次迭代时打印"Goodbye"

# 重构代码
> 重构hello world程序使其更模块化并添加适当的文档

# 添加错误处理
> 为hello world程序添加错误处理和日志记录

1
2
3
4
5
6
7
8

# 创建Web应用程序演示
> 创建一个简单的Web应用程序，包含HTML、CSS和JavaScript，显示一个问候表单

# 创建Python包结构
> 为计算器库创建Python包结构，包含适当的__init__.py文件和文档

# 创建React组件演示
> 创建一个React组件，显示带有增加和减少按钮的计数器

1
2
3
4
5
6
7
8

# 从现有代码开始
> 分析这个代码文件并建议改进

# 应用重构
> 重构这个函数以提高可读性和性能

# 添加文档
> 为这些代码添加全面的文档字符串和注释

1
2
3
4
5
6
7
8

# 识别问题
> 分析这个代码的潜在错误和问题

# 修复特定错误
> 修复这个Python文件中的导入错误

# 运行测试
> 为这个函数创建并运行单元测试

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 检查git状态
> 当前的git状态是什么？

# 创建提交
> 用描述性消息提交我的更改

# 创建拉取请求
> 为这个功能创建一个拉取请求

# 解决合并冲突
> 帮助我解决这个合并冲突

1
2
3
4

# 首先编写测试
> 基于预期的输入/输出对为这个功能编写测试
> 实现代码使测试通过
> 重构代码保持测试通过

1
2

> think hard about the best architecture for this microservices system
> ultrathink about optimizing this database query performance

1
2
3
4
5
6
7

# Claude Code项目设置
- **分支命名**: 使用`feature/`, `bugfix/`前缀
- **环境**: 使用pyenv和Python 3.9
- **构建**: `npm run build`
- **测试**: `npm test`
- **代码检查**: `npm run lint && npm run typecheck`
- **注意**: 忽略legacy/auth模块中的废弃警告

1
2
3
4
5
6

echo "分析这段代码的性能并建议三个具体的优化方案：" > .claude/commands/optimize.md
echo "查找并修复问题 #$ARGUMENTS" > .claude/commands/fix-issue.md

# 使用方法
/project:optimize
/project:fix-issue 123

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

# .pre-commit-config.yaml示例
repos:
  - repo: local
    hooks:
      - id: lint
        name: Lint code
        entry: npm run lint
        language: system
      - id: test
        name: Run tests
        entry: npm test
        language: system

1
2
3
4
5

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

1
2
3
4
5
6
7

# 对于平台检测问题
npm config set os linux
npm install -g @anthropic-ai/claude-code --force --no-os-check

# 对于Node.js路径问题
which npm && which node  # 应该指向/usr/路径，而不是/mnt/c/
# 如果指向Windows，通过Linux包管理器或nvm安装Node

1
2
3
4
5
6
7

# 在任务之间频繁使用/clear命令
> /clear

# 使用/compact命令总结对话历史
> /compact

# 为不同任务启动新会话以避免上下文污染

1
2
3
4
5
6
7
8
9

# 监控对话大小
/compact  # 总结对话历史

# 为简单任务使用轻量级模型
# 主要模型: Claude 4 (Sonnet/Opus) 用于复杂推理
# Haiku模型: 用于后台任务和简单操作

# 主动重置对话
/clear    # 在主要任务之间清除上下文窗口

1
2
3
4
5
6
7
8
9

# 专注于特定目录/模块
> 只分析src/components/目录中的文件

# 使用带有glob模式的目标文件搜索
> 查找所有*.py文件中的身份验证相关代码

# 使用git worktrees创建专注的工作分支
git worktree add ../feature-branch feature-branch
cd ../feature-branch && claude

1
2
3
4
5

# 启用IDE特定功能
/ide  # 在Claude Code中运行此命令连接到IDE

# 在IDE vs终端中配置diff查看
/config

1
2
3

# 通过Claude Code安装GitHub app
claude
/install-github-app

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

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "审查这个PR的代码质量和安全问题"

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

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/path/to/project"]
    },
    "puppeteer": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-puppeteer"]
    }
  }
}

1
2
3
4
5
6
7
8

# 安装文件系统访问
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

# 安装浏览器自动化
claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

# 安装顺序思考
claude mcp add sequential-thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking