Claude Code 完整教程：终端里的AI编程助手

覆盖热词：claude code（512🔥）| claude code tutorial（30📊）| claude code 中文（30📊）

Claude Code 是什么？

Claude Code 是 Anthropic 推出的终端原生 AI 编程助手。它不是 VS Code 插件，不是 Web 界面——它直接在命令行里工作。

通俗说： 你在终端里打字跟它聊天，它就能读你的代码库、修改文件、跑命令、帮你调试。

它的核心能力： - 读整个项目代码（不只是当前文件） - 直接在终端里修改、创建、删除文件 - 帮你跑命令、看报错、分析日志 - 交互式调试——你报错它修，你再跑它再修

和 Copilot / Cursor 有什么不同？

核心差别：Claude Code 是命令行工具，适合已经习惯终端的开发者。它没有图形界面，但可以做的事情更多——跑测试、改配置、查日志、重构代码库。

安装指南

前提条件

• Node.js 18+（推荐 20+）
• npm 或 yarn
• Anthropic API Key（console.anthropic.com 获取）

安装

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

配置 API Key

# 方式一：环境变量
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx

# 方式二：配置文件
claude config set apiKey sk-ant-xxxxxxxxxxxx

# 方式三：第一次运行自动提示输入
claude

基本用法

1. 进入项目目录，启动对话

cd your-project
claude

Claude Code 会自动扫描当前项目的文件结构，建立上下文。启动后你会看到一个交互式终端：

╭─────────────────────────────────────╮
│  Claude Code                        │
│  Scanning project structure...      │
│  Detected: Python, JavaScript, ...  │
│  Ready — ask me anything!           │
╰─────────────────────────────────────╯

2. 常用命令

3. 实际用例

读代码：

> 帮我解释一下 src/services/auth.ts 这个文件是干什么的

改代码：

> 给 userRoutes.js 里的每个路由加上错误处理中间件

写测试：

> 帮我给 utils/format.js 里的 formatDate 函数写单元测试

调试：

> npm test 报错了，检查一下测试文件有什么问题

重构：

> 把 api/ 目录下的所有文件从 callback 模式改成 async/await

进阶用法

多文件编辑模式

Claude Code 可以在一次对话中修改多个文件。用 /compact 压缩上下文后继续。

> 帮我重构整个 models/ 目录，所有类加上 TypeScript 类型注解

CI/CD 集成

把 Claude Code 加到 CI 流程中：

# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Code Review
        run: |
          npm install -g @anthropic-ai/claude-code
          echo "请审查这个PR的代码质量" | claude --review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

自定义指令

在项目根目录创建 .claude.md 文件，定义项目级别的指令：

# Claude Code 项目指令

## 代码风格
- 使用 2 空格缩进
- 函数名用 camelCase
- 组件名用 PascalCase
- 必须写 TypeScript 类型

## 测试
- 所有工具函数必须写单元测试
- 使用 Vitest 测试框架
- 测试覆盖率要求 > 80%

## 项目约定
- API 路由放在 src/routes/ 下
- 数据库模型放在 src/models/ 下
- 工具函数放在 src/utils/ 下

费用估算

Claude Code 是按 API 用量计费的（用你的 Anthropic API Key），不是按月订阅。

日常使用参考： - 轻量编码（补全+小修改）：每天 $0.5-2 - 中度使用（重构+调试）：每天 $2-8 - 重度使用（全天 AI 辅助编码）：每天 $10-30

💡 省钱技巧： 不需要复杂推理的任务用 Claude 4 Haiku，只在复杂重构时用 Sonnet/Opus。用 /cost 监控花费。

中文用户特别提示

1. 终端中文显示问题

Claude Code 支持中文对话，直接在终端输入中文即可：

$ claude
> 帮我写一个 Python 函数，把 CSV 文件转换成 JSON 格式

如果终端显示中文乱码，检查：

# 终端编码设为 UTF-8
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

2. 中文项目名/注释

Claude Code 能正确理解中文注释、中文变量名、中文项目文档。如果你项目里有中文 README，它也会阅读。

3. 与中文文档配合

把项目的中文开发文档传给 Claude Code 看，它能理解并按照文档要求编码。

常见问题

Q：Claude Code 和 Claude.ai 有什么区别？ Claude.ai 是 Web 聊天界面。Claude Code 是终端工具，能直接读写你的代码文件。前者只是聊天，后者真正干活。

Q：可以不用 Node.js 直接安装吗？ 目前 Claude Code 通过 npm 分发，需要 Node.js 18+。没有其他安装方式。

Q：持哪些操作系统？ Windows / macOS / Linux 都支持。Windows 推荐用 PowerShell 或 WSL。

Q：CLAUDE CODE 会把我代码上传到 Anthropic 吗？ 是的，Claude Code 需要把你的代码片段发送到 Anthropic API 进行处理。如果你有代码保密需求，不要用这个工具。Anthropic 承诺不使用你的 API 调用数据训练模型。

Q：和 Cursor 比哪个好？ 各有所长。如果你已经是终端重度用户 → Claude Code。如果你更喜欢图形界面 → Cursor。如果你想要免费的 → Continue.dev + Ollama。

Q：能在 VSCode 里用 Claude Code 吗？ 不能直接。但可以在 VSCode 的内置终端里运行 Claude Code。

总结

Claude Code 是 终端开发者的利器。它不像其他 AI 编程工具有图形界面——它直接在命令行干活，适合已经习惯终端的开发者。

它的杀手锏是全项目理解能力和多文件编辑能力。日常用 Claude 4 Haiku（省钱），复杂重构切 Claude 4 Sonnet。

如果你是终端用户但还没试过 Claude Code，值得花 5 分钟装上体验一下。

🔗 相关文章： Claude Code vs Cursor vs Aider 横评 | Claude Code Pricing 完全解读

🔗 系列文章： Claude Code 香港可用性指南 | Cursor 开源替代方案对比