AI Coding Guide

Claude Code 实用指南

这是一份面向个人开发者的 Claude Code 使用手册，重点放在 Windows 本地开发、静态网站维护、服务器发布和安全改动上。

它不是命令列表的搬运，而是把 Claude Code 当作“项目搭档”来使用：先读懂项目，再拆任务，再小步修改，最后验证结果。

站点：AI Atlas 场景：Windows · 阿里云 · 静态站点更新：2026/06/17

它适合解决什么问题

Claude Code 的价值不在于“让 AI 写几行代码”，而在于它能进入项目目录，理解文件结构、命令、依赖和上下文，然后围绕一个目标连续工作。对个人开发者来说，它更像一个能读仓库、会改文件、能解释错误日志的终端助手。

适合	不适合
整理老项目结构，找出入口文件和关键依赖	没有任何目标地让它“随便优化”整个项目
修复报错、补充脚本、改页面样式、写部署说明	把生产服务器密码、私钥、Token 直接贴给模型
让它先制定修改方案，再逐步改文件	一次性要求它改动几十个无关文件
阅读第三方库用法、解释复杂代码、生成测试思路	替代正式的安全审计、合规审核或人工验收

如果你的任务会影响线上页面、数据库、用户数据或服务器配置，先让 Claude Code 输出计划，再确认执行范围。

Windows 安装与登录

Windows 用户通常有两条路径：使用 npm 安装，或者使用系统包管理器。前者更通用，后者更接近桌面软件安装体验。

方式一：npm 安装

# 确认 Node.js 已安装
node -v
npm -v

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

# 验证命令是否可用
claude --version

方式二：winget 安装

# 使用 Windows 包管理器安装
winget install Anthropic.ClaudeCode

# 安装后重新打开 PowerShell
claude --version

第一次运行 claude 时，终端会引导你登录 Anthropic 账号。登录方式可能是浏览器授权，也可能是输入 API Key，按提示完成即可。

不要把 API Key 写进公开仓库。需要保存本地私密配置时，优先使用不会提交到 Git 的本地配置文件或系统环境变量。

第一个项目会话

打开项目目录后再启动 Claude Code，它才能基于当前目录理解文件结构。Windows 下建议在 PowerShell 中进入项目根目录，而不是随便从用户目录启动。

# 进入你的项目目录
cd "F:\Other\AISolo\阿里云服务器\wsry.top"

# 启动 Claude Code
claude

首次进入项目时，不要立刻让它改文件。先让它看结构、说结论、列出它认为重要的文件。

请先阅读当前目录结构，告诉我这个静态网站由哪些页面、样式和资源组成。暂时不要修改文件。

得到结构说明后，再提出具体目标。例如“把备案信息加到页脚”比“完善一下网站”更安全，也更容易验收。

常用工作流

修页面样式

页面改版适合分成三步：先定位样式来源，再描述视觉目标，最后让它只改必要文件。这样能避免无意中重写内容或破坏链接。

请检查 index.html 和 assets 下的 CSS，判断主页样式从哪里控制。然后按“暖米色背景、深灰边框、天蓝按钮”的方向调整，不要改文章链接和备案链接。

写部署脚本

部署脚本要明确本地路径、远程 IP、目标目录和是否重载 Nginx。对 Windows 用户来说，PowerShell 脚本比 Bash 脚本更顺手。

请为 Windows 生成 deploy.ps1，把本地 wsry.top 目录上传到 root@121.40.205.30:/var/www/html/wsry.top，并在最后执行 nginx -t 和 systemctl reload nginx。脚本需要显示错误原因，不能闪退。

排查报错

报错排查不要只贴一句“失败了”。把执行的命令、完整错误、操作系统和目录一起给它，Claude Code 才能判断是路径、权限、依赖还是网络问题。

命令与快捷操作

Slash command 适合处理会话级操作。下面这些命令在日常项目里最常用。

/help查看当前可用命令和说明

/init生成项目说明文件，让后续对话更懂项目

/clear清空当前上下文，适合切换无关任务

/config查看或调整模型、权限等配置

/cost查看本轮会话消耗

/review审查当前改动，适合提交前检查

/commit根据变更生成提交信息并提交

Ctrl+C中断当前长时间操作

如果你不确定某个命令是否存在，先用 /help。不同版本的 Claude Code 可用命令可能会变化。

让 Claude 看懂项目

Claude Code 会读取项目文件，但它并不知道你的偏好和约束。最好在项目根目录准备一份 CLAUDE.md，写清楚技术栈、目录含义、部署方式和禁区。

# 项目说明

## 项目类型
个人 AI 知识分享静态站点，部署到阿里云 ECS。

## 目录
- index.html：主页
- claude-code-usage-guide.html：文章页
- assets/：图片与共享样式
- archives/：文章路径跳转页

