Claude Code 是 Anthropic 推出的 AI 编程助手，直接在终端里运行。与网页版 AI 工具相比，它最大的优势是可以直接读写你的项目文件、运行命令、修复错误——整个编程工作流都在一个对话里完成，不需要反复复制粘贴。

Claude Code 能做什么

Claude Code 理解整个代码库的结构，不只是单个文件。它能做的事包括：

  • 读写文件： 直接在项目里创建、修改、删除文件，不需要手动复制代码
  • 运行命令： 执行 shell 命令、安装依赖、跑测试、查看输出
  • 调试报错： 看到错误信息后自动定位问题、修改代码、重新测试
  • 理解上下文： 跨文件追踪函数调用、类型定义、依赖关系
  • SSH 远程操作： 连接到 HPC 或云服务器，在远程环境里直接工作
  • 代码审查： 分析 diff，找出潜在 bug 或可以简化的地方
  • 写文档： 根据代码自动生成 README、注释、使用说明

典型使用场景：接手一个陌生的代码库，让 Claude Code 先读完整个项目，解释结构，然后带着你完成修改——比自己从头看省很多时间。

终端基础

Claude Code 在终端（Terminal）里运行，如果不熟悉命令行，先掌握几个基本命令就够用了。

导航目录

# 查看当前所在的位置
pwd

# 列出当前目录下的文件和文件夹
ls
ls -l        # 显示详细信息（权限、大小、日期）
ls -a        # 包含隐藏文件（以 . 开头的文件）

# 进入某个目录
cd Documents
cd Documents/Projects/MyProject   # 多级目录一次进入

# 返回上一层
cd ..

# 返回主目录（Home）
cd ~
cd           # 不加参数也是回 Home

# 返回上一个所在的目录
cd -

~ 代表你的主目录，即 /Users/你的用户名（Mac）。路径有两种写法：

  • 绝对路径：从根目录 / 开始，如 /Users/yifan/Documents/project
  • 相对路径：相对于当前位置，如 ./data 或 ../other-project

退出对话 / 中止任务

操作 方法
退出 Claude Code 输入 exit 或按 Ctrl + D
中止正在执行的任务 按 Esc — Claude Code 会停下来，等你下一步指令
强制终止（卡住时） 按 Ctrl + C — 立即中断当前进程

Esc 和 Ctrl + C 的区别：Esc 是礼貌地打断，Claude Code 会停下来等你；Ctrl + C 是强制终止，当它完全没有响应时才用。

安装

需要先安装 Node.js（v18 或以上）。

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

安装完成后运行 claude 启动，第一次会提示你用浏览器登录 Anthropic 账号完成授权。

claude

订阅 Anthropic Pro（$17/月）即可使用，用量按月重置。如果是重度用户或团队，也可以用 API key 按量计费（在 ~/.claude/settings.json 里配置 apiKey）。

配置项目

进入项目目录

Claude Code 以当前目录为工作区，所有文件操作都在这里进行。

cd /path/to/your/project
claude

创建 CLAUDE.md

CLAUDE.md 是项目的"说明书"，每次启动 Claude Code 都会自动读取。可以在里面写：

  • 项目简介和技术栈
  • 常用命令（如何运行、测试、部署）
  • 代码规范（命名约定、注释风格）
  • 需要注意的坑或特殊约束
# MyProject

Python 数据分析项目，使用 pandas + matplotlib。

## 常用命令
- 运行分析：`python analysis.py`
- 跑测试：`pytest tests/`

## 注意事项
- 数据文件在 data/raw/，不要提交到 git
- 图表输出到 figures/，文件名格式：YYYY-MM-DD_name.png

用 /init 命令可以让 Claude Code 自动扫描项目、生成初版 CLAUDE.md：

> /init

连接远程服务器（可选）

Claude Code 支持通过 SSH 在远程服务器上工作，适合 HPC 或云端环境：

claude --ssh user@server.example.com

连接后操作体验和本地一样，文件读写、命令执行都在远程进行。

常用命令

对话中的斜杠命令

命令 作用
/init 扫描项目，自动生成 CLAUDE.md
/plan 先规划再动手，列出步骤后等你确认
/compact 压缩对话历史，节省 token，适合长会话中途用
/clear 清空当前对话，重新开始
/cost 查看当前会话的 token 消耗
/review 对当前 diff 做代码审查
/help 查看所有可用命令

启动时的选项

# 继续上一次的对话
claude --continue

# 从历史会话列表里选择一个恢复
claude --resume

# 直接执行一个任务，不进入交互模式
claude -p "给这个项目写一个 README"

实用技巧

粘贴截图： 对话框里可以直接粘贴截图，Claude Code 会读取图片内容。报错截图、UI 设计稿都可以直接贴进来。

语音输入： 支持语音输入，适合描述复杂需求时不想打字的情况。

/plan 先规划再执行： 遇到大改动时先用 /plan 让它列出所有步骤，确认无误再执行，避免改到一半发现方向不对。

/compact 管理长对话： 一次会话做了很多事之后，上下文会越来越长、越来越贵。用 /compact 压缩之前的内容，保留核心信息，再继续下一轮迭代。

上手门槛不高，最快的方式是找一个自己正在写的小项目，cd 进去，claude 启动，让它先读一遍代码，然后提一个具体需求——这比看文档更直接。