Claude Code 怎么用？从安装到让 AI 修改整个项目完整教程 - ChatGPT中文镜像站_ChatGPT国内版_ChatGPT入口

Claude Code 让 AI 改整个项目的四阶段工作流

依据 Anthropic 官方 Best Practices 整理，最后核查 2026-09-01；小改动可跳过规划直接做

探索 Explore · 只读不改

输入 /plan，让它读代码、讲清现状（认证流程、密钥管理、目录结构）。

成功标志：它准确复述了项目结构和约定，证明”看懂了”。

↓

规划 Plan · 先出方案

让它列出要改哪些文件、实施计划；按 Ctrl+G 把计划打开到编辑器直接改。

成功标志：你认可这个方案，而不是等它改完才发现方向错了。

↓

实现 Implement · 按计划动手

退出 Plan Mode，让它写代码、跑测试并修失败；每处改动会先征求你同意。

成功标志：测试通过、构建正常。

↓

提交 Commit · 收尾

让它用清晰的 commit 信息提交改动、开 PR。配合 CLAUDE.md 约定提交格式更规范。

成功标志：Git 记录干净、PR 描述完整。

提示：如果一句话就能说清改动（改拼写、加日志、重命名变量），跳过规划直接做，别为小改动上完整流程。CLAUDE.md 每次会话自动加载，先写好项目规矩，AI 才不容易跑偏。

Claude Code 能直接在你的终端里读代码、改文件、跑命令，帮你完成从写测试到重构整个项目的开发任务。

它不是一个代码补全插件——你把任务交给它，它会自己去读代码库、拆解任务、逐文件修改、运行测试，最后把结果给你。本文基于 2026 年最新版本，从安装到让 AI 修改整个项目，一步步讲清楚。

【快速答案】

问题	答案
Claude Code 是什么？	Anthropic 推出的终端 AI 编程助手，能自主读代码、改文件、跑命令
怎么安装？	一条命令：`curl -fsSL https://claude.ai/install.sh \| bash`
要花多少钱？	订阅模式：Pro $20/月（年付$17/月）起；API 模式按 token 计费
能修改整个项目吗？	能。通过动态工作流可并行调度数十到数百个子代理处理大型项目
国内能用吗？	可以，但需要配置网络代理或通过兼容接口接入

一、Claude Code 是什么？和 Copilot 有什么区别？

Claude Code 是 Anthropic 官方推出的命令行原生 AI 编程助手。它不是把对话框塞进 IDE 的聊天工具，也不是代码自动补全插件。

最核心的区别在于：Claude Code 是一个“代理”（Agent）。

Copilot：你写代码，它帮你补全。你写一个函数名，它补完函数体。
Claude Code：你说“重构这个模块”，它自己去读源码、拆任务、逐文件改、跑测试。

Claude Code 能：

读取并理解整个代码库
跨多个文件编辑和修改
运行命令、执行测试
提交代码到 GitHub
通过动态工作流并行处理大规模任务

目前 Claude Code 可在终端、VS Code、JetBrains、桌面应用和浏览器中使用。

二、安装 Claude Code

系统要求

系统	版本要求
macOS	13.0+
Windows	10 1809+ 或 Windows Server 2019+
Ubuntu	20.04+
Debian	10+
Alpine Linux	3.19+

推荐方式：原生安装（无需 Node.js）

原生安装器会自动在后台更新到最新版本。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

注意：PowerShell 和 CMD 的命令不同。如果你的终端提示符显示 PS C:\，说明你在 PowerShell 中；如果显示 C:\ 不带 PS，说明你在 CMD 中。

安装完成后，重新打开终端，输入以下命令验证：

claude --version

如果能显示版本号，说明安装成功。

备选方式：通过 npm 安装

如果原生安装因网络问题失败，可以通过 npm 安装。需要先安装 Node.js 18.0 或更高版本。

npm install -g @anthropic-ai/claude-code

注意：正确的包名是 @anthropic-ai/claude-code，安装后的命令是 claude 而不是 claude-code。npm 上存在仿冒包，注意区分。

通过 Linux 包管理器安装

支持 apt、dnf、apk：

# Ubuntu/Debian
sudo apt install claude-code

# Fedora/RHEL
sudo dnf install claude-code

三、首次启动与登录

安装完成后，进入你的项目目录，启动 Claude Code：

cd your-project
claude

首次启动时，系统会提示你在浏览器中完成 OAuth 授权——登录你的 Claude 账号即可。授权成功后，终端会自动缓存令牌，后续无需重复登录。

如果你有 Claude 订阅账号：登录后即可直接使用。

如果你没有订阅：Claude Code 本身不免费。你需要：

订阅 Claude Pro（$20/月，年付$17/月）；或
使用 Anthropic API Key 按 token 付费。

四、让 AI 理解你的项目：CLAUDE.md 配置

