Claude Code是什么？命令行AI编程助手的安装、常用操作与工作流

Claude Code 是 Anthropic 推出的命令行 AI 编程助手：它运行在你的终端里，能读取当前项目的代码，按你的描述修改文件、运行命令、执行测试，并把改动结果展示给你确认。和“在聊天窗口里贴代码问问题”相比，它的区别是直接在项目目录里工作，能看到完整的目录和上下文。这篇 Claude Code 使用教程按“安装 → 项目约定 → 常用操作 → 工作流 → 安全注意”的顺序讲解。涉及版本、命令细节和账号政策的内容，一律以官方文档为准，本文只讲思路和常用做法。

一、Claude Code适合解决什么问题

它不适合的情况也要清楚：需求本身没想明白、涉及大量线下业务判断的任务，AI 帮不上忙；涉及生产环境数据和密钥的操作，更不应该直接交给它执行。

二、安装与启动

Claude Code 通过 npm 安装，需要先装好 Node.js，具体要求的版本以官方文档为准：

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

# 进入你的项目目录后启动
cd your-project
claude

首次启动会引导你登录，登录方式、可用地区、套餐和计费方式都以官方说明为准。启动后会进入一个交互界面，直接用自然语言描述任务即可。

如果只想让它执行一次任务并输出结果，不进入交互，可以使用非交互模式，例如 claude -p "说明这个项目的目录结构"，具体参数以 claude --help 的输出为准。

三、用CLAUDE.md记录项目约定

Claude Code 每次启动时，会自动读取项目根目录下的 CLAUDE.md 文件，把里面的内容当作长期背景信息。把团队约定写进去，可以省去每次重复说明：

# 项目说明
- 这是一个 PHP 5.6 + MySQL 项目，不要使用 7.0 以上的语法
- 数据库操作统一通过 $this->mysql，不要新建连接
- 修改前先读相关文件，改完说明改了哪些文件

# 常用命令
- 运行测试：phpunit tests/
- 代码风格：遵循现有文件的缩进和命名

# 禁止事项
- 不要修改 data/ 目录下的配置文件
- 不要把密钥写进代码

写 CLAUDE.md 的几个原则：只写它读代码读不出来的信息（运行环境限制、命令、禁区、约定），不要写成长篇文档；随项目演进及时更新；不要放任何密钥和账号密码。交互界面里的 /init 命令可以帮你生成初始版本，再按实际情况修改。

四、常用斜杠命令与操作

在交互界面里，以 / 开头的是内置命令。常用的有：

• /help：查看当前版本支持的全部命令，以它的输出为准
• /init：分析项目并生成初始的 CLAUDE.md
• /clear：清空当前对话上下文，开始一个新任务时使用
• /compact：压缩对话历史，对话很长时节省上下文空间
• /model：查看或切换使用的模型

使用过程中的几个实用习惯：

1. 一次只做一件事。 任务之间用 /clear 隔开，避免上一个任务的内容干扰新任务。
2. 让它先读再改。 提示词里写明“先阅读 xxx 目录下相关文件，再提出修改方案”，比直接要求“帮我改”更靠谱。
3. 写清楚验收标准。 例如“改完后运行测试，确保全部通过，并说明改了哪些文件”。
4. 随时打断。 发现它方向不对，可以中断并补充说明，不必等它做完。

五、计划模式与权限确认

计划模式是让它“只分析、不动手”的工作方式：先给出打算怎么改，你确认后再执行。对于改动范围大、涉及多个文件的任务，建议先用计划模式出方案，确认没问题再放行。切换方式以官方文档为准，常见做法是在交互界面里通过快捷键切换模式。

权限确认是 Claude Code 的安全机制：默认情况下，它在编辑文件、执行命令前会征求你的同意。可以按需放行常用的安全命令（例如运行测试），但不建议为了省事把所有操作都设成自动放行，尤其是删除文件、修改数据库、部署上线这类操作，应该始终保持人工确认。

六、配合git的安全工作流

AI 编程助手的主要风险不是写不出来，而是改多了、改错了、改在不该改的地方。推荐一套简单的工作流：

1. 开始前先提交。 确保工作区是干净的，必要时新建一个分支，出问题可以随时回退。
2. 描述任务并先出方案。 用计划模式确认它打算改哪些文件。
3. 分小步执行。 一个任务改动不超过几个文件，改完立刻运行测试。
4. 逐处审查改动。 用 git diff 查看所有改动，重点看有没有改到无关文件、有没有删除原有逻辑、有没有引入新的依赖。
5. 满意再提交。 提交信息自己写清楚，不要盲目接受。

只要坚持“改动可回退、结果可审查”，AI 就是一个效率很高的助手；一旦放弃审查，就等于把代码质量交给了运气。

七、安全注意事项

• 不要把密钥交给它。 数据库密码、接口密钥、服务器账号不要写进提示词，也不要放在它可能读取的文件里。项目里的 .env 等敏感文件应加入忽略规则，并在 CLAUDE.md 里写明“不要读取和修改”。
• 审查生成的代码。 特别关注 SQL 拼接、文件上传、权限判断、输入校验这类安全相关的位置。
• 谨慎处理第三方依赖。 它建议安装新的包时，先核对包名和来源，避免引入不明依赖。
• 遵守公司规定。 代码是否可以交给外部服务处理，涉及公司的数据与合规要求，使用前应先确认。
• 遵守账号与地区政策。 注册、登录、付费等以官方说明为准，不要使用来路不明的共享账号。

常见问题

Claude Code 和在网页里问 Claude 有什么不同？ 网页对话需要你手动复制代码，它看不到项目全貌；Claude Code 直接在项目目录里读文件、改文件、运行命令，更适合真实项目的修改。

需要会编程才能用吗？ 需要。它是辅助工具，你仍然要能看懂改动、判断对错、处理合并和部署。完全不懂代码的话，很难发现它改错了什么。

它会不会把我的代码上传到别处？ 为了生成回答，相关内容会发送给服务端处理，具体的数据处理方式和保留政策，请以官方隐私说明和你所用套餐的条款为准。公司项目请先确认是否允许。

改错了怎么办？ 这正是建议先提交 git 的原因：用 git diff 查看改动，用 git restore 或回退提交即可恢复。

如果你的团队想把 AI 编程助手引入开发流程，或者需要定制 AI 应用、管理系统和小程序，广州万户网络提供软件与 AI 应用开发服务，可以先把需求整理出来再沟通，咨询电话：13535321113。更多软件开发能力可以查看 软件开发 页面。总的来说，Claude Code 值得在小项目里先试用一两周，再根据团队情况决定怎么推广，作为 AI编程助手，它的价值取决于你是否建立了清晰的约定和审查流程。