Claude Code 安装、使用方法详细全解

数据来源：官方文档 (code.claude.com/docs)、ComputingForGeeks Cheat Sheet、Anthropic 官方博客、Reddit 社区

目录

  1. 概述
  2. 安装步骤
  3. 认证与授权
  4. 核心架构与工作模式
  5. CLI 命令参考
  6. 交互式 Slash 命令
  7. 键盘快捷键
  8. 配置与设置
  9. CLAUDE.md 项目指令文件
  10. 权限模式
  11. 模型与 Effort 级别
  12. MCP 服务器集成
  13. 自定义 Skills 和 Subagents
  14. Hooks 自动化触发器
  15. 上下文窗口管理
  16. Git Worktrees 并行工作
  17. Background Agents 和 Dynamic Workflows
  18. 环境变量
  19. IDE 集成
  20. 定价方案
  21. Claude Code vs Cursor vs Copilot 对比
  22. 最佳实践与使用技巧
  23. 常见问题 FAQ
  24. 总结

1. 概述

Claude Code 是 Anthropic 推出的 AI 驱动的终端 CLI 工具。它能够读取你的代码库、编辑文件、运行命令、管理 Git 工作流，一切直接在终端中完成。

核心理念：作为一个 agentic coding assistant（自主编码助手），你用自然语言描述需求，Claude Code 自动判断需要读取哪些文件、运行什么命令、做出什么改动。

关键特性：

  • 支持 Opus 4.8（默认）、Sonnet 4.6、Haiku 4.5 模型
  • 1M token 上下文窗口（Opus 4.8）
  • MCP（Model Context Protocol）扩展生态
  • 自定义 Skills 和 Subagents
  • Background Agents 后台运行
  • Git Worktrees 并行开发
  • Hooks 自动化触发器
  • Dynamic Workflows 动态工作流

官方文档：https://code.claude.com/docs
GitHub 仓库：https://github.com/anthropics/claude-code

2. 安装步骤

2.1 系统要求

  • macOS：macOS 10.15+
  • Linux：主流发行版（Ubuntu 18.04+, Debian 10+, CentOS 7+）
  • Windows：WSL 2（推荐）或原生 PowerShell
  • Node.js：内置 bundling，无需单独安装
  • 网络：需要访问 Anthropic API

2.2 安装方法

方法一：一键安装脚本（推荐，适用于 macOS/Linux/WSL）
curl -fsSL https://claude.ai/install.sh | bash

安装完成后执行：

claude --version
方法二：macOS Homebrew
brew install --cask claude-code
方法三：Windows PowerShell（原生）
irm https://claude.ai/install.ps1 | iex
方法四：npm 全局安装
npm install -g @anthropic-ai/claude-code
方法五：安装特定版本
claude install stable      # 安装最新稳定版
claude install latest      # 安装最新版
claude install 2.1.118     # 安装指定版本
方法六：更新
claude update

2.3 验证安装

# 检查版本
claude --version

# 检查认证状态
claude auth status

# 首次认证
claude auth login

2.4 Docker 环境安装

在容器中安装时，需要注意：

  • 确保容器有网络访问权限
  • 使用 claude auth login --console 进行 API 认证
  • 设置 ANTHROPIC_API_KEY 环境变量
# 在 Docker 容器内
curl -fsSL https://claude.ai/install.sh | bash
export ANTHROPIC_API_KEY="your-api-key"
claude auth status

3. 认证与授权

3.1 认证方式

Claude Code 支持三种认证路径：

方式 命令 适用场景
Claude 订阅 claude auth login 使用 Pro/Max 订阅
API 付费 claude auth login --console 按 token 付费
SSO claude auth login --sso 企业 SSO
指定邮箱 claude auth login --email user@example.com 多账号切换

3.2 认证状态检查

# JSON 格式输出
claude auth status

# 人类可读格式
claude auth status --text

# 退出登录
claude auth logout

3.3 API Key 认证（替代方式）

# 设置环境变量
export ANTHROPIC_API_KEY="sk-ant-..."
export ANTHROPIC_API_KEY_FILE="~/.anthropic/api_key"

# 然后启动 Claude Code
claude

4. 核心架构与工作模式

4.1 工作模式

Claude Code 支持多种工作模式：