这是整个教程最关键的一步。

Claude Code 启动时会自动读取项目根目录下的 CLAUDE.md 文件。这个文件相当于给 AI 写的一份项目说明书——它会被强制注入到每次对话中，直接影响 Claude 的行为。

自动生成初始版本

在每个项目的第一步，执行：

/init

Claude 会扫描项目结构并自动生成初始版本的 CLAUDE.md。

手动优化 CLAUDE.md

自动生成的是起点，你需要手动补充和调整。核心原则：控制在 200 行以内。

写什么：

项目使用的技术栈和框架
代码风格和命名规范
常用命令（如何运行、如何测试）
架构约定和模块边界
Claude 不知道就可能写出错误代码的规则

不写什么：

代码风格细节——交给 ESLint 管理
语言通用约定——Claude 已经知道
完整 API 文档——给个链接就行

写法要点：
❌ “代码应该比较整洁”——废话
✅ “函数不超过 50 行，超过时必须拆分”——指令

❌ “不要使用 X”——不完整
✅ “不要使用 X，请改用 Y”——完整

CLAUDE.md 为什么重要？

没有 CLAUDE.md，Claude 每次从零开始理解你的项目。有了它，项目约定只写一次，永久生效。

它还会直接影响你的费用——CLAUDE.md 每行都会消耗 token，但一份好的配置文件能避免 Claude 反复读取文件来猜测项目结构，反而节省更多成本。

五、基本使用：让 Claude Code 帮你干活

启动会话

在项目目录下：

claude

Claude 加载当前目录的上下文后，等待你的第一条指令。

常用命令

命令	作用
`/init`	生成 CLAUDE.md 配置文件
`/model`	切换模型
`/compact`	压缩对话上下文
`claude -p "指令"`	非交互模式（无头运行）

典型任务示例

写测试：

“为 src/utils/ 目录下所有未测试的函数编写单元测试”

修复 bug：

“修复 login.js 中登录失败时没有错误提示的问题”

重构代码：

“把 api/ 目录下的回调函数全部改成 async/await”

修改整个项目：

“把整个项目从 JavaScript 迁移到 TypeScript，保持所有功能不变”

实际工作流程

一个典型的 Claude Code 会话是这样运转的：你和 Claude 在终端中来回交换提示词（由你发出）和操作（由 Claude 执行）。Claude 会：

读取你的代码库
规划一系列操作
使用真实的开发工具执行
评估结果并调整方法

建议：在 Claude 执行修改前，先审查它建议的变更（diff），确认无误后再接受。

六、进阶：动态工作流——让 AI 自主修改整个项目

2026 年 5 月，Anthropic 推出了动态工作流（Dynamic Workflows） ，这是 Claude Code 处理大型项目的核心能力。

动态工作流能做什么？

Claude 会动态编写编排脚本，在一个会话中并行运行数十到数百个子代理，并且在把结果交给你之前自行检查。

实际案例：开发者用动态工作流将 Bun 从 Zig 移植到 Rust，生成了约 75 万行 Rust 代码，现有测试套件通过率 99.8%，从第一次提交到合并仅用了 11 天。

适用场景包括：

全代码库的 bug 搜索和安全审计
涉及数千文件的大型迁移和现代化改造
需要反复验证的关键任务

如何使用动态工作流

动态工作流需要 Claude Code v2.1.154 或更高版本，在所有付费计划上可用。

有两种方式启动：

方式一：直接要求

“创建一个动态工作流，把整个项目的日志从 console.log 改成 Winston”

方式二：开启 ultracode 模式
在 /config 中启用 Dynamic workflows，然后开启 ultracode 设置，Claude 会自动判断何时使用工作流。

注意：动态工作流会消耗比普通会话多得多的 token，建议先从范围较小的任务开始体验。

七、费用说明：要花多少钱？

Claude Code 有两种使用路径：订阅模式和 API 模式。

订阅模式

Claude Code 包含在以下订阅计划中：

计划	月费（年付）	说明
Pro	$17/月	入门级，包含 Claude Code
Max 5x	$100/月	5 倍 Pro 使用额度
Max 20x	$200/月	20 倍 Pro 使用额度
Team Standard	$20-25/席位	团队标准版
Team Premium	$100-125/席位	团队高级版

API 模式

通过 Anthropic API 使用 Claude Code，按 token 计费：

模型	输入（每百万 token）	输出（每百万 token）
Claude Haiku 4.5	$1	$5
Claude Sonnet 5	$2	$10
Claude Opus 5	$5	$25

实际成本参考

根据 Anthropic 官方文档，在企业部署场景下，平均成本约为每名开发者每个活跃日 $13 美元，每月约 $150–250 美元；90% 用户的成本低于每个活跃日 $30 美元。

节省费用的方法

