30秒快速回答： Claude Code 是 Anthropic 推出的命令行 AI 编程 Agent。它不是 IDE 插件（不像 Copilot），也不是独立编辑器（不像 Cursor），而是一个直接运行在终端中的 AI 程序员——你可以用自然语言向它描述任务，它自己读代码、规划方案、修改文件、执行命令、验证结果。2026 年，Claude Code 已成为许多开发者的”第二程序员”。

Claude Code 与其他工具的定位差异

Claude Code 的独特定位： 它是最接近”雇了一个远程程序员”的体验——你在终端里给它派活，它自己去干，干完向你汇报。

安装与配置

安装

# 方式一：npm 全局安装（推荐）
npm install -g @anthropic-ai/claude-code

# 方式二：直接使用 npx（免安装）
npx @anthropic-ai/claude-code

初次设置

# 首次运行会引导配置
claude

# 设置 API key（推荐用环境变量）
export ANTHROPIC_API_KEY="sk-ant-xxx"

# 或使用 OAuth 登录
claude login

启动方式

# 在项目目录中启动
cd my-project
claude

# 直接带问题启动
claude -p "帮我分析这个项目的架构"

# 非交互模式（适合脚本）
claude -p "修复 auth.py 中的 SQL 注入漏洞" --output-format json

核心功能实操

一、理解项目

$ claude
> @codebase 这个项目是做什么的？主要用了哪些技术栈？

Claude Code 会：
1. 扫描目录结构和关键文件
2. 分析 package.json / requirements.txt / go.mod 等
3. 阅读核心入口文件
4. 总结架构和技术栈

输出：
这个项目是一个基于 FastAPI + SQLAlchemy 的后端服务，
主要功能是用户认证和数据管理...

二、代码修改（自动规划+执行）

> 帮我把所有的 SQL 查询改成 SQLAlchemy 2.0 的 async 风格

Claude Code：
1. 搜索项目中所有 SQL 相关的代码 [规划]
2. 识别需要修改的文件列表 [分析]
3. 逐个修改文件，展示 diff [执行]
4. 运行测试验证修改 [验证]

每一步执行前会展示计划，你可以批准或要求调整。

三、Bug 修复

> 用户反馈登录接口在并发情况下偶尔返回 500 错误，帮我排查

Claude Code：
1. 读 auth.py 的登录逻辑
2. 搜索相关错误日志
3. 发现数据库连接池耗尽 → 提出修复方案
4. 修改连接池配置 + 添加重试逻辑
5. 生成测试脚本验证

四、生成新功能

> 帮我加一个「重置密码」功能：
> - 用户输入邮箱 → 发送重置链接
> - 链接有效期 30 分钟
> - 需要新数据库表存储 token

Claude Code：
1. 创建数据库迁移文件
2. 编写 /auth/reset-password 路由
3. 编写 /auth/reset-password/confirm 路由
4. 添加邮件发送逻辑
5. 更新 API 文档
6. 编写单元测试

五、MCP 工具集成

Claude Code 内置 MCP 客户端，可以接入数据库、文件系统、Git 等：

// 在 ~/.claude/claude_desktop_config.json 配置
{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres", "postgresql://..."]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/project"]
    }
  }
}

配置后，Claude Code 可以直接查询数据库：

> 查一下 users 表有多少注册用户，按月份统计增长趋势

高级技巧

1. CLAUDE.md：项目级的系统提示词

在项目根目录创建 CLAUDE.md 文件，定义 Claude Code 的行为规则：

# CLAUDE.md

## 项目信息
- 项目名：用户管理系统
- 技术栈：FastAPI + SQLAlchemy 2.0 + PostgreSQL
- 测试框架：pytest + httpx

## 编码规范
- 所有 API 路由必须有 Pydantic 请求/响应模型
- 数据库查询使用 async/await
- 错误处理使用自定义异常类，统一返回格式
- 提交前必须运行 pytest

## 禁止行为
- 不要修改数据库迁移文件（由 Alembic 管理）
- 不要在 production 分支直接操作
- 不要引入不需要的依赖

2. 权限控制

Claude Code 支持三级权限模式：

# 始终批准（适合信任度高的操作）
claude --permission-mode accept-edits

# 始终跳过（只看不改）
claude --permission-mode plan

# 默认：每次修改前询问
claude --permission-mode default

3. 会话持久化

# 恢复之前的会话
claude --resume

# 列出历史会话
claude --resume-list

Claude Code 的定价

Claude Code 使用 Claude API 计费：

一个典型的中型任务（如新增一个 API 接口），约消耗 $0.50-$2.00。相比雇佣开发者，性价比极高。

Claude Code 的局限

Cursor vs Claude Code：怎么选？

最佳实践： 很多开发者同时使用两者——日常编码用 Cursor，遇到复杂任务（如重构、排查疑难 Bug、生成测试）切换到 Claude Code。

常见问题

Q: Claude Code 会误删或损坏我的代码吗？

Claude Code 的权限模式可以控制：设置为 plan 模式只看不写；default 模式每次修改前需要你批准 diff；即使误改，Git 历史也可以恢复。建议始终在 Git 版本控制下使用。

Q: Claude Code 和 Cursor 的 Agent 模式有什么区别？

Cursor Agent 运行在 IDE 环境中，有图形界面和代码预览。Claude Code 运行在终端，更适合流水线化任务和跨项目的批处理。选择取决于你的工作流偏好。

Q: 需要 Claude Pro 订阅才能用 Claude Code 吗？

不需要。Claude Code 直接使用 Anthropic API（按量付费），与 Claude Pro 订阅无关。但需要一个 Anthropic API key。

Q: Claude Code 支持中文吗？

支持。你可以用中文发出指令，Claude Code 完全理解。生成的代码注释、文档也可以用中文。

下一步建议： npm install -g @anthropic-ai/claude-code，在你的项目目录中运行 claude，输入「帮我理解这个项目」，感受 Agent 自主编程的体验。