┌─────────────────────────────────────────────┐
│           Claude Code 架构                    │
├─────────────────────────────────────────────┤
│                                             │
│  User (Terminal)                             │
│      │                                      │
│      ▼                                      │
│  Claude Code CLI Agent                       │
│  ┌──────────────────────┐                   │
│  │   System Prompt      │                   │
│  │   CLAUDE.md          │                   │
│  │   Settings           │                   │
│  └──────────┬───────────┘                   │
│             │                               │
│     ┌───────┼───────┐                       │
│     ▼       ▼       ▼                       │
│  Tools  MCP Tools  Skills                    │
│  ┌────┐  ┌────┐  ┌────┐                    │
│  │Bash│  │DB  │  │Git │                    │
│  │File│  │Web │  │Dep │                    │
│  │Git │  │... │  │... │                    │
│  └────┘  └────┘  └────┘                    │
│             │                               │
│             ▼                               │
│  Anthropic API (Claude models)              │
│  Opus 4.8 / Sonnet 4.6 / Haiku 4.5          │
└─────────────────────────────────────────────┘

4.2 内置工具

Claude Code 内置多种工具，无需额外配置：

工具类别 功能
Bash 执行任意 shell 命令
Read 读取文件内容
Write 创建/覆盖文件
Edit 精确文件编辑（基于 patch）
MultiEdit 批量多文件编辑
Glob 文件搜索（glob 模式）
Grep 代码搜索（正则）
LS 目录浏览
Task 子任务管理

4.3 权限模式

模式 说明 命令
Secure（默认） 所有写操作和命令执行需用户审批 默认行为
Allow 信任特定操作，减少审批 /permissions 配置
Auto 全自动模式，无需审批 /auto 命令

5. CLI 命令参考

5.1 启动与交互

# 交互式会话（推荐）
claude

# 带初始提示的交互式会话
claude "解释这个项目的架构"

# 非交互式查询（SDK 模式），回答后退出
claude -p "解释这个函数"

# 处理管道输入
cat logs.txt | claude -p "分析这些日志"

# 继续上次对话
claude -c

# 继续上次对话（SDK 模式）
claude -c -p "检查类型错误"

# 按 ID 或名称恢复会话
claude -r "auth-refactor" "完成这个 PR"

5.2 认证管理

claude auth login               # 登录
claude auth login --console     # API 方式登录
claude auth login --sso         # SSO 登录
claude auth login --email x@y   # 指定邮箱
claude auth logout              # 退出登录
claude auth status              # 检查状态

5.3 Subagent 管理

claude agents                   # 管理子代理配置
claude agents list              # 列出子代理
claude agents add <name>        # 添加子代理
claude agents remove <name>     # 删除子代理
claude agents edit <name>       # 编辑子代理

5.4 版本管理

claude --version                # 查看版本
claude update                   # 更新到最新版
claude install stable           # 安装稳定版
claude install 2.1.118          # 安装指定版本

5.5 常用 CLI Flags

# 模型选择
claude --model sonnet           # 使用 Sonnet 模型
claude --model haiku            # 使用 Haiku 模型
claude --model opus             # 使用 Opus 模型
claude --model claude-sonnet-4-6-20250224  # 指定具体模型版本

# 上下文控制
claude --max-turns 20           # 限制最大轮次
claude --max-input-tokens 100000  # 限制输入 token 数

# 权限控制
claude --permission-mode secure     # 安全模式（默认）
claude --permission-mode allow      # 信任模式

# 非交互式
claude -p "query"                 # 管道模式，一次查询后退出
claude --output-format json       # JSON 输出格式

# 调试
claude --debug                    # 调试模式
claude --verbose                  # 详细输出

6. 交互式 Slash 命令

在 Claude Code 交互会话中输入 / 查看完整命令列表，输入 / 加字母可过滤。

6.1 会话管理

命令 功能 示例
/quit / /exit 退出会话 /quit
/clear 清除上下文重新开始 /clear
/compact 压缩上下文，节省 token /compact
/context 查看当前上下文使用情况 /context
/cost 查看当前会话的 token 花费 /cost
/undo 撤销上一次操作 /undo
/redo 重做上一次撤销 /redo
/restore 恢复文件到之前版本 /restore src/main.py
/repo-map 生成项目结构图 /repo-map
/doctor 诊断工具，检查配置问题 /doctor
/insights 查看使用洞察和统计 /insights

6.2 模型与 Effort 控制

命令 功能 示例
/model 查看/切换当前模型 /model sonnet
/model opus 切换到 Opus 4.8 /model opus
/model sonnet 切换到 Sonnet 4.6 /model sonnet
/model haiku 切换到 Haiku 4.5 /model haiku
/effort 设置推理努力程度 /effort high
/effort low 低 effort，快速响应 /effort low
/effort medium 中等 effort（默认） /effort medium
/effort high 高 effort，深度推理 /effort high

6.3 项目配置

