Claude Code 新手配置完整教程

Claude Code 是一款长驻在终端 / 编辑器的 AI 编程助手，它不只是一个聊天框，而是会主动读你整个仓库的工程化搭档。

本文按从 0 到能跑项目的顺序写，跳过所有花絮。

1. 安装

macOS / Linux：

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

Windows (PowerShell)：

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

安装完成后验证：

claude --version
# claude-code 0.x.x

2. 登录

claude login

浏览器会跳转完成 OAuth，回到终端后看到 Logged in as <your-email> 即成功。

3. 编辑器集成

Claude Code 同时支持三种形态，按习惯选一个就好：

3.1 VSCode 扩展

在扩展市场搜索 Claude Code 安装。装好后：

1. 左侧活动栏会出现 Claude 图标
2. 打开任意项目，状态栏右下角显示连接状态
3. 用 Cmd/Ctrl + L 唤起侧栏对话

3.2 JetBrains 插件

Settings → Plugins → Marketplace 搜索 Claude Code。配置 API key 后重启 IDE 生效。

3.3 命令行原生

cd your-project
claude
# 看到 ❯ 提示符即可开始对话

💡 我个人只用命令行，因为它最接近 Unix 哲学：管道、文件、标准输入都能直接用。

4. 第一个项目级配置

在项目根目录放一个 CLAUDE.md，Claude Code 启动时会自动加载：

# Project Rules

- 用 TypeScript 严格模式
- 不引入任何 lodash
- 提交前必须跑 pnpm test
- 命名风格: 文件名 kebab-case，导出 PascalCase

建议规则不超过 30 条。规则太多 Claude 会”挑着听”，反而效果差。

5. Slash Command

把重复 prompt 写成命令，比如 /review 触发代码评审：

/review src/

预置了几十条命令：/init、/commit、/pr、/cost …

6. 一些踩坑

• 仓库太大首次索引慢：可用 .claudeignore 排除 node_modules、dist 等
• 上下文超长：用 /compact 压缩历史
• 多任务并行：开多个 worktree，每个工作树一个 Claude Code 实例

7. 一些进阶玩法

• Hook：在 ~/.claude/hooks/ 写 shell 脚本，让 Claude 在写文件前后跑 ESLint、Prettier
• MCP：接入 GitHub、Linear、数据库，Claude 可以直接开 Issue、查表
• Plan Mode：默认不写文件，先给你方案，满意再执行

写在最后

Claude Code 的真正威力不在聊天框里，而在它能持续记住你的工程风格。花 20 分钟配好，后面每天省 1 小时。

---

视频版：B 站 / YouTube 搜「Claude Code 入门」可以看到 12 分钟的实操演示。