## 修改原则
- 不删除备案链接
- 不暴露服务器密码、密钥和 Token
- 页面样式遵循 motherduck.css 的视觉规范
- 修改后检查主要入口链接

这类说明越具体，Claude Code 越少猜测。尤其是“不能改什么”，比“希望改成什么”同样重要。

安全修改文件

把 Claude Code 用在真实项目时，核心原则是小步修改和可回滚。每次只让它完成一个清晰目标，改完就检查差异。

建议的修改节奏

让它说明会改哪些文件，不急着执行。
确认文件范围后再让它修改。
修改后查看差异，重点看链接、脚本、路径和配置。
能本地预览就先本地预览，再上传服务器。
线上更新后，打开主页和至少一个文章页验证。

Git 项目中的检查命令

# 查看改了哪些文件
git status

# 查看具体差异
git diff

# 如果某个文件改错了，可以回退
git checkout -- path/to/file

如果项目不是 Git 仓库，修改前先复制一份备份。静态网站很容易被一次错误替换影响所有页面。

MCP 与外部工具

MCP 可以理解为 Claude Code 连接外部工具的协议。接入后，它不仅能读本地文件，还能在合适场景访问 GitHub、数据库、文档系统或其他服务。

个人项目不一定一开始就需要 MCP。先把本地文件编辑、部署脚本和常见排错跑顺，再考虑接入外部服务。否则工具越多，权限边界越难管理。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<token>"
      }
    }
  }
}

MCP 配置里经常包含 Token。不要把包含真实 Token 的配置文件提交到公开仓库。

个人网站发布场景

维护个人知识站点时，Claude Code 可以覆盖从内容整理到上线前检查的大部分重复工作。一个稳定流程通常是：本地写页面、统一样式、检查链接、上传服务器、重载 Nginx。

阶段	可以让 Claude Code 做什么	你需要确认什么
内容	重写文章、补充结构、生成 FAQ、统一措辞	内容是否准确，是否有不该出现的来源信息
页面	改 HTML、CSS、响应式布局和跳转页	主页、文章页和移动端是否正常
备案	把 ICP 与公安联网备案号放到页脚并添加跳转	备案号是否真实，跳转地址是否正确
部署	生成 PowerShell 上传脚本和 Nginx 配置	服务器路径、IP、用户名是否正确

上线前检查提示词

请检查 wsry.top 目录：确认 index.html、文章页、assets 资源、archives 跳转页、备案链接都存在。不要修改文件，只输出发现的问题。

更稳定的提问方式

Claude Code 对“边界清楚”的任务反应最好。一个好的请求通常包含目标、范围、禁止事项和验收标准。

页面修改

目标：把文档页改成 AI Atlas 自有教程，加入 Windows、静态站点和服务器发布场景。
范围：只改 claude-code-usage-guide.html，不改 index.html。
禁止：不要出现第三方来源标记，不要删除备案链接。
验收：保留 ICP 和公安备案链接，保留 motherduck.css 引用。

排查问题

我在 Windows PowerShell 运行 deploy.ps1 后失败。
当前目录是 F:\Other\AISolo\阿里云服务器。
服务器 IP 是 121.40.205.30，远端目录是 /var/www/html/wsry.top。
下面是完整报错：...
请先判断原因，不要直接重写脚本。

当任务涉及文件删除、服务器命令、批量替换时，最好加一句“先告诉我计划，确认后再执行”。

常见问题

Claude Code 修改了我不想改的地方怎么办

如果项目使用 Git，先看 git diff，只回退有问题的文件。没有 Git 时，从备份恢复最稳。下次请求时明确文件范围，例如“只改 index.html 的 footer”。

Windows 下命令找不到 claude

重新打开 PowerShell，确认 npm 全局目录在 PATH 中。也可以用 where claude 查看命令位置。

上传服务器后样式没变

先确认新 CSS 是否上传到服务器，再清理浏览器缓存。Nginx 如果设置了静态资源缓存，CSS 可能不会立刻刷新，可以临时强制刷新页面。

什么时候需要使用计划模式

只要任务会跨多个文件、影响部署、删除内容或改变项目结构，就适合先让它输出计划。简单文字替换或单个样式调整不一定需要。

日常使用建议

每次只给一个主任务，避免"顺便再改几个地方"。
涉及线上网站时，先本地预览，再上传服务器。
不要把服务器密码、私钥、数据库密码写进对话或仓库。
把项目规则写入 CLAUDE.md，让后续会话少猜测。
对生成的部署脚本保持审慎，先读懂再运行。
内容类页面要做二次改写，避免只把外部资料重新排版。

把 Claude Code 当作能动手的搭档，而不是自动驾驶。你负责目标、边界和最终判断，它负责阅读、修改和解释细节。

文章来源

本文由 AI Atlas 基于实际使用经验整理编写。