命令 功能 示例
/init 初始化项目，生成 CLAUDE.md /init
/config 打开配置编辑器 /config
/memory 管理项目记忆 /memory add 这是一个 React 项目
/memory show 查看记忆内容 /memory show
/memory forget 删除记忆 /memory forget 0
/permissions 管理权限规则 /permissions
/rules 查看/编辑项目规则 /rules
/skills 管理自定义 Skills /skills
/hooks 管理 Hooks 触发器 /hooks

6.4 代码工作流

命令 功能 示例
/plan [描述] 进入计划模式 /plan 重构用户认证模块
/code-review 对当前变更进行代码审查 /code-review
/diff 查看文件变更差异 /diff
/diff <file> 查看指定文件差异 /diff src/app.py
/pr 创建/管理 Pull Request /pr 添加用户认证
/commit 提交变更 /commit
/branch 创建/切换分支 /branch feature/auth

6.5 MCP 与扩展

命令 功能 示例
/mcp 管理 MCP 服务器 /mcp
/mcp add <name> 添加 MCP 服务器 /mcp add postgres
/mcp remove <name> 移除 MCP 服务器 /mcp remove postgres
/mcp list 列出已配置的 MCP 服务器 /mcp list
/mcp restart <name> 重启 MCP 服务器 /mcp restart postgres
/agents 管理子代理 /agents
/tasks 查看后台任务 /tasks

6.6 上下文与对话

命令 功能 示例
/btw [消息] 附带说明，不膨胀上下文 /btw 注意数据库连接池大小
/remind [消息] 设置提醒 /remind 30分钟后检查构建状态
/summarize 总结当前对话 /summarize
/help 显示帮助信息 /help
/help <command> 查看指定命令帮助 /help /model

6.7 高级命令

命令 功能 示例
/loop [描述] 循环执行任务（持续监控/重试） /loop 每隔5分钟检查部署状态
/batch [描述] 批量分解任务并行执行 /batch 重构所有 API 端点
/background 将会话放入后台运行 /background
/auto 切换到自动模式 /auto
/human 切换回人工审批模式 /human
/web 启用/配置 Web 搜索 /web
/ide IDE 集成设置 /ide

7. 键盘快捷键

7.1 基本快捷键

快捷键 功能
Ctrl+C 中断运行中的操作；无操作时按一次清除输入，按两次退出
Esc 中断 Claude 当前操作，保留已完成的工作
Esc + Esc 强制中断
Tab 自动补全命令和文件名
↑ / ↓ 浏览命令历史
Ctrl+R 反向搜索历史

7.2 输入编辑快捷键

快捷键 功能
Ctrl+A 光标移到行首
Ctrl+E 光标移到行尾
Ctrl+K 删除光标后的内容
Ctrl+U 删除光标前的内容
Ctrl+W 删除前一个单词
Ctrl+L 清屏

7.3 审批交互快捷键

快捷键 功能
Y / Yes 批准当前操作
N / No 拒绝当前操作
E / Edit 编辑 Claude 提出的操作
A / Always 总是批准此类操作
D / Deny 拒绝此类操作
Enter 确认选择

8. 配置与设置

8.1 配置文件位置

~/.claude/                         # 全局配置目录
├── settings.json                  # 全局设置
├── mcp.json                       # MCP 服务器配置
├── CLAUDE.md                      # 全局指令
└── sessions/                      # 会话历史

<project-root>/                    # 项目配置
├── .claude/
│   ├── settings.json              # 项目级设置
│   ├── mcp.json                   # 项目级 MCP
│   └── rules/                     # 规则文件
└── CLAUDE.md                      # 项目指令文件

8.2 settings.json 配置项

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-...",
    "API_TIMEOUT_MS": "1200000"
  },
  "permissions": {
    "allow": [
      "read:.",
      "write:src/",
      "bash:npm test",
      "bash:python"
    ],
    "deny": [
      "write:.env",
      "write:secrets/",
      "bash:sudo"
    ]
  },
  "model": "claude-sonnet-4-6-20250224",
  "hooks": {
    "postToolUse": {
      "format": {
        "patterns": ["*.py", "*.js", "*.ts"],
        "command": "black --quiet {}"
      }
    }
  },
  "attribution": {
    "enabled": true,
    "trailer": "Co-Authored-By: Claude <noreply@anthropic.com>"
  }
}

8.3 设置优先级

当同一配置项通过多种方式设置时，优先级从高到低：

  1. CLI flags（命令行参数）
  2. Environment variables（环境变量）
  3. Project settings.json（项目级配置）
  4. User settings.json（全局配置）
  5. In-session commands（会话内命令，如 /model）

8.4 托管设置（企业部署）

