🏠 首页 攻略 Claude Code 终端编程全指南:从安装到多文件编辑实战

Claude Code 终端编程全指南:从安装到多文件编辑实战

Claude Code 是 Anthropic 推出的终端 AI 编程助手,能直接读写你的项目文件。本文从安装开始,演示会话管理、多文件编辑、代码审查等核心功能,帮你把 Claude Code 变成日常主力开发工具。

终端里跑 AI,已经不是什么新鲜事了。但 Claude Code 和之前的 Copilot 插件不太一样——它能直接读你的整个项目目录,帮你改代码、修 bug、跑测试,全流程都在终端里完成。

我用了两周,把它当成日常主力工具。下面是踩坑后的实战总结。

安装与环境准备

Claude Code 目前需要 Anthropic API Key,通过 npm 安装:

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

安装完成后直接运行:

claude

第一次启动会让你输入 API Key,支持环境变量方式配置:

export ANTHROPIC_API_KEY="sk-ant-api03-xxxx"
claude

关键一步:在 Claude Code 会话里输入 @permission,开启对项目的文件读写权限。不开权限的话,它只能看不能改。

会话模式:和终端 AI 对话的正确姿势

Claude Code 启动后,你会进入一个交互式会话。每次输入都当作一条指令。

基本对话流程

> 帮我找到项目里所有的 API 路由定义
> 把这些路由统一加上请求限流中间件
> 跑一下测试,看看有没有报错

三句话搞定。Claude Code 会依次执行,每一步都会显示它做了什么改动。

多轮对话的优势

不用像 Copilot 那样每次都写 prompt。对话是连续的,你能基于上一轮的结果继续说:

> 刚才那个改法不够优雅,换用装饰器模式
> 同时更新对应的单元测试

核心功能实战

功能一:批量代码重构

假设你有一个 Django 项目,30 个视图函数都用了相同的查询模式。你想统一改成自定义 Manager:

> 在 models.py 里添加一个 CustomQuerySet 类
> 把所有 views.py 里的 .filter().count() 查询换成 .custom_count()
> 确保导入语句也同步更新

Claude Code 会自动:

  1. 创建新类并写入 models.py
  2. 定位所有视图文件
  3. 逐文件修改查询调用
  4. 补充 import 语句

整个过程大约 2 分钟。比手动找、手动改快至少 10 倍。

功能二:Bug 修复工作流

遇到一个报错,但 stack trace 很长,不知道从哪下手:

> 这个报错是哪里来的?
> 帮我定位根因
> 给出修复方案并直接修改

Claude Code 会先解释错误原因,然后定位到具体代码行,最后直接改好。你可以随时打断它,说"先别改,我再想想"。

功能三:代码审查

写完功能后,让 Claude Code 帮你 review:

> @review 帮我审查这个 PR 的所有改动
> 关注点是:错误处理是否完整、有没有内存泄漏风险

它会逐文件检查,给出问题列表和改进建议。比你自己逐行看,效率高很多。

快捷键和快捷命令

Claude Code 内置了不少快捷方式:

命令作用
@files引用特定文件
@terminal插入终端输出到上下文
@git引入 git diff 作为上下文
/edit编辑最后一条消息
/clear清空会话历史

@git 特别好用。你刚改了几个文件但还没 commit,输入 @git 就能让 Claude Code 基于你的改动给出建议。

和 VS Code 的配合

虽然 Claude Code 是纯终端工具,但你可以和 VS Code 搭配使用:

  1. 用 Claude Code 做批量重构或复杂 bug 修复
  2. 改完后用 VS Code 的 diff 工具做最终确认
  3. 有问题直接在终端里跟 Claude Code 对话

这种分工效率最高。纯编辑器交互适合快速调试,终端 AI 适合大范围改动。

注意事项

  • 费用:按 API 调用量计费,日常开发大概每月几美元。大量代码生成会消耗更多 tokens
  • 权限控制@permission 里的规则要设好,不要让 AI 随意删除文件
  • 版本控制:改之前先 commit,万一改坏了可以直接 revert
  • 大型项目:Claude Code 能处理几千行代码的项目,但如果是百万级代码库,建议按模块分段处理

总结

Claude Code 不是万能的,但它确实把"让 AI 帮我改代码"这件事从概念变成了日常操作。终端里说一句话,改完代码,跑下测试——比打开 IDE 写 prompt 快多了。

如果你已经在用 Claude API,Claude Code 是最值得尝试的姿势。