首页 / 技术博客 / Claude Code 中文实战指南:从安装到企业级项目开发
AI工具教程 2026-07-15

Claude Code 中文实战指南:从安装到企业级项目开发

Claude Code 是 Anthropic 推出的终端 AI 编程助手,通过命令行直接在项目中编写、修改和调试代码。本文从安装配置到 MCP 集成、多文件项目重构,手把手带你掌握 Claude Code 的完整工作流。

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 仓库,团队成员共享同一套项目上下文和编码规范。企业版还支持集中管理权限和用量。


相关教程

想让AI真正落地到你的业务中?

51domino 提供企业级AI Agent本地化部署方案——从模型选型到生产上线,全程技术支持。

订阅更新

获取最新的AI本地化技术文章和教程