支持通过 MDM 工具部署配置：

  • macOS：Jamf、Kandji 等 MDM
  • Windows：组策略或 Intune（注册表 HKLM\SOFTWARE\Policies\ClaudeCode）
  • 文件方式：部署 managed-settings.json 和 managed-mcp.json 到系统目录

9. CLAUDE.md 项目指令文件

CLAUDE.md 是 Claude Code 读取的项目级指令文件，在每次会话开始时自动加载。

9.1 基本用法

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

# Project Context

This is a React + TypeScript web application using:
- React 18 with functional components and hooks
- TypeScript strict mode
- Tailwind CSS for styling
- Vite as build tool
- Jest + Testing Library for testing

## Conventions
- Use functional components with hooks
- Named exports (not default exports)
- File naming: PascalCase for components, camelCase for utilities
- Write tests for all new features
- Follow the existing code style

## Commands
- `npm run dev` - Start dev server
- `npm run test` - Run tests
- `npm run build` - Build for production
- `npm run lint` - Run linter

9.2 文件包含语法

# Main CLAUDE.md
@~/.claude/wsl2-environment.md
@~/.claude/code-standards.md
@~/.claude/security-requirements.md

9.3 HTML 注释节省 token

<!-- 这些注释在运行时被剥离，消耗 0 token -->
<!-- 用于文档说明，Claude 不会看到 -->

# Active Instructions
- Always write tests first
- Use Python type hints

9.4 /init 自动生成

首次在新项目中使用 Claude Code 时：

claude
/init

Claude 会扫描项目结构，自动生成一份 CLAUDE.md 草稿，然后可用 /memory 命令进一步细化。

10. 权限模式

10.1 权限级别

级别 描述
Secure（默认） 所有写操作和危险命令需要用户审批
Allow 可以配置特定操作的自动批准
Deny 拒绝特定操作

10.2 权限规则配置

在 settings.json 中：

{
  "permissions": {
    "allow": [
      "read:.",
      "write:src/",
      "write:test/",
      "bash:npm test",
      "bash:python -m pytest",
      "bash:git diff",
      "bash:git status"
    ],
    "deny": [
      "write:.env",
      "write:*.key",
      "bash:sudo",
      "bash:rm -rf",
      "bash:chmod 777"
    ]
  }
}

10.3 运行时审批交互

当 Claude Code 需要执行操作时，会显示审批请求：

Claude wants to:
  Edit: src/main.py

[Y]es  [N]o  [E]dit  [A]lways allow  [D]eny always

10.4 /auto 自动模式

/auto
# 切换到自动模式，无需每次审批
# 适合信任的场景，如运行测试、格式化代码

/human
# 切回人工审批模式

11. 模型与 Effort 级别

11.1 可用模型

模型 上下文窗口 输入价格 输出价格 适用场景
Opus 4.8 1M tokens $15/MTok $75/MTok 复杂多文件重构、架构设计
Sonnet 4.6 200K tokens $3/MTok $15/MTok 日常编码任务（80% 场景）
Haiku 4.5 200K tokens $0.8/MTok $4/MTok 简单查找、快速问答

MTok = Million Tokens（百万 token）

11.2 模型选择策略

简单任务 → Haiku 4.5（快速便宜）
日常编码 → Sonnet 4.6（性价比最佳）
复杂重构 → Opus 4.8（最强推理）

11.3 Effort 级别

控制 Claude 在当前任务上投入的推理深度：

级别 速度 质量 适用场景
low 快 基础 简单问答、快速查找
medium 中 良好 日常编码（默认）
high 慢 优秀 复杂问题、调试 
# 在会话中调整
/effort low     # 快速响应
/effort high    # 深度推理

# 或结合模型使用
/model sonnet
/effort high    # Sonnet + 深度推理

11.4 模型别名

别名 对应模型
opus Opus 4.8
sonnet Sonnet 4.6
haiku Haiku 4.5
opusplan Opus + plan 模式

12. MCP 服务器集成

12.1 什么是 MCP

MCP（Model Context Protocol）是 Anthropic 推出的开放协议，使 LLM 应用能够无缝集成外部数据源和工具。

12.2 配置方式

方法一：命令行添加
claude mcp add postgres \
  --command "npx" \
  --arg "-y" \
  --arg "@modelcontextprotocol/server-postgres" \
  --arg "postgresql://localhost/mydb"
方法二：mcp.json 手动配置
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    }
  }
}

12.3 常用 MCP 服务器

