AIGCBot
中文Get the checklist
Claude Code principles and practice

AI CODING AGENT / TERMINAL WORKFLOW / LESSON 01

Installation and project memory

Set up Claude Code with installation, authentication, working directories, CLAUDE.md, auto memory, and context inspection.

Reading
15 min
Track
Claude Code principles and practice
Source
Chinese reviewed guide

The reviewed guide body for this track is currently maintained in Chinese.

预计阅读时间: 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.

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

参考资料