Claude Code 是 Anthropic 推出的终端 AI 编程工具,在命令行中直接读写项目文件、执行终端命令、搜索代码库,无需切换到浏览器或 IDE 插件。它支持多文件编辑、Git 操作、MCP 工具集成,适合需要在真实项目中高效开发的程序员。本文将从零开始,带你完成安装、配置、基础用法和企业级项目实战。
为什么选择 Claude Code
在 AI 编程工具爆发的 2026 年,主流选择有 Cursor、Windsurf、GitHub Copilot 和 Claude Code。Claude Code 的核心差异在于:
| 特性 | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|
| 运行环境 | 终端 CLI | VS Code IDE | IDE 插件 |
| 多文件编辑 | ✅ 原生支持 | ✅ Composer | ⚠️ 有限 |
| Git 集成 | ✅ 直接操作 | ⚠️ 需手动 | ⚠️ 需手动 |
| MCP 工具 | ✅ 原生支持 | ✅ 支持 | ❌ 不支持 |
| 自定义 Skill | ✅ SKILL.md | ✅ Rules | ❌ 无 |
| 适合场景 | 全栈开发、DevOps | 前端、UI 开发 | 代码补全 |
| 价格 | $20/月起 | $20/月 | $10/月 |
选择 Claude Code 的理由: - 你在终端工作流中,不想切换到 IDE - 项目涉及多文件重构、Git 操作、部署脚本 - 需要 MCP 工具集成(数据库、API、浏览器自动化) - 团队需要可复用的 Skill 知识库
安装与配置
系统要求
| 项目 | 最低要求 |
|---|---|
| 操作系统 | macOS 12+、Ubuntu 20.04+、Windows WSL2 |
| Node.js | 18.0+ |
| 内存 | 4GB+ |
| 网络 | 需要访问 Anthropic API |
安装步骤
# 1. 安装 Claude Code(需要 Node.js 18+)
npm install -g @anthropic-ai/claude-code
# 2. 验证安装
claude --version
# 3. 首次启动(会引导你登录 Anthropic 账号)
claude
首次启动后,Claude Code 会在浏览器中打开 Anthropic OAuth 页面,登录后自动完成认证。如果你使用 API Key 而非订阅:
# 直接设置 API Key
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
# 或者在首次启动时选择 "Use API Key" 选项
国内用户注意事项
如果你在国内服务器上使用,需要配置代理:
# 设置 HTTP 代理
export HTTPS_PROXY="http://127.0.0.1:7890"
# 或者使用 SOCKS5
export ALL_PROXY="socks5://127.0.0.1:7890"
基础用法
启动与基本对话
# 进入项目目录
cd /path/to/your/project
# 启动 Claude Code(自动识别项目上下文)
claude
# 直接提问
> 这个项目的目录结构是什么?
# 让它修改代码
> 帮我把 src/utils.js 里的 formatDate 函数改成支持中文日期格式
# 让它执行命令
> 运行测试,看看有没有报错
常用斜杠命令
在 Claude Code 交互界面中,这些命令非常实用:
/init — 在项目根目录生成 CLAUDE.md(项目上下文文件)
/clear — 清除当前对话上下文
/compact — 压缩对话历史,释放 token
/cost — 查看本次会话的 token 消耗
/doctor — 检查配置和连接状态
/help — 查看所有可用命令
CLAUDE.md:项目记忆文件
CLAUDE.md 是 Claude Code 的"项目记忆",每次启动自动读取。建议包含:
# 项目说明
这是一个 Flask 博客系统,部署在阿里云 ECS 上。
# 技术栈
- Python 3.11 + Flask
- Docker Compose 部署
- Nginx 反向代理
- Tailwind CSS
# 常用命令
- 重启服务:docker restart 51domino-web
- 查看日志:docker logs -f 51domino-web
- 运行测试:pytest tests/
# 代码规范
- 使用中文注释
- 函数命名用 snake_case
- 模板文件在 templates/ 目录
实战:多文件项目重构
以下是一个真实场景:你的 Flask 项目有 67 篇博客文章,需要给每篇文章的开头加上 AI SEO 答案块。
claude
> 我需要给 blog_posts/ 目录下的所有教程类文章加上 AI SEO 答案块。
> 答案块的要求:在文章 frontmatter 之后、正文之前,加一个40-60字的段落,
> 直接回答文章标题提出的问题。
> 先读几篇文章看看格式,然后告诉我你的计划。
Claude Code 会: 1. 读取几篇示例文章,理解 frontmatter 格式 2. 分析哪些文章是教程类(通过 category 字段) 3. 生成修改计划,等你确认后批量执行 4. 每修改一篇都会显示 diff,你可以逐个确认
MCP 工具集成
MCP(Model Context Protocol)让 Claude Code 能调用外部工具。这是它相比其他 AI 编程工具的最大优势。
配置 MCP Server
在项目根目录创建 .mcp.json:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-server-brave-search"],
"env": {
"BRAVE_API_KEY": "your-brave-api-key"
}
}
}
}
常用 MCP Server
| MCP Server | 用途 | 安装方式 |
|---|---|---|
| filesystem | 安全的文件系统访问 | @modelcontextprotocol/server-filesystem |
| brave-search | 网络搜索 | @anthropic-ai/mcp-server-brave-search |
| puppeteer | 浏览器自动化 | @anthropic-ai/mcp-server-puppeteer |
| postgres | PostgreSQL 数据库 | @anthropic-ai/mcp-server-postgres |
| github | GitHub API | @anthropic-ai/mcp-server-github |
配置后,Claude Code 可以直接: - 搜索网页获取最新文档 - 操作浏览器测试页面 - 查询数据库验证数据 - 操作 GitHub Issues 和 PR
Skill 知识库:团队共享最佳实践
Claude Code 支持 SKILL.md 文件,让团队共享编码规范和工作流。
创建项目 Skill
# 在项目中创建 skills 目录
mkdir -p .claude/skills
# 创建一个部署 Skill
cat > .claude/skills/deploy.md << 'EOF'
---
name: deploy
description: 部署流程和注意事项
---
# 部署流程
## 本地测试
1. docker-compose up -d
2. curl http://localhost:5000/health
3. 运行 pytest
## 生产部署
1. git push origin main
2. SSH 到服务器:ssh root@your-server
3. cd /opt/your-app && git pull
4. docker-compose up -d --build
5. 验证:curl https://your-domain.com/health
## 注意事项
- 部署前必须通过所有测试
- 数据库迁移脚本要先在测试环境验证
- 保留上一个版本的镜像标签以便回滚
EOF
之后只需告诉 Claude Code "帮我部署",它就会按照 Skill 中定义的流程执行。
进阶技巧
1. 非交互模式(脚本集成)
# 单次执行,适合 CI/CD
claude -p "检查这个项目的 Python 代码有没有语法错误" --output-format json
# 管道输入
cat error.log | claude -p "分析这个错误日志,给出修复建议"
2. 多会话管理
# 恢复上次对话
claude --continue
# 列出最近的会话
claude --resume
3. 权限控制
# 只读模式(不允许修改文件)
claude --read-only
# 允许特定命令
claude --allowedTools "Bash(npm test),Bash(npm run build)"
Claude Code vs Cursor vs Windsurf:怎么选
| 场景 | 推荐工具 | 原因 |
|---|---|---|
| 终端党、全栈开发 | Claude Code | 原生 CLI,Git/MCP 集成最好 |
| 前端开发、UI 调整 | Cursor | IDE 内实时预览,拖拽方便 |
| 代码补全为主 | GitHub Copilot | 最轻量,行级补全体验最好 |
| DevOps、脚本编写 | Claude Code | 直接在服务器上操作 |
| 非程序员学编程 | Cursor | 可视化界面,学习曲线低 |
如果你同时使用多个工具,建议: - 日常编码用 Cursor(IDE 内体验好) - 复杂重构和部署用 Claude Code(多文件操作强) - 代码补全用 Copilot(轻量无干扰)
常见问题
Claude Code 需要什么网络条件?
需要能访问 Anthropic API(api.anthropic.com)。国内用户需要配置 HTTPS 代理。也可以通过 AWS Bedrock 或 Google Vertex AI 使用,避免直连。
Claude Code 和 Claude Desktop 有什么区别?
Claude Desktop 是桌面聊天应用,Claude Code 是终端编程工具。Claude Code 能直接读写项目文件、执行命令、操作 Git,是面向开发者的工作流工具。
支持哪些编程语言?
理论上支持所有语言,因为它本质是在操作文本文件。实际效果取决于模型对语言的理解程度。Python、JavaScript/TypeScript、Go、Rust 等主流语言效果最好。
一个月大概花多少钱?
取决于使用频率。轻度使用(每天 1-2 小时)约 $20-50/月,重度使用(全天候)可能 $100-200/月。使用 API Key 按量付费更灵活,Max 订阅($100/月或 $200/月)包含固定额度。
能用在团队协作中吗?
可以。CLAUDE.md 和 SKILL.md 可以提交到 Git 仓库,团队成员共享同一套项目上下文和编码规范。企业版还支持集中管理权限和用量。