服务器 功能 安装命令
PostgreSQL 数据库查询 npx -y @modelcontextprotocol/server-postgres
Filesystem 文件系统访问 npx -y @modelcontextprotocol/server-filesystem
GitHub GitHub API npx -y @modelcontextprotocol/server-github
Puppeteer 浏览器自动化 npx -y @modelcontextprotocol/server-puppeteer
Fetch HTTP 请求 npx -y @modelcontextprotocol/server-fetch
Slack Slack 集成 详见官方文档
Brave Search 网络搜索 npx -y @modelcontextprotocol/server-brave-search
Context7 文档搜索 npx -y @upstash/context7-server

12.4 MCP 配置范围

范围 配置文件位置
Global ~/.claude/mcp.json
Project <project>/.claude/mcp.json
Local <project>/mcp.json

12.5 MCP 管理命令

# 在交互会话中
/mcp list              # 列出所有 MCP 服务器
/mcp add <name>        # 添加服务器
/mcp remove <name>     # 移除服务器
/mcp restart <name>    # 重启服务器

# 在 CLI 中
claude mcp add <name> --command "..." --arg "..."
claude mcp list
claude mcp remove <name>

13. 自定义 Skills 和 Subagents

13.1 Custom Skills（自定义技能）

自定义 Skills 是用户自己的 Slash 命令：

{
  "skills": {
    "test-and-commit": {
      "description": "Run tests and commit if they pass",
      "commands": [
        "npm test",
        "git add .",
        "git commit -m 'Fix: {{prompt}}'"
      ]
    },
    "deploy-staging": {
      "description": "Deploy to staging environment",
      "commands": [
        "npm run build",
        "npm run deploy:staging"
      ]
    }
  }
}

使用方式：

/skill test-and-commit "修复登录 bug"

13.2 Subagents（子代理）

Subagents 是 Claude Code 可以委派子任务的独立代理：

{
  "agents": {
    "code-reviewer": {
      "description": "Specialized code review agent",
      "model": "claude-sonnet-4-6-20250224",
      "rules": [
        "Always check for security vulnerabilities",
        "Check for proper error handling",
        "Suggest performance improvements"
      ]
    },
    "test-writer": {
      "description": "Writes and runs unit tests",
      "model": "claude-sonnet-4-6-20250224",
      "rules": [
        "Write tests before implementation",
        "Use the existing test framework",
        "Aim for 80%+ coverage"
      ]
    }
  }
}

13.3 Subagents 管理

# CLI
claude agents list
claude agents add code-reviewer --description "Code review specialist"
claude agents remove code-reviewer

# 交互会话
/agents              # 打开子代理管理器
/agents add <name>
/agents remove <name>

14. Hooks 自动化触发器

14.1 Hook 类型

Hook 触发时机 用途
preTask 任务开始前 环境检查、依赖安装
postToolUse 工具使用后 自动格式化、lint
postTask 任务结束后 运行测试、生成文档
preSend 发送消息前 消息过滤
postSend 发送消息后 日志记录

14.2 Hook 配置示例

{
  "hooks": {
    "preTask": {
      "check-deps": {
        "command": "npm install",
        "description": "Ensure dependencies are installed"
      }
    },
    "postToolUse": {
      "auto-format": {
        "patterns": ["*.py", "*.js", "*.ts"],
        "command": "black --quiet {}",
        "description": "Auto-format code after edits"
      }
    },
    "postTask": {
      "run-tests": {
        "command": "npm test",
        "description": "Run tests after completing a task"
      }
    }
  }
}

14.3 Hooks 管理

/hooks               # 查看 hooks 状态
/hooks add <name>    # 添加 hook
/hooks remove <name> # 删除 hook

15. 上下文窗口管理

15.1 上下文监控

/context              # 查看上下文使用情况

输出示例：

Context Usage:
  Input tokens:   45,230 / 200,000 (22.6%)
  Output tokens:  12,100
  Messages:       24
  Files loaded:   8

15.2 上下文优化策略

策略 命令/方法 说明
压缩上下文 /compact 总结对话历史，大幅减少 token
清除上下文 /clear 完全清空，重新开始
附带说明 /btw [msg] 临时说明，不增加上下文负担
选择性加载 精确指定文件 让 Claude 只读需要的文件

15.3 节省 Token 的技巧

  1. 使用 /btw 代替普通消息：/btw 的说明不会完整加入历史
  2. 定期使用 /compact：长时间会话后压缩上下文
  3. 精确文件引用：请查看 src/auth/login.py 而不是 查看整个项目
  4. 使用 Haiku 处理简单任务：便宜且快速
  5. 使用 HTML 注释写 CLAUDE.md 文档：注释不消耗 token

16. Git Worktrees 并行工作

16.1 什么是 Git Worktrees

Git Worktrees 允许在同一仓库中同时操作多个分支，无需切换上下文。

16.2 Claude Code 中的 Worktrees

