Claude Code 2025最全使用指南：安装、配置、生产力加速实战

# 检查当前 Node.js 版本
node --version

# 如果没有安装 Node.js，或者版本低于 18，使用 nvm 安装
# 先安装 nvm（如果你还没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 然后安装 Node.js 18+
nvm install 18
nvm use 18
node --version  # 应该显示 v18.x.x

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

# 验证安装成功
claude --version

# 预期输出类似：@anthropic-ai/claude-code/0.4.12 linux-x64 node-v18.19.0

# 方式一：设置环境变量（推荐）
# 在 ~/.bashrc 或 ~/.zshrc 中添加：
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx-your-key-here"

# 使配置生效
source ~/.bashrc  # 如果用的是 bash
# 或者
source ~/.zshrc   # 如果用的是 zsh

# 方式二：首次运行时会提示输入 API Key
# 运行 claude 命令后，它会引导你输入

# 在当前目录启动 Claude Code
claude

# 指定项目目录启动
claude /path/to/your/project

# 直接执行一条指令（不进入交互模式）
claude --print "解释这段代码的作用" --input-files src/utils.js

# 查看所有可用命令
claude --help

# 进入项目目录
cd /your/project

# 启动 Claude Code
claude

# 看到类似这样的提示：
# ┌─────────────────────────────────────────────┐
# │  Claude Code v0.4.12                        │
# │  当前目录: /your/project                    │
# │  输入你的指令，或输入 /help 查看帮助        │
# └─────────────────────────────────────────────┘

# 现在你可以输入自然语言指令了，比如：
# "帮我重构 src/auth/login.ts，把验证逻辑抽取出来"

# 直接在指令中要求读取
# "读取 src/config/index.ts 的内容"

# Claude 会使用 Read 工具读取文件
# 你也可以用 /read 命令
/read src/config/index.ts

# 直接在指令中要求创建或修改
# "在 src/utils 目录下创建 format.ts，包含日期格式化和数字格式化函数"

# Claude 会使用 Write 工具创建文件
# 或者用 Edit 工具修改现有文件

# "找到所有 .test.ts 文件"
# "找到 src/components 目录下所有 React 组件"
# "列出当前目录下所有配置文件"

# 执行单条命令
# "运行 npm run build 看有没有报错"

# Claude 会执行命令并分析输出
# 如果有错误，会帮你排查

# 执行多条命令（用 ; 或 && 连接）
# "先 git status，再 git log --oneline -5"

# 查看进程和资源
# "查看当前 Node.js 进程"
# "查看磁盘使用情况"

# "查看当前 git 状态"
# "帮我创建一个新分支 feature/user-auth"
# "比较 main 和 feature/user-auth 的差异"
# "审查最近的 5 个提交"
# "帮我解决当前的合并冲突"

# 启动 Claude Code
claude

# 输入指令
审查 src/auth/目录下最近修改的文件，重点检查：
1. 是否有 SQL 注入风险
2. 密码是否明文存储
3. 错误处理是否完善

# Claude 会：
# 1. 读取 src/auth/ 目录下的文件
# 2. 分析代码中的安全风险
# 3. 给出具体的安全改进建议

# 项目根目录的 claude.md 示例

## 项目概述
这是一个使用 Next.js 14 + TypeScript 构建的电商后台管理系统。

## 技术栈
- 前端框架：Next.js 14（App Router）
- 语言：TypeScript 5.x
- 样式：Tailwind CSS 3.x
- 状态管理：Zustand
- API：REST + tRPC

## 代码规范
- 所有组件必须使用 TypeScript，禁用 any 类型
- 组件文件放在 src/components 目录
- 业务逻辑放在 src/services 目录
- 测试文件与源码同目录，命名 xxx.test.ts

## Git 工作流
- 使用 Git Flow 分支模型
- feature 分支从 develop 创建
- 合并前必须通过所有测试

## 禁止事项
- 不要修改 node_modules
- 不要提交 .env 文件（已加入 .gitignore）
- 禁止直接操作数据库，必须通过 API

# API 配置
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx    # Anthropic API Key
ANTHROPIC_BASE_URL=https://api.anthropic.com  # API 端点（默认）

