Claude Code 使用指南：从入门到高效开发

1
2
3
4
5

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

1

brew install --cask claude-code

1

winget install Anthropic.ClaudeCode

1

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

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

# 交互式会话（REPL）
claude

# 带初始提问启动
claude "解释这个项目的架构"

# 单次查询后退出（适合脚本调用）
claude -p "review this code"

# 管道输入
cat logs.txt | claude -p "分析这些错误"

# 继续最近的对话
claude -c

# 恢复指定会话
claude -r "session-id" "继续上次的工作"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 引用单个文件
> 审查这个组件的代码 @./src/components/Button.tsx

# 引用整个目录
> 为所有 API 路由添加错误处理 @./src/api/

# 引用多个文件
> 比较这两个实现 @./src/old.js @./src/new.js

# 通配符
> 审查所有测试文件 @./src/**/*.test.ts

1
2
3
4

> !npm test

# 进入 shell 模式（再输一次 ! 退出）
> !

1
2
3
4
5

# 会话内切换
/model

# 命令行指定
claude --model claude-opus-4

1
2
3
4
5

# 项目规范
- 所有新代码使用 TypeScript
- 遵循现有的 ESLint 配置
- React 组件使用函数式组件 + Hooks
- 测试文件放在源文件旁边，命名为 .test.ts

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

{
  "permissions": {
    "allowedTools": [
      "Read",
      "Write(src/**)",
      "Bash(git *)",
      "Bash(npm *)"
    ],
    "deny": [
      "Read(.env*)",
      "Write(production.config.*)",
      "Bash(rm *)"
    ]
  }
}

1
2

mkdir -p .claude/commands
echo "分析这段代码的性能问题并提出优化建议" > .claude/commands/optimize.md

1
2

<!-- .claude/commands/fix-issue.md -->
按照我们的编码规范修复 issue #$ARGUMENTS

1
2

> /agents
# 按提示定义名称、描述、模型和人设

1
2
3
4
5
6

---
name: reviewer
description: 用于代码审查
model: sonnet
---
你是一个专业的代码审查员。重点关注安全性、性能和可维护性。

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

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write(*.py)",
        "hooks": [
          {
            "type": "command",
            "command": "python -m black \"$file\""
          }
        ]
      }
    ]
  }
}

1
2

# 添加 MCP 服务器
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

1

> 分析这个代码仓库的结构并提出改进建议 @./src/

1

> 实现一个带 JWT 令牌和密码哈希的用户认证系统

1

> 调试这个错误："TypeError: Cannot read property 'id' of undefined" @./src/user-service.js

1

> 为这个模块生成完整的单元测试 @./src/utils/validation.js

1

claude -p "如果有 linting 错误，修复它们并给出 commit 建议"