/batch "将以下功能分别实现：
1. 用户认证 API
2. 支付处理模块
3. 通知系统"

Claude Code 会自动：

  1. 将任务分解为独立单元
  2. 为每个单元创建独立的 worktree
  3. 并行执行
  4. 合并结果

16.3 手动 Worktree 操作

# Claude Code 内部管理 worktree
/worktree create feature/auth
/worktree list
/worktree switch feature/auth

17. Background Agents 和 Dynamic Workflows

17.1 Background Agents

将会话放入后台运行，释放终端：

/background
# 当前会话在后台继续运行
# 可以 Ctrl+Z 退出终端，会话仍在运行

查看和管理后台任务：

/tasks    # 列出后台任务

17.2 Dynamic Workflows

动态工作流允许 Claude Code 根据任务需要自动调整执行策略：

/batch "重构整个用户模块"
# Claude 自动：
# 1. 分析代码库
# 2. 分解为独立任务
# 3. 分配给 worktrees 并行执行
# 4. 合并结果
# 5. 运行测试验证

17.3 /loop 循环任务

/loop "每隔5分钟检查部署状态"
/loop "持续运行测试直到通过"
/loop "监控日志中的错误并报告"

18. 环境变量

18.1 设置方式

# 临时设置（当前终端会话）
export ANTHROPIC_API_KEY="sk-ant-..."
export API_TIMEOUT_MS="1200000"
claude

# 永久设置
# 添加到 ~/.bashrc 或 ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc

# 在 settings.json 中
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-...",
    "API_TIMEOUT_MS": "1200000"
  }
}

18.2 常用环境变量

变量 说明 示例
ANTHROPIC_API_KEY API 密钥 sk-ant-...
ANTHROPIC_API_KEY_FILE API 密钥文件路径 ~/.anthropic/api_key
API_TIMEOUT_MS API 超时（毫秒） 1200000（20分钟）
CLAUDE_CODE_MODEL 默认模型 claude-sonnet-4-6-20250224
CLAUDE_CODE_BASH_TIMEOUT Bash 命令超时 300（秒）
CLAUDE_CODE_MAX_INPUT_TOKENS 最大输入 token 100000
CLAUDE_CODE_MIN_BUDGET_SEC 最小子任务预算 5（秒）
CLAUDE_CODE_MAX_BUDGET_SEC 最大子任务预算 300（秒）
CLAUDE_CODE_DISABLE_UPDATE_CHECK 禁用更新检查 true
CLAUDE_CODE_ENABLE_MCP 启用 MCP true（默认）
CLAUDE_CODE_ENABLE_LOGGING 启用详细日志 true
CLAUDE_CODE_BETA_AGENT 启用实验性 agent true

19. IDE 集成

19.1 VS Code 集成

  1. 安装 VS Code 扩展（官方提供）
  2. 在 VS Code 终端中运行 claude
  3. Claude Code 可以直接访问 VS Code 的工作区上下文

19.2 JetBrains 集成

通过终端插件：

  1. 打开 IDE 内置终端
  2. 运行 claude
  3. 支持读取 IDE 项目结构

19.3 Neovim 集成

通过终端窗口：

:terminal claude

19.4 IDE 模式

/ide
# 优化为 IDE 集成模式
# 减少全屏输出，更适合在编辑器终端中使用

20. 定价方案

20.1 定价概览

Claude Code 有三种主要的使用/计费路径：

方案 月费 适用场景
Free API Credit $0（一次性 $5 额度） 试用评估
Claude Pro $20/月 轻度到中度使用
Claude Max $100-200/月 重度使用/专业开发者
API Pay-as-you-go 按 token 计费 灵活使用量

20.2 API Token 价格

模型 输入价格 输出价格
Haiku 4.5 $0.80 / MTok $4.00 / MTok
Sonnet 4.6 $3.00 / MTok $15.00 / MTok
Opus 4.8 $15.00 / MTok $75.00 / MTok

MTok = 百万 token

20.3 免费额度详情

新注册 API 账号可获得约 $5 免费额度，无需信用卡：

模型 $5 可获取的输入 token 实际使用场景
Haiku 4.5 ~5M input tokens 大量简单会话
Sonnet 4.6 ~1.67M input tokens 数次中等会话
Opus 4.8 ~1M input tokens 少数深度会话

典型 Claude Code 会话：每次交互消耗 50,000-200,000 tokens

20.4 真实成本案例

一位开发者 8 个月使用记录：

  • 总 token 消耗：100 亿 tokens
  • 按 API 价格计算：$15,000+
  • Max 计划实际花费：约 $800（节省 93%）

