AIGCBot
EN领取验证清单
Claude Code 原理与实战

AI 编程助手 / 终端代理 / LESSON 01

Claude Code 安装、登录与项目记忆

从安装、登录、工作目录、CLAUDE.md、自动记忆和 /context 开始建立一个可控的项目环境。

阅读时间
15 分钟
学习路径
Claude Code 原理与实战
内容来源
Claude Code 专题教程

预计阅读时间: 15 分钟

Claude Code 的配置重点不是“命令能不能启动”，而是它启动后是否理解当前项目、是否知道团队规则、是否在合理权限里工作。本篇从安装、登录、工作目录、CLAUDE.md、上下文检查和权限设置讲起。

安装与登录

安装命令应以官方文档为准。常见起步路径是安装 CLI，然后在项目目录里运行：

claude

第一次使用时会进入登录或授权流程。团队环境里要确认账号来源、订阅或 API 计费方式、可用模型和组织策略。

如果你在多个项目之间切换，建议每次先确认：

pwd
git status --short --branch
claude --version

不要在错误目录启动代理。coding agent 的第一条安全线就是正确工作目录。

CLAUDE.md 是项目记忆

CLAUDE.md 适合写项目级指导，例如：

# CLAUDE.md

## Project rules

- This is a static Next.js export site.
- Keep the ICP footer on every public route.
- Do not introduce new runtime services unless the task asks for it.

## Commands

- Run `npm run lint` after TypeScript edits.
- Run `npm run build` before deployment.

## Release

- Deploy with the existing release directory and current symlink workflow.

它不应该变成百科全书。把稳定规则放进去，把长文档放在 docs/，再在 CLAUDE.md 中指向它。

让 Claude Code 检查上下文

Claude Code 提供上下文相关命令和界面能力。开始复杂任务时，可以让它先说明自己看到了什么：

请先检查当前项目上下文，说明你会优先读取哪些文件，再开始实现。

也可以要求它在执行前输出计划：

这是多步任务。请先读相关代码和 CLAUDE.md，给出计划，等我确认后再改文件。

这种方式适合高风险变更或需求还不够清楚的任务。

权限设置

Claude Code 支持权限相关设置和模式。你需要区分：

  • 只读分析。
  • 允许编辑项目文件。
  • 允许运行命令。
  • 允许联网或访问外部系统。
  • 允许执行危险动作。

默认策略应该保守：项目内读写和常规验证可以自动化，生产写操作、密钥、账单和数据删除必须单独确认。

项目启动清单

为一个仓库启用 Claude Code，可以按这个顺序：

1. 确认仓库干净或记录已有变更。
2. 添加或更新 CLAUDE.md。
3. 明确 lint/test/build 命令。
4. 说明不可删除或不可更改的产品约束。
5. 检查权限设置。
6. 用一个低风险任务试跑。
7. 根据试跑问题更新 CLAUDE.md。

不要从“让它改生产部署”开始试用。先用低风险任务建立项目规则。

让记忆保持有用

项目记忆的维护原则：

  • 只记录稳定、重复出现的规则。
  • 不记录短期临时需求。
  • 不写含糊口号，例如“代码要优雅”。
  • 记录具体验收，例如“SEO 页面必须有 canonical 和 sitemap”。
  • 当代理重复犯错时，把纠正写进去。

如果 CLAUDE.md 太长，Claude Code 反而更难抓重点。保持它像工程 checklist，而不是完整手册。

一个适合本站的 CLAUDE.md 片段

## Public site rules

- `aigc-bot.com` is the current canonical domain.
- Do not remove `粤ICP备2023048551号-1`.
- Learning routes must be static, indexable, and included in sitemap.
- Product/design/deployment decisions must be synced into OpenSpec or docs.

## Verification

- Run `npm run lint`.
- Run `npm run build`.
- Check important live routes after deployment.

这样的规则会直接减少上线事故。

参考资料