# 模型配置
ANTHROPIC_MODEL=claude-sonnet-4-20250514  # 使用的模型（默认 claude-3-5-sonnet）
ANTHROPIC_MAX_TOKENS=4096                   # 单次回复最大 token 数

# 本地模型配置（如果你用 Ollama 等本地模型）
ANTHROPIC_BASE_URL=http://localhost:11434/v1  # 本地模型 API 地址
ANTHROPIC_API_KEY=ollama  # Ollama 不需要真正的 key，随便填

# Claude Code 行为配置
CLAUDE_CODE_VERBOSE=true    # 启用详细日志
CLAUDE_CODE_NO_STREAM=true   # 禁用流式输出
CLAUDE_CODE_AUTO_APPROVE=false  # 禁止自动批准危险操作

# 步骤1：安装 Ollama
# macOS/Linux
curl -fsSL https://ollama.com/install.sh | sh

# Windows: 从 https://ollama.com/download 下载安装

# 步骤2：下载模型
ollama pull llama3.2  # 3GB 左右
ollama pull codellama  # 代码专用模型

# 步骤3：启动 Ollama 服务
ollama serve
# 默认在 http://localhost:11434 运行

# 步骤4：配置 Claude Code 使用本地模型
export ANTHROPIC_BASE_URL=http://localhost:11434/v1
export ANTHROPIC_API_KEY=ollama  # 随意填，Ollama 不验证
export ANTHROPIC_MODEL=codellama

# 步骤5：启动 Claude Code
claude

# 代码重构
"将 src/utils/format.ts 重构成纯函数形式，移除所有副作用"

# Bug 排查
"我运行 npm test 时这个测试失败了：xxx，分析原因并修复"

# 代码审查
"审查 src/api/users.ts，重点检查：
- 输入验证是否完善
- 错误处理是否恰当
- 是否有安全漏洞"

# 生成测试
"为 src/services/order.ts 中的所有导出函数生成单元测试，
测试覆盖率要达到 80% 以上"

# 解释代码
"用中文详细解释 src/components/Modal.tsx 的实现逻辑，
包括所有 props 的作用和状态管理方式"

# 一次性处理多个文件
"重构 src/features/auth 目录下的所有文件，
将重复的验证逻辑抽取到 src/utils/validation.ts 中"

# 批量重命名
"将 src/components 目录下所有 Button.tsx 重命名为 index.tsx，
同时更新所有引用"

# 批量替换
"将所有 .js 文件中的 console.log 替换为使用自定义 logger"

# 对比两个文件
"比较 src/v1/auth.ts 和 src/v2/auth.ts 的差异，
重点关注安全相关的改动"

# 对比 git 分支
"比较 main 和 develop 分支的差异，
列出所有新增的 API 端点"

# 错误信息类似：
# Error: Anthropic API error: invalid_api_key

# 解决方法：
# 1. 检查 API Key 是否正确
echo $ANTHROPIC_API_KEY

# 2. 检查账户余额
#    登录 https://console.anthropic.com 查看账单

# 3. 如果是额度问题，考虑使用本地模型
#    参考 5.3 节配置 Ollama

# 错误信息：
# Error: Request timeout after 30000ms

# 解决方法：
# 1. 检查网络
curl -I https://api.anthropic.com

# 2. 配置代理（如果你在大陆）
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

# 3. 使用本地模型绕过网络需求

# 错误信息：
# Permission denied: /some/path

# 解决方法：
# 1. 检查文件权限
ls -la /some/path

# 2. 修复权限
chmod 644 /some/path  # 文件
chmod 755 /some/dir   # 目录

# 3. 如果是 Claude Code 自身权限问题
#    检查 Claude Code 是否有执行权限
chmod +x $(which claude)

# 可能原因和解决方法：

# 原因1：本地模型性能不足
# 解决：切换到更强的本地模型或使用云端 API
export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022

# 原因2：网络延迟
# 解决：使用代理或本地部署

# 原因3：请求上下文太长
# 解决：减少对话历史，或指定只分析部分文件
claude --print "分析 src/core 模块的架构" --input-files src/core/