article-7-claude-code-tutorial-clean.md

Claude Code是什么

Claude Code是Anthropic推出的命令行AI编程助手，直接在你终端里运行，能读代码、写代码、执行命令、管理Git——就像一个坐在你旁边的资深工程师。不同于Copilot的”补全”模式，Claude Code是”Agent模式”：你描述要做什么，它自己规划、执行、验证，你只需审核结果。

截至2026年7月，Claude Code已支持Sonnet 5（默认，经济高效）和Opus 4.8（更强推理），且支持通过API Key接入Fable 5（需要额外信用额度）。

第一步：安装

### 前提条件

– Node.js 18+（推荐使用 `nvm` 管理版本）

– Git（Claude Code会自动管理Git提交）

– Anthropic API Key 或 Claude订阅账号

### 安装命令

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

# 验证安装
claude --version
# 输出: claude-code/2.x.x

第二步：认证

有两种方式：

### 方式A：使用Claude订阅（推荐个人开发者）

claude login

浏览器会弹出Anthropic的OAuth授权页面，登录你的Claude账号即可。

### 方式B：使用API Key（推荐企业/重度用户）

export ANTHROPIC_API_KEY="sk-ant-xxx"
claude

第三步：第一个项目

进入你的项目目录，直接运行 `claude`：

cd ~/my-project
claude

你会看到一个交互式终端界面。试试第一个指令：

> 分析这个项目的结构，告诉我主要模块和依赖关系

Claude Code会自动：

1. 用 `ls` + `find` 扫描目录结构

2. 读 `package.json` / `requirements.txt` 等依赖文件

3. 读关键源码文件

4. 输出结构分析报告

第四步：让它写代码

> 在 src/utils 下创建一个 formatDate.ts，接受 ISO 字符串，返回「YYYY年MM月DD日」格式

Claude Code会创建文件、写代码、甚至自动运行测试（如果项目有配置）。

第五步：配置模型切换

在项目根目录创建 `.claude/settings.json`：

{
  "model": "claude-sonnet-5-20250701",
  "permissions": {
    "allow": [
      "Bash(claude:*)",
      "Read(claude:*)",
      "Write(claude:*)",
      "Edit(claude:*)"
    ]
  }
}

将 `model` 改为 `claude-opus-4-8-20250601` 即可升级到Opus。

进阶技巧

### Git集成

Claude Code每次修改都会自动创建Git commit，所以你随时可以：

git log --oneline  # 查看AI做的所有改动
git diff HEAD~1    # 对比AI改了什么

### 自定义系统提示

在 `.claude/settings.json` 中追加：

{
  "systemPrompt": "你是一个TypeScript专家，始终使用严格模式和函数式编程风格。"
}

### 权限控制

建议初学者使用Plan Mode，让Claude先展示计划再执行：

claude --permission-mode plan

常见问题

Q: 和GitHub Copilot有什么区别？

Copilot是代码补全工具（在编辑器里一行行提示），Claude Code是编程Agent（独立完成任务）。两者互补，可以同时使用。

Q: 花费多少？

Sonnet 5在Pro订阅中包含，Opus 4.8需要更高额度。API方式定价：Sonnet 5约$2/$10（输入/输出每百万Token），通过API使用可精确控制成本。

Q: 支持哪些语言？

全部。Claude Code不依赖语言特定的插件，它通过读文件+执行命令来理解任何项目。

Claude Code 与 Cursor/Copilot 的协作：打造终极AI开发工作流

很多开发者问：我已经在用Cursor了，还需要Claude Code吗？答案是它们是互补的，不是替代的。

Cursor在你编辑器里提供实时代码补全和行内建议——适合”边写边问”。Claude Code在终端里独立完成整个任务——适合”描述需求→坐等结果”。最优工作流是两者搭配：

1. 用Cursor写核心业务逻辑：实时补全、行内重构、函数生成

2. 用Claude Code做系统性任务：跨文件重构、写测试、生成文档、执行数据库迁移

3. 用Git追踪AI改动：每次Claude Code修改都会自动commit，方便审查和回滚

实际场景：在一个Express.js项目中，你用Cursor完成路由和Controller的编写，然后打开终端输入 `claude`，说”给所有API端点写集成测试，覆盖200和400状态码”，Claude Code会自动读取你的路由定义、创建测试文件、运行测试、修复失败用例——你唯一要做的是审核最终代码。

成本控制策略

Claude Code的强大也意味着如果放任不管，成本可能失控。推荐策略：

– 开发阶段使用Sonnet 5（Pro订阅已包含，不额外计费）

– 复杂重构或性能优化时临时切换到Opus 4.8

– 用 `.claude/settings.json` 中的 `maxTokens` 限制每次任务消耗

– 养成先Plan再执行的习惯（`–permission-mode plan`），避免无效尝试

👇 关注不错过

— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn