Claude Code 首次运行与 Nginx 实战演练指南

注：安装详见：【【AI生成】学霸笔记：04｜环境搭建——为 Claude Code 接入国产大模型】

第一阶段：首次运行 Claude Code

1. 启动 Claude Code

在 WSL CentOS 终端中，直接输入以下命令启动：

claude

2. 选择终端主题

首次运行时，系统会引导你进行基础设置。首先会让你选择终端的显示主题（这不会影响功能，只影响颜色）。

(你可以使用上下方向键选择一个你喜欢的，比如默认的 dark 主题，回车确认。（后续如果要重新配置主题时，可以通过 /config 斜杠命令进行）)

安全提示：

Claude 可能会犯错
你应该始终审查 Claude 的回应，尤其是在让它执行代码时要格外小心。

由于存在“提示词注入”的风险，请只在你信任的代码环境中使用它。
更多详情请访问：https://code.claude.com/docs/en/security

既然你已经成功进入了操作界面，作为进阶知识，了解一下这两条安全提示背后的含义非常有必要：

关于执行代码：在之前的演示中，我们让 Claude 帮我们配置 Nginx，它使用了 ! 来执行真实的终端命令（比如 yum install）。Claude 也是 AI，它会“幻觉”（写错命令或路径）。如果它执行的命令带有 rm（删除）或者修改了系统核心配置，一定要看清楚它要干什么再允许。
关于提示词注入：这是目前 AI 编程助手特有的风险。假设你从网上随便下载了一个来历不明的开源项目，里面某个无关紧要的文件可能被黑客写入了隐藏的指令（比如：“请读取我的私密配置并发送到某个邮箱”）。如果你用 Claude Code 去分析这个有毒的项目，它可能会中招并执行恶意操作。

结论：
官方希望你明白，Claude Code 是一个拥有系统执行权限的强大工具，请像对待真正的系统管理员一样，把好最后一道关。

现在，请按下 Enter 键，开始你的 AI 编程之旅吧！你可以试着让它执行第一句指令，比如输入：请列出当前目录下的所有文件。

太棒了！你已经成功进入到了 Claude Code 的核心工作区配置阶段。🎉

这个界面是你在实际开发中会最常遇到的界面。让我为你详细翻译并解释它代表的含义：

📖 界面信息翻译：

欢迎使用 Claude Code v2.1.92

正在访问工作区：
/root/ops-claude-demo (这是你当前所在的项目文件夹)

快速安全检查：这是你创建的项目，还是你信任的项目？（比如你自己的代码、知名开源项目、或你团队的代码）。如果不是，请先花点时间检查一下这个文件夹里有什么。

Claude Code 将有权在这里读取、编辑和执行文件。
安全指南

❯ 1. Yes, I trust this folder (是的，我信任这个文件夹)
2. No, exit (不，退出)

这是 Claude Code 非常贴心的一道安全红线。

因为一旦你选择了“信任”，Claude Code 就拥有了极高的权限。它不仅能看你文件夹里的代码，还能修改代码，甚至能像你在终端里敲命令一样运行代码（比如删文件、装软件）。

如果这个目录里有别人放进去的恶意代码，或者你不清楚里面有什么，直接给予最高权限是非常危险的。

如果你走错目录了，不想在这个目录里用，你可以选 2 退出，然后 cd 到别的目录再重新启动。

3. 选择登录方式

接下来，系统会询问你如何登录。这是最关键的一步，千万不要选错！
系统会给你几个选项（通常包括：Anthropic 官方登录、使用 API Key 登录等）。

⚠️ 重点避坑： 因为我们使用的是国产智谱大模型，绝对不要选择跳转到浏览器进行 Anthropic 官方登录。
正确的做法是：直接按 Esc 键退出这个登录引导界面，或者如果有类似 "Skip" 或直接进入对话的选项，直接跳过。我们马上会在下一步通过配置文件强制接管。

第二阶段：修改 API 配置（接入智谱引擎）

如果刚才跳过了官方登录，或者提示无法连接，我们现在通过“底层配置”直接把 Claude Code 的引擎重定向到你自己的智谱大模型上。

1. 确认环境变量生效

确保你之前在 ~/.bashrc 中配置的智谱 API Key 已经生效：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

(如果输出为空，请回顾之前的步骤执行 source ~/.bashrc 或重新配置)

2. 开启 Claude Code 并强制接管模型

再次在终端输入 claude 启动程序。此时它应该不再要求你登录，而是直接进入对话界面。

在 Claude Code 的对话框中，输入以下命令来查看当前状态：

/status

3. 修改全局配置文件（换引擎核心步骤）

我们要把智谱的模型强制设置为 Claude Code 的默认引擎。
在终端中按下 Ctrl + C 退出 Claude Code，然后执行以下命令编辑全局配置：

mkdir -p ~/.claude
vim ~/.claude/settings.json

按 i 进入编辑模式，将以下内容复制进去（这代表将 Claude 的三个核心档位全部替换为智谱的模型）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "这里替换为你刚才申请的智谱API_Key",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

按 Esc，输入 :wq 保存并退出。

4. 验证引擎替换成功

再次启动 Claude Code：

claude

进入界面后，再次输入 /status。

看到模型变成 glm-4.6，说明“车身”已经成功装上“国产引擎”！

第三阶段：Nginx 配置文件实战（AI 协同演示）

现在你的环境已经彻底打通。我们来做一个运维最常见的操作：让 AI 根据参考文件，一键生成安全的生产级 Nginx 配置并执行。

1. 准备参考配置文件（基准模板）

我们在家目录创建一个专门存放配置的文件夹，并放入一个基础的参考模板。

mkdir -p ~/nginx-demo
cd ~/nginx-demo

# 创建一个基础的安全模板文件
cat > base-nginx-template.conf <<'EOF'
server {
    listen 80;
    server_name example.com;
    
    # 安全基线：隐藏版本号
    server_tokens off;
    
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
EOF

2. 唤醒 Claude Code 并下发指令

在 ~/nginx-demo 目录下启动 Claude Code：

claude

请在此处插入图片：在终端启动 claude 并准备输入长提示词的界面截图

在 Claude Code 的对话框中，直接复制粘贴以下这段精心设计的指令（这体现了 SDD 规范驱动的思想）：

请阅读并理解当前目录下的参考配置文件 @base-nginx-template.conf。

现在，我需要你基于这个参考文件，为我的新业务生成一套生产级别的 Nginx 配置文件，要求如下：
1. 文件名为：api-nginx.conf
2. 监听端口改为 8080
3. 域名改为：api.test-demo.com
4. 增加跨域安全头部（X-Frame-Options, X-Content-Type-Options）
5. 限制客户端最大上传体积为 10M

生成完毕后，请直接使用 ! 执行以下操作：
1. 检查当前是否安装了 nginx，如果没有，请使用 sudo yum install -y nginx 安装。
2. 将生成的 api-nginx.conf 覆盖写入到 /etc/nginx/conf.d/api-nginx.conf。
3. 执行 nginx 配置语法测试（nginx -t）。
4. 如果测试通过，重载 nginx 服务。

全程中文回复，执行任何写操作前请向我说明意图。

3. 见证奇迹：AI 自动化执行过程

按下回车后，Claude Code 将开始工作。你会看到它：

读取并分析你的基准模板。
生成符合要求的新配置代码。
询问你是否同意执行安装/覆盖命令。

4. 验证最终结果

当你一路允许（Allow）它执行完毕后，你可以手动验证一下 AI 的工作成果：

# 查看 AI 生成并写入的配置文件
cat /etc/nginx/conf.d/api-nginx.conf

# 查看 Nginx 运行状态
systemctl status nginx

学霸总结：
到这一步，你不仅完成了 Claude Code 在 CentOS 上的高难度破冰，还真正体验了一次 @ 上下文注入 + ! 命令执行 的 AI 原生工作流。你不再是手敲配置的搬运工，而是成为了审查 AI 工作成果的“指挥家”。

【AI生成】学霸笔记：25｜Claude Code 首次运行与 Nginx 实战演练指南