20.5 降低成本的技巧

  1. 日常任务用 Sonnet 4.6，复杂任务才用 Opus 4.8
  2. 使用 /effort low 处理简单问题
  3. 定期 /compact 压缩上下文，避免 token 浪费
  4. 使用 /btw 代替普通消息减少上下文膨胀
  5. Max 计划适合重度用户（比 API 便宜 93%）
  6. Pro 计划适合轻度到中度用户

20.6 与其他工具对比

工具 月费 模式
Claude Code (Pro) $20 订阅制
Claude Code (Max) $100-200 订阅制
Cursor Pro $20 订阅制
GitHub Copilot $10 订阅制
Windsurf $20 订阅制

21. Claude Code vs Cursor vs Copilot 对比

21.1 核心区别

特性 Claude Code Cursor GitHub Copilot
形式 终端 CLI IDE（VS Code 分支） IDE 插件
核心能力 Agentic 自主编码 AI 增强编辑器 代码补全
文件操作 自主读写编辑 编辑辅助 行级补全
命令执行 可执行 shell 命令 有限支持 不支持
Git 管理 完整的 Git 工作流 基本支持 不支持
并行任务 Worktrees + Subagents 不支持 不支持
MCP 扩展 支持 不支持 不支持
上下文窗口 最高 1M tokens 中等 小
价格 $20-200/月 $20/月 $10/月

21.2 实际性能对比

同一开发者在同一天用三个工具完成相同功能（用户仪表板 + 认证 + 数据表格 + 图表）：

指标 Claude Code Cursor GitHub Copilot
完成时间 42 分钟 58 分钟 90+ 分钟
人工干预次数 3 次 12 次 25+ 次
代码质量 高（一次通过） 中等 需大量修改

21.3 选择建议

  • Claude Code：新功能开发、多文件重构、复杂测试
  • Cursor：IDE 内的快速编辑（知道确切改什么时）
  • Copilot：自动补全样板代码（不想手动输入 import 语句时）

21.4 何时选择 Claude Code

适合 Claude Code 的场景：

  • 从零开始构建新功能
  • 跨文件的大型重构
  • 需要运行测试和构建命令
  • 需要并行处理多个任务
  • 需要 Git 工作流自动化
  • 需要 MCP 扩展集成数据库/外部工具

不适合 Claude Code 的场景：

  • 只是想补全当前行的代码（用 Copilot 更快）
  • 需要图形化 IDE 体验
  • 只需要偶尔的编码建议

22. 最佳实践与使用技巧

22.1 首次使用新项目

1. claude                    # 启动
2. /init                     # 生成 CLAUDE.md
3. /memory                   # 完善项目记忆
4. /mcp                      # 配置需要的 MCP 服务器
5. /permissions              # 设置权限规则
6. 开始正常任务

22.2 大型任务工作流

1. /plan "描述你要做的大型变更"    # 进入计划模式
2. 审核计划，确认无误
3. 开始执行
4. 过程中如需调整：
   /model opus                  # 切换到更强的模型
   /effort high                 # 增加推理深度
5. 完成后：
   /diff                        # 查看变更
   /code-review                 # 代码审查
   /commit                      # 提交

22.3 上下文管理技巧

# 长时间会话后
/context                       # 检查上下文使用情况
/compact                        # 超过 60% 时压缩
/btw 这是临时说明               # 使用 /btw 代替普通消息

22.4 提示词技巧

好的提示词：

"重构 src/auth 目录下的认证模块，将 JWT 验证逻辑提取到独立的 middleware 中，保持 API 兼容"

差的提示词：

"改进认证"

关键原则：

  • 指定具体文件和目录
  • 描述期望的结果
  • 说明约束条件（如"保持 API 兼容"）
  • 提及测试要求

22.5 权限安全最佳实践

{
  "permissions": {
    "allow": [
      "read:.",
      "write:src/",
      "write:test/",
      "bash:npm test",
      "bash:python -m pytest",
      "bash:git diff",
      "bash:git status",
      "bash:git add",
      "bash:git commit"
    ],
    "deny": [
      "write:.env",
      "write:*.*key",
      "write:secrets/*",
      "bash:sudo",
      "bash:rm -rf",
      "bash:chmod 777",
      "bash:curl | bash"
    ]
  }
}

22.6 减少审批疲劳

  1. 允许常见操作：将 npm test、git diff 等加入 allow 列表
  2. 使用 Hooks 自动格式化：postToolUse hook 自动运行 formatter
  3. /auto 模式：在安全环境下使用自动模式

22.7 多项目工作

# 项目 A
cd /path/to/project-a
claude -p "完成当前任务"

# 项目 B
cd /path/to/project-b
claude -c  # 继续上次项目 B 的会话