保持 CLAUDE.md 在 200 行以内——每行都是 recurring 输入成本
根据任务匹配模型——机械性编辑用 Haiku，多文件推理用 Opus
每个任务新开会话——上下文会在每轮对话中重新发送
使用子代理进行探索——子代理在独立上下文中读取文件，只返回摘要到主会话

八、中文用户特别说明：网络配置

Claude Code 默认需要访问 claude.ai 和 Anthropic API 端点。在中国大陆的网络环境中，这些端点可能无法直接访问。

解决方案

方案一：配置代理
通过环境变量配置网络代理：

export ANTHROPIC_BASE_URL=https://your-proxy-endpoint
export ANTHROPIC_AUTH_TOKEN=sk-你的key

方案二：接入兼容接口
将 Claude Code 的请求指向兼容 Anthropic 协议的第三方接口。

方案三：官方订阅 + 合规网络
拥有 Claude 账号且网络通畅的情况下，首次使用时执行登录即可。

注意：不要为了绕过官方限制编写欺骗系统的代码，以官方信息和风险说明为准。

九、常见故障排查

安装后 `claude: command not found`

原因：安装目录不在 PATH 中。

解决：

# 找到安装位置
which -a claude

# 将目录添加到 PATH（以 ~/.local/bin 为例）
export PATH="$HOME/.local/bin:$PATH"

安装脚本返回 403 或语法错误

检查网络连接，或改用 npm 方式安装。

Windows 上使用

推荐安装 WSL 或 Git for Windows。如果未安装 Git for Windows，Claude Code 会使用 PowerShell 作为 shell 工具。

十、Claude Code vs Cursor：怎么选？

对比维度	Claude Code	Cursor
形态	终端代理	AI 增强 IDE
入门价格	$20/月（Pro）	$20/月（Pro）
重度使用	$100-200/月（Max）	类似区间
最佳场景	大规模重构、自主任务	实时编辑、熟悉 IDE 环境
特色	终端原生、动态工作流	行级补全、调试器集成

简单来说：

想交给 AI 一个任务让它自己完成（比如“重构整个模块”），选 Claude Code
想在熟悉的 VS Code 里一边写代码一边让 AI 辅助，选 Cursor

【FAQ】

Q：Claude Code 有免费版吗？

A：没有。Claude Code 需要订阅 Claude Pro（$20/月，年付$17/月）或以上计划，或者通过 Anthropic API 按 token 付费使用。

Q：Claude Code 和 GitHub Copilot 有什么区别？

A：Copilot 是代码补全工具——你写代码它帮你补全。Claude Code 是代理工具——你说“重构这个模块”，它自己去读源码、拆任务、逐文件改、跑测试。

Q：Claude Code 能修改整个项目吗？

A：能。通过动态工作流（Dynamic Workflows），Claude 可以并行调度数十到数百个子代理处理涉及数千文件的大型项目。

Q：CLAUDE.md 文件必须创建吗？

A：强烈建议创建。没有它，Claude 每次从零开始理解你的项目。有了它，项目约定只写一次，永久生效。执行 /init 命令可自动生成初始版本。

Q：国内用户怎么使用 Claude Code？

A：需要通过配置代理或接入兼容 Anthropic 协议的中转接口。具体可配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 环境变量。

Q：Claude Code 真的很贵吗？

A：根据 Anthropic 官方数据，企业场景下平均每开发者每活跃日约 $13，90% 用户低于 $30/天。通过保持 CLAUDE.md 精简、根据任务切换模型、每个任务新开会话等方式可以有效控制成本。

【资料来源 / 信息核查】

Claude Code 官方文档 – Overview（code.claude.com/docs/en/overview），2026年7月
Claude Code 官方文档 – 概述（中文）（code.claude.com/docs/zh-CN/overview），2026年7月
Anthropic 官方博客 – Introducing dynamic workflows in Claude Code（claude.com/blog/introducing-dynamic-workflows-in-claude-code），2026年5月28日
Anthropic 官方博客 – Auto mode is now the default in Claude Code（claude.com/blog/auto-mode-default-in-claude-code），2026年8月7日
Anthropic 官方 – How Claude Code is used in practice（anthropic.com），2026年6月16日
Claude Code Pricing 2026（morphllm.com），2026年8月21日
Claude Code 安装与配置教程（cloud.tencent.com.cn），2026年6月
Claude Code 国内网络配置指南（cloud.tencent.com.cn），2026年8月
Claude Code API Cost 2026（morphllm.com），2026年6月15日
Claude Code 安装故障排查文档（code.claude.com/docs/en/troubleshoot-install），2026年8月

最后核查：2026年9月1日。Anthropic 产品更新较快，价格、功能和访问权限可能发生变化，请以 Anthropic 官方网站（anthropic.com）和 Claude Code 官方文档（code.claude.com）为准。

查看 ChatGPT 中文版入口浏览最新教程