# 恢复特定会话
claude -r "session-name" "继续这个任务"

23. 常见问题 FAQ

Q1: Claude Code 和 Claude 有什么区别？

Claude Code 是 Claude 在编程领域的专用版本，以终端 CLI 形式运行，能够直接操作文件、执行命令、管理 Git 工作流。普通 Claude 主要用于对话。

Q2: 需要一直开着终端吗？

不需要。使用 /background 可以将会话放入后台运行，释放终端。使用 /loop 可以设置循环任务自动执行。

Q3: Claude Code 能访问互联网吗？

默认不能直接访问。但可以通过 MCP 服务器（如 server-fetch、server-brave-search）实现网络请求。

Q4: 如何确保数据安全？

  • Claude Code 不会将你的代码存储到 Anthropic 的服务器
  • 使用 /permissions 限制对敏感文件的访问
  • 在 deny 列表中添加 .env、密钥文件等敏感路径
  • 使用本地模型时（如通过 MCP 连接），数据完全不出本机

Q5: Claude Code 支持哪些编程语言？

Claude Code 是语言无关的。它可以处理任何编程语言，包括 Python、JavaScript/TypeScript、Go、Rust、Java、C/C++、Ruby、PHP、Swift、Kotlin 等。

Q6: 如何调试 Claude Code 的问题？

/doctor              # 运行诊断
/insights            # 查看使用统计
claude --debug       # 调试模式启动
claude --verbose     # 详细输出

Q7: 如何在 CI/CD 中使用 Claude Code？

# 非交互式模式，适合 CI
claude -p "Run code review on this PR"
claude -c -p "Check for type errors"

# 管道模式
cat changes.diff | claude -p "Review these changes"

Q8: Claude Code 可以并行运行多个实例吗？

可以。每个实例在独立的会话中运行，互不干扰。使用 claude -r "session-name" 可以恢复特定会话。

Q9: 会话历史保存在哪里？

~/.claude/sessions/
├── project-a/
│   ├── session-20260605-001.json
│   └── session-20260605-002.json
└── project-b/
    └── session-20260605-001.json

Q10: 如何迁移到 Claude Code？

从其他 AI 编码工具迁移：

  1. 创建项目的 CLAUDE.md 文件，描述项目约定
  2. 配置 permissions 和 MCP 服务器
  3. 先从小任务开始，逐渐建立信任
  4. 使用 /init 自动生成初始配置

24. 总结

Claude Code 核心优势

  1. 真正的 Agentic 编码助手：不只是代码补全，而是能自主完成任务
  2. 强大的上下文理解：最高 1M token 上下文窗口
  3. 扩展生态：MCP 协议支持无限扩展
  4. 并行工作能力：Worktrees + Subagents 同时处理多个任务
  5. 完整 Git 集成：从分支创建到 PR 的全流程管理
  6. 灵活的定价：从免费试用到企业级全覆盖

推荐场景

场景 推荐度 说明
新功能开发 ⭐⭐⭐⭐⭐ Claude Code 最擅长的场景
多文件重构 ⭐⭐⭐⭐⭐ 并行处理，效率极高
代码审查 ⭐⭐⭐⭐⭐ /code-review 命令非常强大
调试 ⭐⭐⭐⭐ 结合 /effort high 效果很好
代码补全 ⭐⭐⭐ Copilot 在行级补全上更快
学习新框架 ⭐⭐⭐⭐ 可以深度解释代码
CI/CD 集成 ⭐⭐⭐⭐ 非交互式模式适合自动化

学习路径建议

Day 1: 安装 + /init + 基本对话
Day 2: 学习 /plan + /diff + /code-review
Day 3: 配置 CLAUDE.md + permissions
Day 4: 探索 MCP 服务器
Day 5: 使用 /batch + /loop 高级功能
Week 2+: 自定义 Skills + Hooks + Subagents

关键资源

  • 官方文档：https://code.claude.com/docs
  • GitHub 仓库：https://github.com/anthropics/claude-code
  • 定价页面：https://www.anthropic.com/pricing
  • Cheat Sheet：https://github.com/anthropics/claude-code/blob/main/docs/cheat-sheet.md
  • 社区：https://www.reddit.com/r/ClaudeAI
# 人工智能 # 人机交互
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

RAG混合检索避坑指南：为什么向量+关键词的Hybrid Search仍可能漏掉关键结果

avatar DeepSeek技术社区
cover

评测集漂移告警：Golden set 维护比模型迭代更重要

avatar DeepSeek技术社区
cover

DeepSeek-R1 推理成本账本：当你的 KV cache 命中率低于 60% 时该查哪些指标

avatar DeepSeek技术社区