第一次使用

2026-10-06T00:00:00+00:00
cd</span> ~/ai-course/practice-claude</span></span></code></pre>
确认提示符显示的是这个文件夹以后，再用 Git 存档：</p>
git</span> init</span></span>
git</span> add .</span></span>
git</span> commit</span> -m</span> "开始之前"</span></span></code></pre>启动</h2>
claude</span></span></code></pre>
第一次启动时：</p>

选择界面配色。</li>
如果还没配置凭证，会要求登录；接入 XSI Router 的方法见凭证与接入 XSI Router</a>。</li>
询问是否信任这个文件夹。确认是你自己的文件夹后再选择信任。</li>
</ol>
进入后，底部是输入框，状态栏显示当前的权限模式。</p>
第一个问题：只读</h2>
按 Shift + Tab</code> 切换到 plan mode on</code>，然后输入：</p>
请先不要修改任何文件。告诉我这个文件夹里有哪些文件、各自是什么内容，有没有看起来重复的文件。</span></span></code></pre>
Claude Code 会运行一些读取命令，然后给出报告。核对一下它说的对不对，这是使用 AI 的基本功。</p>
第二个任务：小修改</h2>
切换回 manual mode on</code>，让它做一件小事，并要求先说方案：</p>
请新建一个 summary.md，汇总所有会议纪要里的待办事项（负责人、事项、截止日期）。先告诉我你打算怎么做，等我确认后再动手。</span></span></code></pre>
确认方案后回复“可以”。它要创建文件时会弹出审批提示，看清楚内容再允许。</p>
完成后，在终端里运行 git status</code>，summary.md</code> 会出现在 Untracked files（新文件）里。新文件不会出现在 git diff</code> 中，直接打开 summary.md</code> 检查内容即可。</p>
满意就提交存档；不满意，可以让它修改，或者连按两次 Esc</code> 回退。</p>
输入框里的小技巧</h2>
操作</th> 作用</th></tr></thead>

@文件名</code></td> 指定要它看的文件，例如 @expenses-2026-09.csv 帮我算总额</code></td></tr>
!命令</code></td> 直接在终端里运行一条命令，例如 !git status</code>，结果会进入对话</td></tr>
Esc</code></td> 打断它正在做的事</td></tr>
Esc</code> Esc</code></td> 输入框为空时连按两次，打开回退菜单</td></tr>
↑</code></td> 调出之前输入过的内容</td></tr>
Shift + Tab</code></td> 切换权限模式</td></tr>
/help</code></td> 查看所有命令</td></tr>
</tbody></table>
退出</h2>
输入 /exit</code>，或者连按两次 Ctrl + D</code>。下次在同一个文件夹里运行 claude -c</code>，可以接着上次的对话继续。</p>
好任务的写法</h2>
一个清晰的任务包含：</p>

目标</strong>：要完成什么。</li>
范围</strong>：只动哪些文件。</li>
限制</strong>：什么不能做，例如“不要删除文件”。</li>
验收</strong>：怎样算完成，例如“做完列出改了哪些文件”。</li>
</ul>
把大任务拆成小任务，做完一个、检查一个、存档一个，结果会稳定得多。</p>


进阶：Hooks、MCP 与插件
2026-10-06T00:00:00+00:00
Hooks：在固定时机自动执行</h2>
Hook</strong>（钩子）是在特定时机自动运行的命令，不需要 Claude 决定要不要做。常用时机：</p>
事件</th> 什么时候触发</th></tr></thead>

SessionStart</code></td> 会话开始或恢复时</td></tr>
UserPromptSubmit</code></td> 你发出消息、Claude 处理之前</td></tr>
PreToolUse</code></td> Claude 调用工具之前，可以拦截</td></tr>
PostToolUse</code></td> 工具调用成功之后</td></tr>
Notification</code></td> Claude Code 发出通知时，例如等待你审批</td></tr>
Stop</code></td> Claude 回答完毕时</td></tr>
</tbody></table>
Hooks 写在 settings.json 的 hooks</code> 里。例子：Claude Code 需要你操作时弹出系统通知，这样你可以去做别的事。</p>
macOS</strong>：</p>
{</span></span>
  "hooks"</span>: {</span></span>
    "Notification"</span>: [</span></span>
      {</span></span>
        "matcher"</span>:</span> ""</span>,</span></span>
        "hooks"</span>: [</span></span>
          {</span></span>
            "type"</span>:</span> "command"</span>,</span></span>
            "command"</span>:</span> "osascript -e 'display notification </span>\"</span>Claude Code needs your attention</span>\"</span> with title </span>\"</span>Claude Code</span>\"</span>'"</span></span>
          }</span></span>
        ]</span></span>
      }</span></span>
    ]</span></span>
  }</span></span>
}</span></span></code></pre>
Windows</strong>：</p>
{</span></span>
  "hooks"</span>: {</span></span>
    "Notification"</span>: [</span></span>
      {</span></span>
        "matcher"</span>:</span> ""</span>,</span></span>
        "hooks"</span>: [</span></span>
          {</span></span>
            "type"</span>:</span> "command"</span>,</span></span>
            "command"</span>:</span> "powershell.exe -Command </span>\"</span>[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')</span>\"</span>"</span></span>
          }</span></span>
        ]</span></span>
      }</span></span>
    ]</span></span>
  }</span></span>
}</span></span></code></pre>
如果 settings.json 里已经有其他内容，把 hooks</code> 这一段合并进去。输入 /hooks</code> 可以查看当前生效的 Hooks。</p>
Hook 会以你的身份自动执行命令。别人项目里的 .claude/settings.json</code> 可能带有 Hooks，打开不熟悉的项目时，Claude Code 会先询问是否信任这个文件夹，看清楚再确认。</p>
MCP：连接外部工具</h2>
MCP</strong>（Model Context Protocol）是一种让 AI 连接外部工具和数据的标准，例如文档库、项目管理系统、数据库。连接后，Claude 就能直接查询或操作这些工具。</p>
添加一个远程 MCP 服务器：</p>
claude</span> mcp add</span> --transport</span> http</span> <</span>名</span>称</span>> <</span>地</span>址</span>></span></span></code></pre>
例如：</p>
claude</span> mcp add</span> --transport</span> http notion https://mcp.notion.com/mcp</span></span></code></pre>
--scope</code> 决定它对哪些项目生效：</p>
范围</th> 生效位置</th> 保存在</th></tr></thead>

local</code>（默认）</td> 只在当前项目，只有你</td> ~/.claude.json</code></td></tr>
project</code></td> 当前项目，可以提交到 Git 与团队共享</td> 项目根目录的 .mcp.json</code></td></tr>
user</code></td> 你所有的项目</td> ~/.claude.json</code></td></tr>
</tbody></table>
会话中输入 /mcp</code> 查看连接状态，需要登录授权的服务也在这里完成。</p>
MCP 服务器能读取和修改它所连接的数据，只添加你信任的服务。</p>
插件：一次装好一整套</h2>
插件</strong>把技能、子代理、Hooks、MCP 服务器打包在一起，一次安装就能用上全部功能。插件来自“插件市场”（marketplace）。</p>
在会话中输入：</p>
/plugin</span></span></code></pre>
在 Discover</strong> 标签页浏览和安装插件，在管理页面启用、停用或卸载。</p>
区分官方市场和第三方市场：第三方插件可以包含会自动执行的 Hooks 和 MCP 服务器，安装前确认作者和来源。</p>
出问题时</h2>
扩展装多了，某个出错可能拖累整个会话。用下面的命令启动，暂时关闭所有插件、MCP 和 Hooks，方便判断问题出在哪里：</p>
claude</span> --safe-mode</span></span></code></pre>
更多细节见官方文档：Hooks</a>、MCP</a>、插件</a>。</p>


下载与安装
2026-10-06T00:00:00+00:00
系统要求</h2>

macOS 13 或更高版本；Windows 10（1809）或更高版本；Ubuntu 20.04+、Debian 10+ 等主流 Linux。</li>
4 GB 以上内存，x64 或 ARM64 处理器。</li>
能联网。</li>
</ul>
macOS、Linux、WSL</h2>
curl</span> -fsSL</span> https://claude.ai/install.sh</span> |</span> bash</span></span></code></pre>
也可以用 Homebrew 安装。这种方式不会自动更新，需要定期运行 brew upgrade claude-code</code>：</p>
brew</span> install</span> --cask</span> claude-code</span></span></code></pre>Windows</h2>
在 PowerShell</strong> 中运行：</p>
irm https:</span>//</span>claude.ai</span>/</span>install.ps1 </span>|</span> iex</span></span></code></pre>
在 CMD（命令提示符）</strong> 中运行：</p>
curl -fsSL https://claude.ai/install.cmd -o install.cmd </span>&&</span> install.cmd </span>&& del</span> install.cmd</span></span></code></pre>
也可以用 WinGet 安装（需要手动 winget upgrade</code> 更新）：</p>
winget install Anthropic.ClaudeCode</span></span></code></pre>
分清自己在哪个终端里：提示符以 PS C:\</code> 开头的是 PowerShell，没有 PS</code> 的是 CMD。如果看到 The token '&&' is not a valid statement separator</code>，说明你在 PowerShell 里运行了 CMD 的命令；看到 'irm' 不是内部或外部命令</code>，说明你在 CMD 里运行了 PowerShell 的命令。</p>
安装不需要管理员权限。</p>
Git for Windows 是可选的。</strong> 装了它，Claude Code 会用 Git Bash 执行命令；没装，就用 PowerShell 执行命令。推荐安装，很多教程和脚本默认使用 Bash：</p>
winget install </span>--</span>id Git.Git </span>-</span>e</span></span></code></pre>
WSL</strong>：在 WSL 里使用时，进入 WSL 后按上面 Linux 的方式安装，不需要 Git for Windows。Windows 原生和 WSL 是两个独立环境，在哪里运行 claude</code>，就要在哪里安装和配置。</p>
npm 安装</h2>
如果官方安装器下载失败，可以用 npm 安装（需要 Node.js 22 或更高版本）。国内可以加镜像参数：</p>
npm</span> install</span> -g</span> @anthropic-ai/claude-code</span> --registry=https://registry.npmmirror.com</span></span></code></pre>
npm 包安装的是同一个原生程序。升级时运行 npm install -g @anthropic-ai/claude-code@latest</code>，不要用 npm update -g</code>。不要用 sudo npm install -g</code>。</p>
检查安装</h2>
重新打开终端，运行：</p>
claude</span> --version</span></span>
claude</span> doctor</span></span></code></pre>
claude --version</code> 显示版本号说明安装成功；claude doctor</code> 会检查安装方式、配置文件和依赖，有问题会给出提示。</p>
如果提示找不到 claude</code> 命令，先关掉终端重新打开；还不行，见排错与更新</a>。</p>
卸载</h2>
原生安装（macOS、Linux、WSL）：</p>
rm</span> -f</span> ~/.local/bin/claude</span></span>
rm</span> -rf</span> ~/.local/share/claude</span></span></code></pre>
Windows 原生安装（PowerShell）：</p>
Remove-Item</span> -</span>Path </span>"</span>$</span>env:</span>USERPROFILE</span>\.local\bin\claude.exe"</span> -</span>Force</span></span>
Remove-Item</span> -</span>Path </span>"</span>$</span>env:</span>USERPROFILE</span>\.local\share\claude"</span> -</span>Recurse </span>-</span>Force</span></span></code></pre>
Homebrew、WinGet、npm 安装的，用对应的包管理器卸载。配置和会话记录在 ~/.claude</code> 目录和 ~/.claude.json</code> 文件里，确定不再需要时再删除。</p>


权限与安全
2026-10-06T00:00:00+00:00
权限模式</h2>
模式</th> 不用问你就能做的事</th> 适合</th></tr></thead>

手动（Manual，配置值 default</code>）</td> 只能读取</td> 新手、敏感操作，每一步都自己把关</td></tr>
接受修改（acceptEdits</code>）</td> 读取、修改文件、常见的文件操作命令（mkdir</code>、mv</code>、cp</code> 等）</td> 你在一旁审阅的日常修改</td></tr>
计划（plan</code>）</td> 读取和调查，只提方案、不改源文件</td> 动手之前先研究、先出方案</td></tr>
自动（auto</code>）</td> 几乎所有操作，由另一个模型在后台做安全检查</td> 熟练用户的长任务</td></tr>
跳过权限（bypassPermissions</code>）</td> 所有操作</td> 只适合隔离的容器或虚拟机</td></tr>
</tbody></table>
会话中按 Shift + Tab</code> 循环切换模式，底部状态栏会显示当前模式，例如 manual mode on</code>、accept edits on</code>、plan mode on</code>、auto mode on</code>。也可以在启动时指定：</p>
claude</span> --permission-mode</span> plan</span></span></code></pre>新版默认是自动模式</h2>
从 v2.1.283 起，在终端里启动的会话默认进入自动模式</strong>：由一个分类模型替你判断操作是否安全，而不是每次都问你。它很方便，但新手很难知道它到底做了什么。</p>
建议在 ~/.claude/settings.json</code> 中把默认模式改成手动：</p>
{</span></span>
  "permissions"</span>: {</span></span>
    "defaultMode"</span>:</span> "default"</span></span>
  }</span></span>
}</span></span></code></pre>
下次启动时，状态栏会显示 ⏸ manual mode on</code>。熟练以后，再按需切换到其他模式。</p>
计划模式里也有同样的问题：只要自动模式可用，计划阶段调查用的命令默认也由分类模型替你批准。想在计划模式里也由自己审批，再加上顶层设置 "useAutoModeDuringPlan": false</code>。关闭后，内置只读命令之外的命令都会先问你（用 --dangerously-skip-permissions</code> 等方式启用了跳过权限的交互式终端会话除外：那里计划阶段的命令大多既不经过分类模型、也不询问你，只有少数情况仍会提示，所以不要那样启动）：</p>
{</span></span>
  "permissions"</span>: {</span></span>
    "defaultMode"</span>:</span> "default"</span></span>
  },</span></span>
  "useAutoModeDuringPlan"</span>:</span> false</span></span>
}</span></span></code></pre>
这个设置要写在个人的 ~/.claude/settings.json</code> 或项目本地的 .claude/settings.local.json</code> 里；写在项目共享的 .claude/settings.json</code> 里的 false</code> 会被忽略。反过来，即使公司托管配置设成了 true</code>，你个人或项目本地的 false</code> 仍然生效。</p>
审批提示</h2>
在手动模式下，Claude Code 要修改文件或运行命令时，会显示具体内容并请你确认。你可以只允许这一次、选择以后不再询问（Yes, and don't ask again），或者拒绝。拒绝时可以顺便告诉它应该怎么做。</p>
“不再询问”的有效期因操作而异：</p>
操作</th> 选“不再询问”后</th></tr></thead>

修改文件</td> 本次会话结束前不再询问</td></tr>
运行某类命令、访问某个网站</td> 在这个项目里永久</strong>不再询问，规则保存到 .claude/settings.local.json</code></td></tr>
</tbody></table>
所以对命令选“不再询问”要慎重。选错了可以输入 /permissions</code> 找到对应规则删除。</p>
判断标准只有一条：看得懂、并且是你想要的，才允许。</strong> 看不懂就拒绝，然后问它“这条命令是做什么的”。</p>
允许、询问、拒绝规则</h2>
对经常重复的安全操作，可以写规则让它不再询问；对危险操作，可以写规则直接拒绝。规则写在 settings.json 的 permissions</code> 里：</p>
{</span></span>
  "permissions"</span>: {</span></span>
    "allow"</span>: [</span></span>
      "Bash(npm run *)"</span>,</span></span>
      "Bash(git commit *)"</span></span>
    ],</span></span>
    "deny"</span>: [</span></span>
      "Bash(git push *)"</span>,</span></span>
      "Read(./.env)"</span></span>
    ]</span></span>
  }</span></span>
}</span></span></code></pre>

allow</code>：直接允许；ask</code>：总是询问；deny</code>：直接拒绝。</li>
Bash(npm run *)</code> 中的 *</code> 代表任意内容，这条规则允许所有 npm run ...</code> 命令。</li>
拒绝优先：同一个操作同时匹配 deny</code> 和 allow</code> 时，按 deny</code> 处理。</li>
Read(./.env)</code> 禁止读取 .env</code> 文件，也会阻止修改它。但它只管 Claude 自带的文件工具和 cat</code> 这类它认得的命令，挡不住脚本程序自己去读。</li>
</ul>
在会话中输入 /permissions</code> 可以查看和编辑规则。</p>
沙箱</h2>
在 macOS、Linux 和 WSL 2 上，可以用 /sandbox</code> 打开沙箱：Claude Code 运行的命令会被限制在指定的文件和网络范围内。Windows 原生和 WSL 1 暂不支持。沙箱和权限模式可以叠加使用。</p>
回退：撤销 Claude 的修改</h2>
Claude Code 会在你每次发出新任务前自动保存一个检查点。输入框为空时连按两次 Esc</code>，或者输入 /rewind</code>，打开回退菜单，选择要回到的那一步：</p>

Restore code and conversation</strong>：代码和对话都回到那一步；</li>
Restore conversation</strong>：只回退对话，保留现在的代码；</li>
Restore code</strong>：只回退代码，保留对话。</li>
</ul>
回退有边界：</p>

通过 Bash 命令做的改动（例如 rm</code>、mv</code>、脚本生成的文件）不会</strong>被记录，回退不了；</li>
你自己在 Claude Code 之外手动做的修改也不会被记录。</li>
</ul>
所以，检查点不能代替 Git。动手做大改动之前，先用 Git 提交一个存档。</p>
跳过权限要非常谨慎</h2>
claude --dangerously-skip-permissions</code> 会跳过所有权限确认。只在可以随时丢弃的容器、虚拟机里使用，不要在自己的电脑、生产服务器或存有密钥的目录里使用。网上一些“懒人配置”会默认开启它，复制配置前先看清楚。</p>
操作习惯</h2>

先用计划模式让它说清方案，确认后再切换模式让它动手。</li>
每轮修改后用 git diff</code> 查看改动。</li>
对删除、覆盖、推送、提权类的命令保持警惕。</li>
不要让它读取或输出密钥；把密钥放在环境变量里，并用 deny</code> 规则挡住 .env</code> 文件。</li>
</ul>


排错与更新
2026-10-06T00:00:00+00:00
先运行自检</h2>
claude</span> doctor</span></span></code></pre>
它会检查安装方式、版本、配置文件和依赖，并指出问题所在。</p>
找不到 claude 命令</h2>
报错类似 command not found: claude</code> 或 'claude' 不是内部或外部命令</code>，说明安装目录不在 PATH 里。</p>

先关掉终端，重新打开。</li>
还不行，检查原生安装目录 ~/.local/bin</code> 是否在 PATH 中。</li>
</ol>
macOS（zsh）</strong>：</p>
echo</span> $PATH</span> |</span> tr</span> ':' '\n'</span> |</span> grep</span> -Fx</span> "</span>$HOME</span>/.local/bin"</span></span></code></pre>
没有输出就加进去：</p>
echo</span> 'export PATH="$HOME/.local/bin:$PATH"'</span> >></span> ~/.zshrc</span></span>
source</span> ~/.zshrc</span></span></code></pre>
Linux 默认的 bash 写入 ~/.bashrc</code>。</p>
Windows（PowerShell）</strong>：</p>
$</span>env:</span>PATH</span> -split</span> ';'</span> |</span> Select-String</span> '\.local\\bin'</span></span></code></pre>
没有输出就加进用户 PATH，然后重开终端：</p>
$currentPath</span> =</span> [</span>Environment</span>]::GetEnvironmentVariable(</span>'PATH'</span>,</span> 'User'</span>)</span></span>
[</span>Environment</span>]::SetEnvironmentVariable(</span>'PATH'</span>,</span> "</span>$currentPath</span>;</span>$</span>env:</span>USERPROFILE</span>\.local\bin"</span>,</span> 'User'</span>)</span></span></code></pre>安装命令报错</h2>
看到的报错</th> 原因和解决</th></tr></thead>

irm is not recognized</code> / 'irm' 不是内部或外部命令</code></td> 在 CMD 里运行了 PowerShell 命令，换用 CMD 的安装命令或打开 PowerShell</td></tr>
The token '&&' is not a valid statement separator</code></td> 在 PowerShell 里运行了 CMD 命令，换用 PowerShell 的安装命令</td></tr>
syntax error near unexpected token '<'</code></td> 下载到的是网页而不是脚本，通常是网络问题</td></tr>
Failed to fetch version</code>、连接超时</td> 无法访问下载服务器，检查网络和代理，或改用 npm 加镜像安装</td></tr>
EACCES: permission denied</code></td> 安装目录权限不对，不要用 sudo</code> 硬装，按 claude doctor</code> 的提示修复</td></tr>
</tbody></table>
登录与 401</h2>
明明设置了 Key，还是要求浏览器登录？</strong> 说明 Claude Code 没读到 ANTHROPIC_AUTH_TOKEN</code>。确认重开过终端，或者改用 settings.json 的 env</code> 配置，见凭证与接入 XSI Router</a>。</p>
报 401、认证失败？</strong></p>

Key 复制错了：多了空格、少了字符。</li>
ANTHROPIC_BASE_URL</code> 写错了，应为 https://api.xsirouter.com</code>，不要加 /v1</code>。</li>
有残留的旧变量。ANTHROPIC_AUTH_TOKEN</code> 优先于 ANTHROPIC_API_KEY</code>，检查两者，删掉不用的那个。</li>
</ul>
用 /status</code> 查看当前实际生效的登录方式。</p>
报 429、额度不足？</strong> 账户额度用完或请求过于频繁，到账户后台查看。</p>
网络和代理</h2>

需要通过代理上网时，设置 HTTPS_PROXY</code>（必要时加 HTTP_PROXY</code>、NO_PROXY</code>）。</li>
公司代理使用自签证书时，设置 NODE_EXTRA_CA_CERTS</code> 指向证书文件，否则会报 TLS 或证书错误。</li>
访问 Anthropic 官方服务不稳定时，可以设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1</code>，关闭自动更新、遥测等非必要请求，之后改为手动更新。</li>
</ul>
卡顿、占用高</h2>

长对话用 /compact</code> 压缩，换任务时用 /clear</code>。</li>
会话卡住时按 Ctrl + C</code> 退出，再用 claude --continue</code> 接着之前的对话。</li>
怀疑是插件、MCP 或 Hooks 引起的问题，用 claude --safe-mode</code> 启动，它会暂时关闭所有自定义扩展，方便判断。</li>
WSL 中把项目放在 Linux 的家目录（/home/...</code>）下，不要放在 /mnt/c/...</code>，搜索文件会快很多。</li>
</ul>
更新</h2>
原生安装默认在后台自动更新，下次启动时生效。手动更新：</p>
claude</span> update</span></span></code></pre>
Homebrew、WinGet 安装的不会自动更新，分别用 brew upgrade claude-code</code>、winget upgrade Anthropic.ClaudeCode</code>。npm 安装的用 npm install -g @anthropic-ai/claude-code@latest</code>。</p>
在 settings.json 的 env</code> 中设置 "DISABLE_AUTOUPDATER": "1"</code> 可以关闭后台自动更新，claude update</code> 仍然可用。</p>
仍然解决不了</h2>
把这些信息整理好，交给 AI 或发给客服：</p>

操作系统和终端类型（PowerShell、CMD、macOS 终端、WSL）；</li>
claude --version</code> 的输出；</li>
claude doctor</code> 的输出；</li>
完整的报错信息（记得先删掉其中的 Key）。</li>
</ul>


Claude Code 是什么
2026-10-06T00:00:00+00:00
它能做什么</h2>
在一个文件夹里启动 Claude Code，用中文告诉它你想做什么，它会自己动手：</p>

阅读文件夹里的文件，回答“这个项目是做什么的”“这段代码什么意思”；</li>
运行命令，比如统计数据、安装依赖、运行测试；</li>
新建和修改文件，写代码、写文档、整理资料；</li>
用 Git 查看改动、提交存档。</li>
</ul>
它和网页版聊天 AI 最大的区别是能动手</strong>。所以要给它划定权限：哪些事直接做、哪些事先征求你的同意，由你选择的权限模式和规则决定，详见权限与安全</a>。</p>
使用入口</h2>
入口</th> 说明</th></tr></thead>

终端（CLI）</td> 在终端里运行 claude</code>，功能最完整，本专题以它为主</td></tr>
桌面 App</td> macOS、Windows、Linux 桌面应用，可以并行多个会话、可视化查看改动</td></tr>
网页版</td> claude.ai/code</a>，任务在云端运行</td></tr>
IDE 扩展</td> VS Code、JetBrains 系列编辑器中的插件</td></tr>
其他</td> 手机 App、Slack、GitHub Actions 等，适合团队协作和自动化</td></tr>
</tbody></table>
本专题只讲终端。终端版最通用：在自己电脑上能用，以后 SSH 登录到云服务器上也能用。</p>
怎样付费</h2>
Claude Code 本身免费下载，模型调用需要付费。常见的方式有三种：</p>

登录 Claude 官方订阅账号（Pro、Max、Team 等）。</li>
使用 Anthropic Console 的 API Key，按用量付费。</li>
通过 API 网关接入，例如本站 XSI Router：设置两个环境变量即可，不需要 Claude 官方账号。</li>
</ol>
本专题以第 3 种为例，见凭证与接入 XSI Router</a>。</p>
和 Codex、Grok CLI 的关系</h2>
三者都是编程智能体，用法相似：在文件夹里启动、用自然语言下达任务、审批它的操作。主要区别在于背后的模型和配置方式。它们可以共用同一个 XSI Router Key。</p>
工具</th> 命令</th> 本站专题</th></tr></thead>

Claude Code</td> claude</code></td> 本专题</td></tr>
Codex</td> codex</code></td> Codex 专题</a></td></tr>
Grok CLI</td> grok</code></td> Grok 专题</a></td></tr>
</tbody></table>
如果你的项目里已经有给 Codex 写的 AGENTS.md</code>，Claude Code 在没有 CLAUDE.md</code> 时也会读取它，不用重复写一份。</p>


日常工作流
2026-10-06T00:00:00+00:00
CLAUDE.md：给项目立规矩</h2>
每次会话开始时，Claude Code 会读取 CLAUDE.md</code> 文件，把里面的内容当作长期指令。适合写：</p>

项目是做什么的、目录结构；</li>
怎么运行、怎么测试；</li>
团队的约定，例如“回答用中文”“不要修改 migrations 目录”。</li>
</ul>
位置</th> 作用范围</th></tr></thead>

~/.claude/CLAUDE.md</code></td> 你所有的项目</td></tr>
项目/CLAUDE.md</code> 或 项目/.claude/CLAUDE.md</code></td> 这个项目，可以提交到 Git 与团队共享</td></tr>
项目/CLAUDE.local.md</code></td> 这个项目，只属于你，记得加进 .gitignore</code></td></tr>
</tbody></table>
在项目里运行 /init</code>，Claude Code 会分析项目并生成一份 CLAUDE.md</code> 草稿，你再按需修改。</p>
如果项目里已经有给 Codex 等工具写的 AGENTS.md</code>，并且没有 CLAUDE.md</code>，Claude Code 会直接读取 AGENTS.md</code>。</p>
除了你写的 CLAUDE.md</code>，Claude Code 还会自动记录一些它学到的项目经验（自动记忆），输入 /memory</code> 可以查看和管理。</p>
先计划，再动手</h2>
改动较大的任务，推荐这个流程：</p>

按 Shift + Tab</code> 切换到 plan mode on</code>，描述任务，让它调查并给出方案。</li>
审查方案，有问题就直接提出修改意见。</li>
方案确定后切换到 manual mode on</code> 或 accept edits on</code>，让它执行。</li>
用 git diff</code> 检查改动，运行测试，满意后提交。</li>
</ol>
管理上下文</h2>
对话越长，模型要读的内容越多，速度越慢、花费越高，也越容易被前面的内容干扰。</p>

/clear</code>：开始新对话。换一件事时用它。</li>
/compact</code>：把前面的对话压缩成摘要，保留要点、腾出空间。</li>
/context</code>：查看当前上下文的使用情况。</li>
</ul>
接着上次继续</h2>
claude</span> -c</span></span></code></pre>
继续当前文件夹里最近的一次对话。</p>
claude</span> -r</span></span></code></pre>
列出之前的对话，选一个继续。会话中也可以用 /resume</code>。</p>
单次命令</h2>
不进入交互界面，直接问一个问题、拿到结果：</p>
claude</span> -p</span> "用一句话总结 README.md 的内容"</span></span></code></pre>
适合写进脚本。注意 -p</code> 模式下没有人可以点审批，需要的权限要提前用规则配置好。</p>
常用命令速查</h2>
命令</th> 作用</th></tr></thead>

/help</code></td> 所有可用命令</td></tr>
/clear</code></td> 新对话</td></tr>
/compact</code></td> 压缩上下文</td></tr>
/resume</code></td> 恢复之前的对话</td></tr>
/rewind</code></td> 回退到之前的检查点</td></tr>
/model</code></td> 切换模型</td></tr>
/status</code></td> 查看登录方式、模型和配置来源</td></tr>
/config</code></td> 设置菜单</td></tr>
/permissions</code></td> 查看和编辑权限规则</td></tr>
/init</code></td> 生成 CLAUDE.md</td></tr>
/memory</code></td> 查看自动记忆</td></tr>
/doctor</code></td> 自检</td></tr>
</tbody></table>
和 Git 配合</h2>

开始一项任务前，确认工作区是干净的（git status</code>），或者先提交一个存档。</li>
让 Claude Code 做完一件事就提交一次，说明写清楚做了什么。</li>
回退菜单只能撤销 Claude 用编辑工具做的修改；Git 能把任何改动恢复到上一次提交的样子，两者配合最稳妥。</li>
</ul>


凭证与接入 XSI Router
2026-10-06T00:00:00+00:00
三种凭证</h2>
方式</th> 怎么用</th> 谁来计费</th></tr></thead>

Claude 订阅账号</td> 启动后按提示在浏览器登录，或运行 /login</code></td> 你的 Claude 订阅</td></tr>
Anthropic API Key</td> 环境变量 ANTHROPIC_API_KEY</code></td> Anthropic Console 账户</td></tr>
API 网关凭证</td> 环境变量 ANTHROPIC_BASE_URL</code> + ANTHROPIC_AUTH_TOKEN</code></td> 网关账户，例如 XSI Router</td></tr>
</tbody></table>
同时存在多种凭证时，Claude Code 按固定顺序选择：ANTHROPIC_AUTH_TOKEN</code> 优先于 ANTHROPIC_API_KEY</code>，两者都优先于浏览器登录的订阅账号。</p>
两个容易踩的坑：</p>

只设置 ANTHROPIC_BASE_URL</code>、不设置凭证</strong>：如果你之前登录过订阅账号，请求会经过新地址，但仍然使用订阅账号计费。接入 XSI Router 时两个变量都要设置。</li>
残留的旧变量</strong>：以前设置过 ANTHROPIC_API_KEY</code>，现在又设置了 ANTHROPIC_AUTH_TOKEN</code>，生效的是后者。排查问题时记得检查有没有残留的变量。</li>
</ul>
获取 Key</h2>
在 m.xsirouter.com</a> 注册账号，系统会把 API Key 发到注册邮箱。Key 等同于你的钱包，不要截图、外发或提交到代码仓库。</p>
方式一：环境变量</h2>
适合你已经习惯用环境变量管理 Key 的情况。</p>
macOS / Linux</strong>（zsh 写入 ~/.zshrc</code>，bash 写入 ~/.bashrc</code>）：</p>
echo</span> 'export ANTHROPIC_BASE_URL="https://api.xsirouter.com"'</span> >></span> ~/.zshrc</span></span>
echo</span> 'export ANTHROPIC_AUTH_TOKEN="sk-你的Key"'</span> >></span> ~/.zshrc</span></span></code></pre>
Windows</strong>（PowerShell）：</p>
setx ANTHROPIC_BASE_URL </span>"https://api.xsirouter.com"</span></span>
setx ANTHROPIC_AUTH_TOKEN </span>"sk-你的Key"</span></span></code></pre>
设置后重新打开终端</strong>。检查 Key 的长度（不会把 Key 显示出来）：</p>
echo</span> ${</span>#</span>ANTHROPIC_AUTH_TOKEN}</span></span></code></pre>$</span>env:</span>ANTHROPIC_AUTH_TOKEN.Length</span></span></code></pre>方式二：settings.json</h2>
把变量写进 Claude Code 自己的配置文件 ~/.claude/settings.json</code>（Windows 为 %USERPROFILE%\.claude\settings.json</code>）的 env</code> 中，只对 Claude Code 生效，也不受终端类型影响：</p>
{</span></span>
  "env"</span>: {</span></span>
    "ANTHROPIC_BASE_URL"</span>:</span> "https://api.xsirouter.com"</span>,</span></span>
    "ANTHROPIC_AUTH_TOKEN"</span>:</span> "sk-你的Key"</span></span>
  },</span></span>
  "permissions"</span>: {</span></span>
    "defaultMode"</span>:</span> "default"</span></span>
  }</span></span>
}</span></span></code></pre>
permissions.defaultMode</code> 让每次会话都从“手动审批”模式开始，原因见权限与安全</a>。</p>
这个文件里有明文 Key：只在个人电脑上这样做，不要把它分享出去，也不要把含 Key 的配置放进项目仓库的 .claude/settings.json</code>。</p>
验证</h2>
claude</span></span></code></pre>
设置了 ANTHROPIC_AUTH_TOKEN</code> 后，Claude Code 不会再要求浏览器登录。进入后输入 /status</code>，确认登录方式和 API 地址；再随便问一句，比如“你好，用一句话介绍你自己”，能正常回复即接入成功。</p>
选择模型</h2>

会话中输入 /model</code>，从列表里选择。</li>
启动时指定：claude --model claude-sonnet-5-5</code>。</li>
用环境变量 ANTHROPIC_MODEL</code> 设置默认模型；--model</code> 和 /model</code> 的优先级比它高。</li>
</ul>
XSI Router 上可用的 Claude 模型见模型页</a>，例如 claude-opus-5-5</code>、claude-sonnet-5-5</code>、claude-haiku-4-5</code>。</p>
网络受限时</h2>
如果你的网络访问 Anthropic 官方服务不稳定，可以设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1</code>，关闭自动更新、遥测、错误上报等非必要的网络请求，只保留模型调用。代价是不会再自动更新，需要定期手动运行 claude update</code>。</p>
公司网络需要代理时，设置 HTTPS_PROXY</code>；如果代理使用公司自签的证书，再设置 NODE_EXTRA_CA_CERTS</code> 指向证书文件。</p>


让 AI 动手改文件
2026-10-06T00:00:00+00:00
本课目标</h2>

用“目标、范围、规则、验收”四要素写需求。</li>
让 AI 先说计划，确认后再动手。</li>
用 Git 验收改动，满意就存档，不满意就恢复。</li>
用 AGENTS.md</code> 给 AI 立长期规矩。</li>
</ul>
先懂概念：好需求的四要素</h2>
AI 不会读心。需求越含糊，它越要靠猜，猜错了就得返工。一个好需求包含：</p>
要素</th> 回答的问题</th> 例子</th></tr></thead>

目标</td> 要达到什么效果？</td> 让文件一眼就能找到</td></tr>
范围</td> 动哪些东西？</td> 只整理这个文件夹</td></tr>
规则</td> 什么不能做？</td> 不要删除任何文件</td></tr>
验收</td> 怎样算做完、做对？</td> 做完列出改了哪些文件</td></tr>
</tbody></table>
再加一个好习惯：先让它说计划，你同意后再动手。</strong></p>
跟着做</h2>
1. 确认有存档</h3>
cd</span> ~/ai-course/practice-pack</span></span>
git</span> status</span></span></code></pre>
看到 nothing to commit, working tree clean</code> 再继续。如果不是，先回第 8 课做好存档。</p>
2. 用默认权限启动 Codex</h3>
codex</span></span></code></pre>
这次不加 --sandbox read-only</code>，Codex 会使用第 6 课配置的默认权限：可以改当前文件夹里的文件，越界时先问你。</p>
3. 发出需求</h3>
请帮我整理这个文件夹。</span></span>
</span>
目标：让文件一眼就能找到。</span></span>
范围：只整理当前文件夹，不要动外面的任何东西。</span></span>
要求：</span></span>
1. 建三个子文件夹：meetings（会议纪要）、expenses（报销）、customers（客户）。</span></span>
2. 把文件移到对应的文件夹，改成“日期在前、英文小写、用连字符”的名字，例如 meetings/2026-09-15-weekly-meeting.txt。</span></span>
3. 不要删除任何文件。重复的文件、空文件和 old 文件夹里的文件，统一移到 to-review 文件夹，等我决定。</span></span>
4. 新建 summary.md，写上所有会议待办事项的表格（负责人、事项、截止日期；同一事项只列一次，截止日期有冲突时两个都写上并标注待确认），以及 9 月和 10 月的报销总额。</span></span>
验收：做之前先告诉我你的计划，等我回复“可以”再动手；做完后列出你移动、改名和新建了哪些文件。</span></span></code></pre>4. 审查计划</h3>
Codex 会先列出计划。逐条看一遍：</p>

每个文件打算放到哪里、改成什么名字？</li>
有没有哪一步写着“删除”？</li>
有没有要动当前文件夹以外的东西？</li>
</ul>
有不满意的地方就直接说，比如“todo list.txt 不属于这三类，也放进 to-review”。确认没问题后回复：</p>
可以，按计划执行。</span></span></code></pre>
执行过程中如果弹出审批提示，按第 7 课的规矩判断。</p>
你应该看到</h2>
用 Git 验收</h3>
退出 Codex（/quit</code>）或者新开一个终端，进入练习包运行：</p>
git</span> add</span> -A</span></span>
git</span> status</span></span></code></pre>
git add -A</code> 把这次所有的改动交给 Git 比较。git status</code> 会列出：</p>

renamed: 旧名字 -> 新名字</code>：文件被移动或改名，内容基本没变；</li>
new file: summary.md</code>：新建的文件；</li>
deleted: ...</code>：如果出现这一行，说明有文件被删了</strong>，要找 AI 问清楚。</li>
</ul>
想确认被移动的文件内容一点没变，运行：</p>
git</span> diff</span> --cached</span></span></code></pre>
单纯移动、改名的文件只会显示 rename from</code> 和 rename to</code>；如果某个文件下面出现了以 +</code>、-</code> 开头的行，说明它的内容也被改了，要问清楚为什么。看完按 q</code> 退出。</p>
再打开 summary.md</code>，用第 7 课的标准答案核对：9 条待办，9 月 1622.40 元，10 月 1553.50 元。</p>
满意：存档</h3>
git</span> commit</span> -m</span> "整理练习包"</span></span></code></pre>
也可以直接对 Codex 说“帮我提交一个存档，说明写‘整理练习包’”。它要运行 git commit</code> 时可能会请你批准，这正是你想要的，选 Yes。</p>
不满意：恢复</h3>
按第 8 课的后悔药步骤来。刚才运行过 git add -A</code>，第一步的 git restore --staged .</code> 不能省：</p>
git</span> restore</span> --staged</span> .</span></span>
git</span> restore .</span></span></code></pre>
预览新冒出来的文件夹和文件：</p>
git</span> clean</span> -nd</span></span></code></pre>
确认清单里只有 AI 新建的东西（meetings</code>、expenses</code>、customers</code>、to-review</code>、summary.md</code> 等），再删除：</p>
git</span> clean</span> -fd</span></span></code></pre>
文件夹会回到“原始文件”存档时的样子，你可以改改需求重新来一次。</p>
给 AI 立长期规矩：AGENTS.md</h2>
每次都在需求里写“用中文回答”“不要删除文件”，很快就烦了。把这些长期规矩写进文件夹里的 AGENTS.md</code>，Codex 每次在这个文件夹启动时都会先读它。</p>
让 Codex 帮你创建：</p>
请在当前文件夹创建 AGENTS.md，写入以下规则：</span></span>
- 始终用中文回答。</span></span>
- 不要删除任何文件；需要清理的文件移到 to-review 文件夹。</span></span>
- 文件名使用“日期在前、英文小写、用连字符”的格式。</span></span>
- 动手修改之前，先说明计划并等我确认。</span></span></code></pre>
创建好以后，输入 /new</code> 开一段新对话，问它：</p>
这个文件夹有什么规矩？</span></span></code></pre>
它应该能复述出你写的规则。最后别忘了把 AGENTS.md</code> 也存进 Git：</p>
git</span> add</span> -A</span></span>
git</span> commit</span> -m</span> "添加 AGENTS.md"</span></span></code></pre>常见问题</h2>
它没等我确认就动手了？</strong> 按 Esc</code> 打断，用后悔药恢复，然后把“等我回复‘可以’再动手”写得更醒目，或者写进 AGENTS.md</code>。</p>
整理结果和我想的不一样？</strong> 很正常。不必从头再来，直接告诉它哪里不对，比如“客户文件不要改名，保留原名”。</p>
一次要做的事太多，它做乱了？</strong> 把大任务拆成几个小任务，做完一个、验收一个、存档一个。</p>
可以让它整理我真实的工作文件吗？</strong> 可以，但一定先复制一份副本，或者先用 Git 存档，并且只给它需要的那个文件夹。</p>
自检</h2>


我能写出包含目标、范围、规则、验收的需求。</li>

我审查过 AI 的计划后才让它动手。</li>

我用 git status</code> 检查过有没有文件被删。</li>

练习包已经整理好并存档，AGENTS.md</code> 也已经存档。</li>
</ul>


让 AI 帮你运维服务器
2026-10-06T00:00:00+00:00
本课目标</h2>

建一个运维专用文件夹，用 AGENTS.md</code> 写好规矩。</li>
让 Codex 通过 SSH 检查服务器、分析日志。</li>
知道哪些审批绝不能“一劳永逸”。</li>
</ul>
先懂概念：AI 在你电脑上，手伸到服务器</h2>
也可以把 Codex 装到服务器上，但那样要把 Key 放到服务器上，AI 在服务器上的每个动作也更难把关。这里用更稳妥的做法：</p>
你 ──▶ 本地 Codex ──ssh ai-server "命令"──▶ 服务器</span></span>
                 ◀──────── 命令输出 ─────────</span></span></code></pre>
Codex 默认的沙箱不允许联网，所以它每次想运行 ssh</code> 都会停下来请你审批。这正好：每一条在服务器上执行的命令，你都会先看到。</strong></p>
跟着做</h2>
1. 建运维文件夹和规矩</h3>
mkdir</span> ~/ai-course/ops</span></span>
cd</span> ~/ai-course/ops</span></span>
git</span> init</span></span>
codex</span></span></code></pre>请在当前文件夹创建 AGENTS.md，写入以下规则：</span></span>
- 你是我的服务器运维助手，始终用中文回答。</span></span>
- 服务器的 SSH 别名是 ai-server，系统是 Ubuntu。周报助手部署在 ~/apps/weekly-report，用 docker compose 管理，源代码在 ~/weekly-report。</span></span>
- 先用只读命令诊断，例如 docker compose ps、docker compose logs、df -h、free -h、systemctl status。</span></span>
- 任何会修改服务器的操作（重启服务、删除文件、改配置、安装软件），先说明原因、命令和影响，等我确认后再执行。</span></span>
- 不要读取或输出 .env、tunnel.env、certs 目录以及任何密钥文件的内容。</span></span>
- 每次只通过 ssh ai-server "命令" 执行一条命令。</span></span></code></pre>
创建好后存档：</p>
git</span> add</span> -A</span></span>
git</span> commit</span> -m</span> "运维规矩"</span></span></code></pre>2. 让它做一次体检</h3>
重新启动 Codex（/new</code> 或退出后再运行 codex</code>），发出：</p>
请给 ai-server 做一次体检：周报助手的容器是否正常运行、最近 100 行日志里有没有报错、磁盘和内存是否充足。最后给我一份简短的结论。</span></span></code></pre>3. 逐条审批</h3>
Codex 会弹出审批，显示类似这样的命令：</p>
ssh ai-server "cd ~/apps/weekly-report && docker compose ps"</span></span></code></pre>
每一条都看清楚：是不是只读的？有没有碰密钥文件？看得懂、没问题再选 Yes, proceed</strong>。</p>

不要选 “Yes, and don't ask again for commands that start with ssh ai-server</code>”</strong>。这等于允许它以后在服务器上不经询问执行任何命令。</p>
</blockquote>
你应该看到</h2>
一份中文体检报告：容器状态、日志里的异常、磁盘和内存使用情况，以及它的建议。和你自己用第 16、21 课学过的命令查到的结果对照一下。</p>
实用的提问</h2>
网站打不开，Cloudflare 显示 522，请帮我排查原因，先只做检查。</span></span></code></pre>服务器上有哪些系统更新可以安装？先列出来，不要安装。</span></span></code></pre>docker 占用了多少磁盘？哪些旧镜像可以安全清理？先列出来，等我确认。</span></span></code></pre>注意事项</h2>

私钥设了密码短语？</strong> Codex 运行的 ssh</code> 无法替你输入密码短语，会连接失败。macOS 可以先运行 ssh-add</code> 把密钥交给系统的钥匙串代理；Windows 需要启用“OpenSSH Authentication Agent”服务后运行 ssh-add</code>。</li>
AI 看得到命令输出。</strong> 所以规则里禁止它读取密钥文件。你自己也不要让它运行 cat .env</code> 这类命令。</li>
修改操作由你决定。</strong> 重启、删除、改配置之前，让它先说清楚会发生什么；拿不准就不批准，按课程里学过的方法手动做。</li>
</ul>
自检</h2>


AGENTS.md</code> 里写清了服务器信息和规矩。</li>

Codex 通过 SSH 完成了一次体检，每条命令都经过我批准。</li>

我知道为什么不能对 ssh ai-server</code> 选“不再询问”。</li>
</ul>


周报助手·AI 版
2026-10-06T00:00:00+00:00
本课目标</h2>

让服务器调用 API 生成周报。</li>
理解为什么 Key 只能放在服务器端，并且放在环境变量里。</li>
处理 AI 失败和超时：自动退回规则版。</li>
确认 Key 没有出现在代码和存档里。</li>
</ul>
先懂概念：为什么由服务器去调用 AI</h2>
网页上的代码会被下载到访问者的浏览器里，任何人按 F12</code> 都能看到。如果把 Key 写在网页里，等于把钱包挂在门口。</p>
所以正确的做法是：</p>
浏览器 ──提交工作记录──▶ 你的服务器 ──带着 Key 调用──▶ AI 接口</span></span>
浏览器 ◀──返回周报────── 你的服务器 ◀──返回结果──────── AI 接口</span></span></code></pre>
Key 只存在于服务器的环境变量里，浏览器自始至终看不到它。</p>
另外，网络会断、接口会超时、余额会用完。好的程序要考虑失败的情况：AI 不可用时，自动用规则版生成，并告诉用户发生了什么。</p>
跟着做</h2>
1. 确认 Key 还在</h3>
第 6 课已经把 Key 永久设置在 XAI_API_KEY</code> 里了：</p>
$</span>env:</span>XAI_API_KEY.Length</span></span></code></pre>echo</span> ${</span>#</span>XAI_API_KEY}</span></span></code></pre>
显示一个数字即可。</p>
2. 写需求，交给 AI</h3>
cd</span> ~/ai-course/weekly-report</span></span>
codex</span></span></code></pre>请给周报助手加上 AI 生成功能，保留现有的规则版。</span></span>
</span>
接口与配置（全部从环境变量读取，代码里不能出现任何 Key）：</span></span>
- XAI_API_KEY：API Key。没有设置时只用规则版，并在返回结果里提示“没有设置 XAI_API_KEY，已使用规则版”。</span></span>
- XAI_BASE_URL：默认 https://api.xsirouter.com。</span></span>
- MODEL：默认 gpt-5.6-sol。</span></span>
- 调用 {XAI_BASE_URL}/v1/chat/completions，请求头 Authorization: Bearer {XAI_API_KEY}，用 Node.js 自带的 fetch。</span></span>
</span>
生成要求（写在 system 提示词里）：把零散的工作记录整理成中文周报，用 Markdown，包含本周完成、进行中（写明进度）、问题与风险、下周计划四部分；语气客观，不夸大，记录里没有的事情不要编造；缺少日期或负责人时，在末尾列出需要确认的问题。</span></span>
</span>
可靠性：</span></span>
- 请求超时 60 秒。</span></span>
- 接口报错、超时或返回空内容时，退回规则版，并在返回结果里说明原因，例如“AI 暂时不可用（AI 接口返回 HTTP 401），已使用规则版”。</span></span>
- 输入超过 5000 字时返回 413 和中文提示。</span></span>
- 日志里不要打印工作记录的内容和 Key。</span></span>
</span>
页面：在结果上方显示这次是 AI 生成还是规则版，以及上面那句说明。</span></span>
</span>
另外创建 .gitignore，忽略 .env、node_modules 和日志文件。</span></span>
</span>
先告诉我你的计划，等我确认后再改。</span></span></code></pre>
审查计划，确认后让它动手，完成后退出 Codex。</p>
3. 启动并试用</h3>
npm</span> start</span></span></code></pre>
刷新 http://localhost:3000</a>，贴上第 12 课的测试数据，点“生成周报”。</p>
你应该看到</h2>
等几秒到十几秒后，出现一份由 AI 写的周报：语句更完整，可能还会在末尾列出“需要确认的问题”。页面上标明这是 AI 生成的。</p>
照例要验收</strong>：AI 写的周报里，有没有测试数据里没有的内容？如果它编造了事实，在需求里把“不要编造”强调得更明确，让它改提示词。</p>
故意弄坏它</h2>
验证失败处理是否真的有效。先停止服务器，然后新开一个终端</strong>，在里面临时把 Key 设成错的：</p>
cd ~</span>/</span>ai</span>-</span>course</span>/</span>weekly</span>-</span>report</span></span>
$</span>env:</span>XAI_API_KEY</span> =</span> "sk-wrong"</span></span>
npm start</span></span></code></pre>cd</span> ~/ai-course/weekly-report</span></span>
XAI_API_KEY</span>=</span>sk-wrong</span> npm</span> start</span></span></code></pre>
再生成一次。这次应该看到规则版的结果，以及“AI 暂时不可用（……401）”之类的说明。试完停止服务器，关掉这个终端</strong>，错误的 Key 就随它消失了，你永久设置的 Key 不受影响。</p>
确认 Key 没有泄露</h2>
git</span> grep</span> --untracked -l</span> "sk-"</span></span></code></pre>
--untracked</code> 让它连还没存档的新文件一起搜（被 .gitignore</code> 忽略的 .env</code> 不在其中，本来也不会被存档）；-l</code> 只列出文件名，不把内容打在屏幕上。没有输出最好；如果列出了文件，打开看看：只是 sk-你的Key</code> 这类示例文字就没有关系；如果是真正的 Key，说明它被写进了文件，让 AI 改成从环境变量读取，并且去账户后台更换这个 Key</strong>。</p>
确认无误后存档：</p>
git</span> add</span> -A</span></span>
git</span> commit</span> -m</span> "周报助手 AI 版"</span></span></code></pre>花费和隐私</h2>

每点一次“生成周报”就调用一次 API，按 Token 计费。想省钱可以换更便宜的模型：在模型页</a>挑一个，启动前用环境变量 MODEL</code> 指定。</li>
工作记录会发送给 AI 服务商处理。不要贴客户隐私、公司机密等不该外传的内容。</li>
</ul>
常见问题</h2>
一直显示规则版？</strong> 看页面上的说明：如果是“没有设置 XAI_API_KEY”，说明启动服务器的终端里没有这个变量，重开终端再启动；如果是 401，Key 不对；如果是超时，检查网络。</p>
等了很久才出结果？</strong> 大模型写长文本需要时间，十几秒是正常的。超过 60 秒会自动退回规则版。</p>
返回 404？</strong> 检查 XAI_BASE_URL</code> 有没有多写 /v1</code>，正确的值是 https://api.xsirouter.com</code>。</p>
自检</h2>


我能解释为什么 Key 不能写在网页里。</li>

周报助手能用 AI 生成周报。</li>

用错误的 Key 启动时，会自动退回规则版并说明原因。</li>

git grep --untracked -l "sk-"</code> 没有找到含真正 Key 的文件，AI 版已经存档。</li>
</ul>


接入 API 与环境变量
2026-10-06T00:00:00+00:00
本课目标</h2>

注册账号，拿到 API Key。</li>
理解环境变量，会临时设置和永久设置。</li>
写好 Codex 的配置文件，完成第一次对话。</li>
</ul>
第一步：拿到 API Key</h2>

访问 m.xsirouter.com</a> 注册账号，按提示完成邮箱验证。</li>
系统会把你的 API Key</strong> 发到注册邮箱，它是一串以 sk-</code> 开头的长字符。</li>
按账户页面的提示选择套餐或充值。</li>
</ol>
记住第 2 课说的：Key 就是钱包</strong>。先把它存在一个只有你能看到的地方，比如密码管理器。</p>
先懂概念：环境变量</h2>
Codex 需要知道你的 Key。最直接的办法是把 Key 写进配置文件，但这样很危险：配置文件可能被你分享出去，或者被 AI 读到后写进别的地方。</p>
程序员的做法是把 Key 放进环境变量</strong>。环境变量是电脑里贴着的“便利贴”，每张有一个名字和一个值，比如：</p>
名字：XAI_API_KEY</span></span>
值：  sk-xxxxxxxx</span></span></code></pre>
程序启动时会去看这些便利贴。配置文件里只写“去看名叫 XAI_API_KEY</code> 的那张”，Key 本身不写进项目和配置文件。（永久设置时，系统会把它保存在你的用户设置里，下文会提到。）第 4 课的 PATH 其实也是一个环境变量。</p>
环境变量有两种设法：</p>
方式</th> 效果</th> 适合</th></tr></thead>

临时设置</td> 只在当前这个终端窗口有效，关掉就没了</td> 试一试</td></tr>
永久设置</td> 以后打开的每个终端都有效</td> 日常使用</td></tr>
</tbody></table>
第二步：临时设置，试一试</h2>
把下面的 sk-你的Key</code> 换成你自己的 Key。</p>
$</span>env:</span>XAI_API_KEY</span> =</span> "sk-你的Key"</span></span></code></pre>export</span> XAI_API_KEY</span>=</span>"sk-你的Key"</span></span></code></pre>
（第一行是 Windows PowerShell，第二行是 macOS，下同。）</p>
检查有没有设上。下面的命令只显示 Key 的长度</strong>，不会把 Key 本身打在屏幕上，截图或共享屏幕时也安全：</p>
$</span>env:</span>XAI_API_KEY.Length</span></span></code></pre>echo</span> ${</span>#</span>XAI_API_KEY}</span></span></code></pre>
显示一个数字（比如 51）就说明设好了；显示 0 或什么都没有，说明没设上。</p>
第三步：永久设置</h2>
确认临时设置能用以后，再永久保存。</p>
Windows</strong>：</p>
setx XAI_API_KEY </span>"sk-你的Key"</span></span></code></pre>
看到“成功: 指定的值已得到保存”即可。setx</code> 只对之后新开的</strong>终端生效，所以接着关掉终端，重新打开一个。</p>
macOS</strong>（终端默认使用的 Shell 叫 zsh，它每次启动时会读家目录里的 .zshrc</code> 文件）：</p>
echo</span> 'export XAI_API_KEY="sk-你的Key"'</span> >></span> ~/.zshrc</span></span></code></pre>
然后关掉终端，重新打开一个。</p>
用第二步的命令再检查一次长度。</p>

永久设置会把 Key 以明文存在你的电脑上：Windows 存在用户设置里，macOS 存在 ~/.zshrc</code> 里。个人电脑这样做没问题，公用电脑不要这样做。另外，你输入过的命令会留在终端历史里，同样只适合个人电脑。</p>
</blockquote>
第四步：写 Codex 的配置文件</h2>
Codex 的配置文件在家目录下的 .codex/config.toml</code>。名字以点开头的文件夹默认是隐藏的，不用管它，下面一段命令会帮你创建好。</p>
如果你以前用过 Codex 并且有自己的配置，先把原来的 config.toml</code> 复制一份备份，因为下面的命令会覆盖它。</p>
Windows</strong>：把下面整段一次性复制粘贴到 PowerShell，回车。如果弹出“多行粘贴”的提示，选择“仍然粘贴”。</p>
New-Item</span> -</span>ItemType Directory </span>-</span>Force </span>"</span>$HOME</span>\.codex"</span> |</span> Out-Null</span></span>
@'</span></span>
model_provider = "xai"</span></span>
model = "gpt-5.6-sol"</span></span>
approval_policy = "on-request"</span></span>
sandbox_mode = "workspace-write"</span></span>
</span>
[model_providers.xai]</span></span>
name = "xai"</span></span>
base_url = "https://api.xsirouter.com"</span></span>
wire_api = "responses"</span></span>
requires_openai_auth = false</span></span>
env_key = "XAI_API_KEY"</span></span>
supports_websockets = false</span></span>
'@</span> |</span> Set-Content</span> -</span>Encoding ascii </span>"</span>$HOME</span>\.codex\config.toml"</span></span></code></pre>
macOS</strong>：同样整段复制粘贴到终端，回车。</p>
mkdir</span> -p</span> ~/.codex</span></span>
cat</span> ></span> ~/.codex/config.toml</span> <<</span>'EOF'</span></span>
model_provider = "xai"</span></span>
model = "gpt-5.6-sol"</span></span>
approval_policy = "on-request"</span></span>
sandbox_mode = "workspace-write"</span></span>
</span>
[model_providers.xai]</span></span>
name = "xai"</span></span>
base_url = "https://api.xsirouter.com"</span></span>
wire_api = "responses"</span></span>
requires_openai_auth = false</span></span>
env_key = "XAI_API_KEY"</span></span>
supports_websockets = false</span></span>
EOF</span></span></code></pre>
用 cat</code> 看一眼文件内容，确认写进去了：</p>
cat </span>"</span>$HOME</span>\.codex\config.toml"</span></span></code></pre>cat</span> ~/.codex/config.toml</span></span></code></pre>
这份配置里最重要的几行：</p>
配置</th> 意思</th></tr></thead>

base_url</code></td> API 的地址，也就是第 2 课说的“窗口地址”</td></tr>
env_key = "XAI_API_KEY"</code></td> 去名叫 XAI_API_KEY</code> 的环境变量里取 Key</td></tr>
model</code></td> 默认使用的模型</td></tr>
approval_policy = "on-request"</code></td> 需要更大权限时先问你</td></tr>
sandbox_mode = "workspace-write"</code></td> 只能改当前文件夹里的文件</td></tr>
</tbody></table>
最后两行是这门课推荐的安全设置，第 7 课会详细讲。</p>
第五步：第一次对话</h2>
cd</span> ~/ai-course</span></span>
codex</span></span></code></pre>
第一次在某个文件夹里启动时，Codex 会问你是否信任这个文件夹（Trust this folder?）。ai-course</code> 是你自己建的，用方向键选 Trust and continue</strong>，回车。</p>
Windows 上第一次使用时，Codex 还可能请你设置“沙箱”（Set up the Codex agent sandbox）。沙箱是把 AI 的操作圈在一个范围里的保护措施。选 Set up default sandbox</strong>，Windows 会弹窗请求管理员权限，点“是”。如果你的账号没有管理员权限，选 Use non-admin sandbox</strong>。</p>
然后在底部的输入框里输入：</p>
你好，请用一句话介绍你自己。</span></span></code></pre>你应该看到</h2>
几秒钟后，Codex 用中文回复你。输入 /status</code> 回车，可以看到当前使用的模型和配置。</p>
输入 /quit</code> 回车，退出 Codex。</p>
常见问题</h2>
报错提到 XAI_API_KEY</code> 没有设置？</strong> 说明 Codex 启动时没看到这个环境变量。用第二步的命令检查长度。如果是刚用 setx</code> 或改了 .zshrc</code>，记得重开终端。</p>
报 401 或 Unauthorized？</strong> Key 不对：多复制了空格、少复制了字符，或者 Key 已经失效。重新复制一遍，注意引号要成对。</p>
报 429 或余额不足？</strong> 账户额度用完了，或者请求太频繁，回账户页面看一看。</p>
还是让我登录 ChatGPT？</strong> 说明配置文件没有生效，用上面的 cat</code> 命令确认文件内容和位置是否正确。</p>
Key 不小心泄露了，或者要换 Key？</strong> 立刻在账户后台更换 Key，然后把新 Key 设置好：</p>

Windows：重新运行第三步的 setx XAI_API_KEY "sk-新Key"</code>，再重开终端。</li>
macOS：不要再追加一行</strong>，而是用 open -e ~/.zshrc</code> 打开这个文件，找到原来那行 export XAI_API_KEY=...</code>，把 Key 改成新的，保存后重开终端。如果在后面再追加一行，选修课里引用这个变量的设置会继续拿到旧 Key。</li>
</ul>
自检</h2>


我能用自己的话解释环境变量是什么、为什么要用它放 Key。</li>

我会检查 XAI_API_KEY</code> 的长度，而不是把它打印出来。</li>

新开一个终端，XAI_API_KEY</code> 依然存在。</li>

Codex 能回复我的第一句话。</li>
</ul>


买一台云主机
2026-10-06T00:00:00+00:00
本课目标</h2>

知道云主机是什么，为什么学习阶段推荐香港地域。</li>
买好一台 Ubuntu 云主机，配好防火墙。</li>
记下公网 IP、用户名和密码，知道怎么控制费用。</li>
</ul>
先懂概念：租一台远方的电脑</h2>
云主机</strong>就是云服务商机房里的一台电脑（准确说是虚拟出来的一份），你按月付租金。它有几个特点：</p>

24 小时开机，不怕你关电脑；</li>
有一个公网 IP</strong>，全世界都能访问到它；</li>
没有屏幕和鼠标，你通过网络用终端远程操作它（下一课的 SSH）。</li>
</ul>
本课以阿里云、腾讯云的轻量应用服务器</strong>为例：控制台是中文的，能用支付宝付款，配置简单，适合个人。两家的流程大同小异，下文按通用步骤来写，界面上的名称可能略有不同。</p>
为什么选香港地域</h2>
</th> 中国内地地域</th> 中国香港地域</th></tr></thead>

用域名开放网站</td> 必须先做 ICP 备案，通常要几周</td> 不需要备案</td></tr>
下载 Docker 镜像、GitHub 代码</td> 经常很慢或失败</td> 顺畅</td></tr>
国内访问速度</td> 快</td> 稍慢，个人工具够用</td></tr>
</tbody></table>
学习阶段选香港</strong>最省事。将来如果要面向国内大量用户提供服务，再按规定办理备案，迁到内地机房。</p>
跟着做</h2>
1. 注册并实名认证</h3>
在阿里云或腾讯云注册账号，按提示完成个人实名认证。购买云产品前必须实名。</p>
2. 购买轻量应用服务器</h3>
在控制台找到“轻量应用服务器”，点“购买”或“新建”，按下面的建议选择：</p>
选项</th> 建议</th></tr></thead>

地域</td> 中国香港</td></tr>
镜像</td> 选“系统镜像”里的 Ubuntu 24.04 LTS</strong>，不要选预装了各种应用的“应用镜像”</td></tr>
套餐</td> 2 核 CPU、2 GB 内存或以上（构建 Docker 镜像需要一点内存）</td></tr>
时长</td> 先买 1 个月，确认要长期用再续费</td></tr>
登录方式</td> 设置一个足够长的密码，下一课会换成更安全的密钥登录</td></tr>
</tbody></table>
付款后等一两分钟，服务器状态变为“运行中”。</p>
3. 记下登录信息</h3>
在服务器详情页找到并记下：</p>

公网 IP</strong>：一串类似 203.0.113.10</code> 的数字。</li>
用户名</strong>：以控制台显示为准。Ubuntu 镜像在腾讯云上一般是 ubuntu</code>，在阿里云上一般是 root</code>。</li>
密码</strong>：刚才设置的密码。忘了可以在控制台“重置密码”。</li>
</ul>
后面的课程用 ubuntu</code> 和 你的服务器IP</code> 指代它们，遇到时换成你自己的。</p>
4. 配置防火墙</h3>
云服务商在服务器外面还有一道防火墙（轻量应用服务器里叫“防火墙”，其他产品里叫“安全组”），决定哪些端口可以从外网访问。</p>
找到服务器的防火墙设置，确认规则里只保留 TCP 22 端口</strong>（SSH 登录用）。默认模板里如果还开放了 80、443、3389 等其他端口，先删掉，用到时再加。第 24 课会开放 80 和 443。</p>

只开放需要的端口，是服务器安全最基本的一条。互联网上有大量程序不停地扫描所有 IP，寻找开着的端口和弱密码。</p>
</blockquote>
控制费用</h2>

购买时留意续费价格</strong>，有的套餐首月优惠，之后价格不同。</li>
关闭自动续费</strong>，到期前会收到提醒，到时候再决定。</li>
云主机关机不等于停止计费</strong>，按月购买的套餐到期前一直计费。不用了要“释放”或“退还”，第 26 课有完整的收尾清单。</li>
</ul>
你应该看到</h2>
控制台里有一台运行中的 Ubuntu 24.04 服务器，你记下了它的公网 IP、用户名和密码，防火墙只开放了 22 端口。</p>
常见问题</h2>
找不到 Ubuntu 24.04？</strong> 选列表里最新的 Ubuntu LTS 版本即可（LTS 表示长期支持）。</p>
可以选 Windows Server 吗？</strong> 不建议。后面的课程都基于 Linux，绝大多数服务器也都用 Linux。</p>
必须用阿里云或腾讯云吗？</strong> 不是。任何能提供 Ubuntu 云主机和公网 IP 的服务商都可以，步骤大同小异。</p>
自检</h2>


我能解释为什么学习阶段选香港地域。</li>

我有一台运行中的 Ubuntu 云主机。</li>

我记下了公网 IP、用户名和密码，并且没有截图发给别人。</li>

防火墙只开放了 TCP 22。</li>

我关闭了自动续费，知道关机不等于停止计费。</li>
</ul>


Cloudflare Tunnel：不开端口也能上线
2026-10-06T00:00:00+00:00
本课目标</h2>

理解 Cloudflare Tunnel 和第 24 课做法的区别。</li>
创建一条隧道，用 Docker 运行 cloudflared</code>。</li>
把访问切换到隧道，关闭 80/443 端口。</li>
</ul>
先懂概念：从“开门迎客”到“主动打电话”</h2>
</th> 第 24 课：Caddy + 源站证书</th> Cloudflare Tunnel</th></tr></thead>

连接方向</td> Cloudflare 连到你服务器的 443 端口</td> 你的服务器主动连到 Cloudflare</td></tr>
防火墙</td> 要开放 80、443</td> 只开 22，甚至可以都不开</td></tr>
证书</td> 自己申请、放到服务器上</td> 不需要</td></tr>
依赖</td> 只依赖标准的 HTTPS</td> 依赖 Cloudflare 的隧道服务</td></tr>
</tbody></table>
隧道就像服务器主动给 Cloudflare 打了一个电话并一直不挂：访问者的请求通过这通电话送到服务器，而服务器本身不接任何来电。</p>
跟着做</h2>
1. 创建隧道</h3>

登录 Cloudflare，进入 Zero Trust</strong> 控制台（第一次进入需要选择免费套餐，可能要求绑定付款方式但不会扣费）。</li>
打开 Networks</strong> → Tunnels</strong>，点 Create a tunnel</strong>，类型选 Cloudflared</strong>，名字填 ai-server</code>。</li>
安装方式选 Docker</strong>。页面会给出一条 docker run ... --token eyJ...</code> 命令，只复制 --token</code> 后面那一长串令牌</strong>。</li>
</ol>
Cloudflare 的界面会调整，菜单名称可能略有不同。</p>
2. 配置公开地址</h3>
在隧道的 Public Hostname</strong>（公开主机名）里添加一条：</p>
字段</th> 填写</th></tr></thead>

Subdomain</td> report</code></td></tr>
Domain</td> example.com</code></td></tr>
Service Type</td> HTTP</code></td></tr>
URL</td> app:3000</code></td></tr>
</tbody></table>
如果提示 report</code> 已经有一条 DNS 记录，先到 DNS 页面删除第 23 课添加的那条 A 记录，再回来保存。隧道会自动创建新的记录。</p>
3. 在服务器上运行 cloudflared</h3>
令牌和 Key 一样敏感，单独放在一个文件里：</p>
cd</span> ~/apps/weekly-report</span></span>
vim</span> tunnel.env</span></span></code></pre>
写入一行（换成你的令牌），保存：</p>
TUNNEL_TOKEN=eyJ你的令牌</span></span></code></pre>chmod</span> 600</span> tunnel.env</span></span></code></pre>
用下面的内容替换 compose.yaml</code>（版本号和你当前用的保持一致）：</p>
cat</span> ></span> compose.yaml</span> <<</span>'EOF'</span></span>
services:</span></span>
  app:</span></span>
    image: 你的用户名/weekly-report:v4</span></span>
    env_file: .env</span></span>
    restart: unless-stopped</span></span>
    ports:</span></span>
      - "127.0.0.1:3000:3000"</span></span>
</span>
  tunnel:</span></span>
    image: cloudflare/cloudflared:latest</span></span>
    command: tunnel --no-autoupdate run</span></span>
    env_file: tunnel.env</span></span>
    restart: unless-stopped</span></span>
EOF</span></span>
docker</span> compose up</span> -d --remove-orphans</span></span>
docker</span> compose ps</span></span>
docker</span> compose logs tunnel</span></span></code></pre>
--remove-orphans</code> 会停掉不再写在配置里的 Caddy。日志里出现 Registered tunnel connection</code> 就说明隧道连上了，Cloudflare 控制台里隧道的状态也会变成 Healthy</strong>。</p>
4. 关闭 80/443</h3>
访问 https://report.example.com</code>，确认能正常打开并要求登录。然后到云服务商的防火墙里删除 TCP 80 和 443 的规则</strong>，只保留 22。</p>
再访问一次，依然正常，因为流量走的是隧道。</p>
你应该看到</h2>

网站照常可用，有锁形图标，需要登录。</li>
防火墙只开放 22 端口。</li>
sudo ss -tlnp</code> 里没有程序在监听 80、443。</li>
</ul>
常见问题</h2>
访问显示 502 Bad Gateway？</strong> 隧道连上了，但找不到周报助手。检查 Public Hostname 的 URL 是否为 app:3000</code>，app</code> 服务是否在运行。</p>
隧道状态是 Down？</strong> 看 docker compose logs tunnel</code>，多半是令牌复制不完整，或者 tunnel.env</code> 里等号两边多了空格。</p>
想换回 Caddy 的方式？</strong> 按这个顺序：</p>

按第 24 课的内容重写 compose.yaml</code>，app</code> 的镜像版本保持你现在用的版本，不要退回 v2。</li>
运行 docker compose up -d --remove-orphans</code>，停掉 tunnel</code>、启动 caddy</code>，用 docker compose ps</code> 确认。</li>
在防火墙里重新开放 TCP 80 和 443。</li>
在 Cloudflare 里删除隧道的 Public Hostname 和它创建的 DNS 记录，再按第 23 课添加 A 记录（橙色云朵）。</li>
访问网站确认正常。</li>
</ol>
自检</h2>


我能说出隧道和开放端口两种方式的区别。</li>

隧道状态是 Healthy，网站通过隧道访问。</li>

防火墙已经关闭 80 和 443。</li>
</ul>


容器化：把周报助手装进镜像
2026-10-06T00:00:00+00:00
本课目标</h2>

让 AI 写 Dockerfile 和 .dockerignore，并看懂它们。</li>
用 scp</code> 把项目传到服务器。</li>
在服务器上构建镜像、运行容器。</li>
用 SSH 隧道在自己电脑上访问服务器里的服务。</li>
</ul>
第一步：写 Dockerfile（在自己电脑上）</h2>
cd</span> ~/ai-course/weekly-report</span></span>
codex</span></span></code></pre>请为这个项目写 Dockerfile 和 .dockerignore，要求：</span></span>
- 基础镜像用 node:24-alpine。</span></span>
- 只复制运行需要的文件：package.json、server.js、public 文件夹。项目没有第三方依赖，不需要 npm install。</span></span>
- 设置 NODE_ENV=production、HOST=0.0.0.0 和 PORT=3000，声明 3000 端口。容器里必须监听所有网卡，端口映射才能把请求送进来。</span></span>
- 用镜像自带的普通用户 node 运行，不要用 root。</span></span>
- 启动命令为 node server.js。</span></span>
- .dockerignore 排除 .git、.env、node_modules 和日志文件，确保 Key 不会被打包进镜像。</span></span>
- 每一段加一行中文注释说明作用。</span></span>
另外检查一下 server.js：收到 SIGTERM 信号时要能正常退出，这样 docker stop 时不用等待 10 秒。</span></span>
先说计划，确认后再写。</span></span></code></pre>
写好的 Dockerfile 大致是这样（逐行说明见注释）：</p>
# 基础镜像：官方 Node.js 24，alpine 版体积小。</span></span>
FROM</span> node:24-alpine</span></span>
WORKDIR</span> /app</span></span>
# 只复制运行需要的文件；密钥通过环境变量传入，不进镜像。</span></span>
COPY</span> package.json server.js ./</span></span>
COPY</span> public ./public</span></span>
# 容器里要监听所有网卡，端口映射才能把请求送进来。</span></span>
ENV</span> NODE_ENV=production HOST=0.0.0.0 PORT=3000</span></span>
EXPOSE</span> 3000</span></span>
# 用普通用户运行，不用 root。</span></span>
USER</span> node</span></span>
CMD</span> [</span>"node"</span>, </span>"server.js"</span>]</span></span></code></pre>指令</th> 意思</th></tr></thead>

FROM</code></td> 从哪个基础镜像开始，这里是装好了 Node.js 24 的精简 Linux</td></tr>
WORKDIR</code></td> 镜像里的工作目录</td></tr>
COPY</code></td> 把文件复制进镜像</td></tr>
ENV</code></td> 设置环境变量的默认值；HOST=0.0.0.0</code> 让程序在容器里监听所有网卡</td></tr>
EXPOSE</code></td> 说明程序使用的端口</td></tr>
USER</code></td> 以哪个用户运行</td></tr>
CMD</code></td> 容器启动时执行的命令</td></tr>
</tbody></table>
确认没问题后存档：</p>
git</span> add</span> -A</span></span>
git</span> commit</span> -m</span> "添加 Dockerfile"</span></span></code></pre>第二步：把项目传到服务器</h2>
scp</code> 是基于 SSH 的复制命令，用法和 cp</code> 类似，只是可以跨机器。在自己电脑</strong>上运行：</p>
scp </span>-</span>r </span>"</span>$HOME</span>\ai-course\weekly-report"</span> ai</span>-</span>server:</span></span></code></pre>scp</span> -r</span> ~/ai-course/weekly-report ai-server:</span></span></code></pre>
ai-server:</code> 后面什么都不写，表示复制到服务器的家目录。完成后，服务器上会有 ~/weekly-report</code> 文件夹。</p>

服务器上有两个文件夹，别搞混：~/weekly-report</code> 放源代码，用来构建镜像；~/apps/weekly-report</code> 放部署配置（.env</code> 等），用来运行。</p>
</blockquote>
第三步：在服务器上构建镜像</h2>
ssh</span> ai-server</span></span></code></pre>
看到服务器的提示符后，再运行：</p>
cd</span> ~/weekly-report</span></span>
docker</span> build</span> -t</span> weekly-report:v1 .</span></span></code></pre>

-t weekly-report:v1</code>：给镜像起名叫 weekly-report</code>，版本标签是 v1</code>。</li>
最后的 .</code> 表示用当前文件夹里的 Dockerfile 和文件。</li>
</ul>
第一次构建要下载 Node.js 基础镜像，稍等片刻。完成后查看：</p>
docker</span> images</span></span></code></pre>
列表里有 weekly-report</code>，标签 v1</code>。</p>
第四步：运行容器</h2>
docker</span> run</span> --rm --name</span> weekly-report-test</span> --env-file</span> ~/apps/weekly-report/.env</span> -p</span> 127.0.0.1:3000:3000 weekly-report:v1</span></span></code></pre>参数</th> 意思</th></tr></thead>

--rm</code></td> 停止后自动删除容器</td></tr>
--name</code></td> 给容器起个名字</td></tr>
--env-file</code></td> 从第 17 课写好的 .env</code> 读取环境变量，Key 就是这样传进去的</td></tr>
-p 127.0.0.1:3000:3000</code></td> 把容器的 3000 端口映射到服务器的 3000 端口，并且只允许服务器自己访问</td></tr>
</tbody></table>
看到“周报助手已启动”之类的输出就成功了。这个终端会被占用，先别关。</p>
第五步：通过 SSH 隧道访问</h2>
服务器的 3000 端口只对服务器自己开放，外网访问不了，这正是我们想要的。那怎么在自己电脑上打开它？用 SSH 隧道</strong>：把自己电脑的 3000 端口，经过加密的 SSH 连接，接到服务器的 3000 端口。</p>
在自己电脑上新开一个终端</strong>：</p>
ssh</span> -L</span> 3000:127.0.0.1:3000 ai-server</span></span></code></pre>
它会像平常一样登录服务器，同时打通隧道。保持这个窗口开着，在浏览器访问 http://localhost:3000</a>，看到的就是服务器上运行的周报助手。贴上测试数据，生成一份周报试试。</p>
你应该看到</h2>
浏览器里的周报助手和本地运行时一样，能用 AI 生成周报。</p>
试完后：</p>

在运行容器的终端按 Ctrl + C</code>，容器停止并被自动删除；</li>
在隧道终端输入 exit</code> 关闭隧道。</li>
</ol>
确认 Key 不在镜像里</h2>
镜像里的 Key 可能藏在三个地方：构建时执行过的指令、预设的环境变量、复制进去的文件。逐一检查：</p>
docker</span> history</span> --no-trunc</span> weekly-report:v1</span> ></span> history-check.txt</span> &&</span> grep</span> -c</span> "sk-" history-check.txt</span>;</span> rm</span> -f</span> history-check.txt</span></span></code></pre>
docker history</code> 列出构建这个镜像时执行过的每一条指令（包括 ENV</code> 写进去的值），这里只数有几行带 sk-</code>。应该输出 0</code>；如果没有输出数字而是报错，这次检查不算数。</p>
docker</span> run</span> --rm</span> weekly-report:v1 sh</span> -c</span> 'env; grep -r "" /app'</span> ></span> image-check.txt</span> &&</span> grep</span> -c</span> "sk-" image-check.txt</span>;</span> rm</span> -f</span> image-check.txt</span></span></code></pre>
这条命令在临时容器里列出全部环境变量和 /app</code> 下所有文件的内容，存进一个临时文件，只数带 sk-</code> 的行数，最后删掉临时文件。应该输出 0</code>；如果没有输出数字而是报错，说明容器没跑起来，这次检查不算数，先解决报错。</p>
两项都是 0</code>，再加上 Dockerfile 里没有写 Key、只复制了三样文件，也没有“先放进文件再删掉”的步骤，.dockerignore</code> 又把 .env</code> 排除在构建之外，就可以确认 Key 没有被打包进镜像。它只在运行时从 .env</code> 传入。以后如果 Dockerfile 变复杂了，这两条检查就不一定够，要让 AI 帮你重新评估。</p>
常见问题</h2>
本地访问 localhost:3000 看到的是旧的本地版本？</strong> 你电脑上的 npm start</code> 还开着，占用了 3000 端口。先停掉它，再建立隧道。</p>
AI 一直退回规则版，提示 401？</strong> 检查 .env</code>：等号两边有没有空格，Key 有没有加引号。</p>
docker build</code> 报 COPY failed</code>？</strong> 文件名和 Dockerfile 里写的不一致，或者在错误的文件夹里运行了 docker build</code>。确认当前在 ~/weekly-report</code>。</p>
bind: address already in use</code>？</strong> 服务器上的 3000 端口已经被占用，可能是之前的容器还在运行，用 docker ps</code> 查看并 docker stop</code> 它。</p>
自检</h2>


我能说出 Dockerfile 里每条指令的作用。</li>

我用 scp</code> 把项目传到了服务器。</li>

docker images</code> 里有 weekly-report:v1</code>。</li>

我通过 SSH 隧道在浏览器里用上了服务器上的周报助手。</li>

镜像里没有 Key。</li>
</ul>


正式部署：让它一直运行
2026-10-06T00:00:00+00:00
本课目标</h2>

理解 Docker Compose 的作用，写好 compose.yaml</code>。</li>
用 Compose 在后台运行周报助手，学会查看状态和日志。</li>
验证服务器重启后服务会自动恢复。</li>
</ul>
先懂概念：把命令写成配置</h2>
第 19 课的 docker run</code> 命令又长又容易打错，而且每次都要重新输入。Docker Compose</strong> 把这些参数写进一个 compose.yaml</code> 文件，以后只需要：</p>
docker</span> compose up</span> -d</span></span></code></pre>
文件就是部署的“说明书”：用哪个镜像、读哪个 .env</code>、映射哪个端口、挂了要不要自动重启，一目了然。以后再加 HTTPS 等服务，也只是在这个文件里多写一段。</p>
YAML 格式靠缩进</strong>表示层级，必须用空格，不能用 Tab 键，同一层级的缩进要对齐。</p>
跟着做</h2>
以下命令都在服务器上运行。</p>
1. 写 compose.yaml</h3>
cd</span> ~/apps/weekly-report</span></span>
cat</span> ></span> compose.yaml</span> <<</span>'EOF'</span></span>
services:</span></span>
  app:</span></span>
    image: 你的用户名/weekly-report:v1</span></span>
    env_file: .env</span></span>
    restart: unless-stopped</span></span>
    ports:</span></span>
      - "127.0.0.1:3000:3000"</span></span>
EOF</span></span></code></pre>
粘贴前把 你的用户名</code> 改成你的 Docker Hub 用户名。也可以用 vim compose.yaml</code> 手动输入，正好练习上一单元的 Vim。</p>
配置</th> 意思</th></tr></thead>

services</code></td> 要运行的服务清单，这里只有一个叫 app</code> 的服务</td></tr>
image</code></td> 用仓库里的哪个镜像、哪个版本</td></tr>
env_file</code></td> 从同一文件夹的 .env</code> 读取环境变量</td></tr>
restart: unless-stopped</code></td> 程序崩溃或服务器重启后自动拉起来，除非你手动停止</td></tr>
ports</code></td> 只在服务器本机开放 3000 端口，外网访问不到</td></tr>
</tbody></table>
检查配置有没有写错：</p>
docker</span> compose config</span> --quiet</span> &&</span> echo</span> 配置正确</span></span></code></pre>2. 启动</h3>
docker</span> compose up</span> -d</span></span></code></pre>
-d</code> 表示在后台运行，命令执行完终端就还给你了。</p>
3. 查看状态和日志</h3>
docker</span> compose ps</span></span></code></pre>
STATUS</code> 一列显示 Up</code> 表示正在运行。</p>
docker</span> compose logs</span> -f</span> app</span></span></code></pre>
实时查看日志，按 Ctrl + C</code> 停止查看。这只是停止查看，服务本身仍在运行。</strong></p>
4. 访问</h3>
和第 19 课一样，在自己电脑上建立隧道：</p>
ssh</span> -L</span> 3000:127.0.0.1:3000 ai-server</span></span></code></pre>
浏览器打开 http://localhost:3000</a>。这次即使你退出 SSH，周报助手也在服务器上照常运行。</p>
5. 重启服务器试试</h3>
sudo</span> reboot</span></span></code></pre>
SSH 连接会断开。等一分钟后重新登录：</p>
ssh</span> ai-server</span></span></code></pre>
看到服务器的提示符后，再运行：</p>
cd</span> ~/apps/weekly-report</span></span>
docker</span> compose ps</span></span></code></pre>
周报助手已经自动恢复运行了。</p>
常用命令</h2>
都要在 compose.yaml</code> 所在的文件夹里运行：</p>
命令</th> 作用</th></tr></thead>

docker compose up -d</code></td> 按配置启动；配置改了再运行一次就会按新配置重建</td></tr>
docker compose ps</code></td> 查看状态</td></tr>
docker compose logs -f app</code></td> 实时日志</td></tr>
docker compose restart app</code></td> 重启服务</td></tr>
docker compose down</code></td> 停止并删除容器（镜像和 .env</code> 都还在）</td></tr>
docker compose pull</code></td> 从仓库拉取配置里写的镜像</td></tr>
</tbody></table>
你应该看到</h2>

docker compose ps</code> 显示 app</code> 服务 Up</code>。</li>
通过隧道能正常使用周报助手。</li>
重启服务器后，服务自动恢复。</li>
</ul>
常见问题</h2>
yaml: line X: ...</code> 之类的报错？</strong> 缩进有问题。检查有没有用 Tab、同一层级是否对齐、冒号后面有没有空格。</p>
pull access denied</code>？</strong> image</code> 里的镜像名写错了，或者仓库是私有的但没有登录。和 Docker Hub 网页上的名字对照一下。</p>
docker compose ps</code> 显示 Restarting</code>，一直在重启？</strong> 程序启动就出错了，用 docker compose logs app</code> 看报错。</p>
提示 3000 端口已被占用？</strong> 第 19 课的测试容器可能还在运行，docker ps</code> 找到它并 docker stop</code>。</p>
自检</h2>


我能说出 compose.yaml</code> 里每一项的作用。</li>

周报助手在后台运行，docker compose ps</code> 显示 Up</code>。</li>

我知道 logs -f</code> 按 Ctrl + C</code> 只是停止查看。</li>

重启服务器后服务自动恢复。</li>
</ul>


Docker 是什么
2026-10-06T00:00:00+00:00
本课目标</h2>

理解镜像、容器、仓库、Dockerfile 四个概念。</li>
在云主机上安装 Docker。</li>
运行第一个容器，学会几个常用命令。</li>
</ul>
先懂概念：集装箱</h2>
以前海运货物，大小形状五花八门，装卸很麻烦。后来有了标准集装箱：不管里面装的是什么，码头、轮船、卡车都用同一套方式搬运。</p>
Docker 就是软件的集装箱：</p>
概念</th> 类比</th> 说明</th></tr></thead>

Dockerfile</td> 装箱清单</td> 一个文本文件，写明从什么基础开始、放进哪些文件、怎么启动</td></tr>
镜像（image）</td> 封好的集装箱</td> 按清单打包出来的成品，包含程序和它需要的运行环境，只读</td></tr>
容器（container）</td> 打开并正在使用的集装箱</td> 镜像运行起来的样子，可以启动、停止、删除</td></tr>
仓库（registry）</td> 集装箱码头</td> 存放和分发镜像的地方，比如 Docker Hub</td></tr>
</tbody></table>
好处是：</p>

环境一致</strong>：镜像里自带 Node.js，服务器上不用另外安装；</li>
易迁移</strong>：换一台服务器，拉取同一个镜像就能运行；</li>
易回滚</strong>：每个版本是一个镜像，新版本有问题就换回旧镜像。</li>
</ul>
我们直接在云主机上安装和使用 Docker</strong>，不在自己电脑上装。这样能避开 Windows 上的虚拟化设置、公司电脑的安装限制，以及 Mac 和服务器芯片架构不同带来的问题。</p>
跟着做</h2>
以下命令都在服务器上运行：ssh ai-server</code>。</p>
1. 安装 Docker</h3>
Docker 官方提供了一个安装脚本。先下载下来，而不是直接运行，这是对待安装脚本的好习惯：</p>
curl</span> -fsSL</span> https://get.docker.com</span> -o</span> get-docker.sh</span></span>
less</span> get-docker.sh</span></span></code></pre>
用 less</code> 粗略看一眼（按 q</code> 退出），确认是 Docker 官方的脚本。然后运行：</p>
sudo</span> sh get-docker.sh</span></span></code></pre>
等一两分钟。完成后检查：</p>
sudo</span> docker version</span></span></code></pre>
能看到 Client 和 Server 两部分的版本信息，就装好了。</p>
2. 不用每次都输入 sudo</h3>
把自己加入 docker</code> 用户组：</p>
sudo</span> usermod</span> -aG</span> docker</span> $USER</span></span>
exit</span></span></code></pre>
必须退出再重新登录</strong>才会生效：</p>
ssh</span> ai-server</span></span></code></pre>
看到服务器的提示符后，再运行：</p>
docker</span> version</span></span></code></pre>
这次不加 sudo</code> 也能运行了。</p>

docker</code> 组的成员实际上拥有和管理员差不多的权限。只把你自己加进去，不要随便加别人。</p>
</blockquote>
3. 运行第一个容器</h3>
docker</span> run</span> --rm</span> hello-world</span></span></code></pre>
Docker 会从 Docker Hub 下载 hello-world</code> 镜像，运行它，打印一段欢迎信息后退出。--rm</code> 表示容器退出后自动删除，不留垃圾。</p>
你应该看到</h2>
Hello from Docker!</span></span>
This message shows that your installation appears to be working correctly.</span></span></code></pre>常用命令</h2>
命令</th> 作用</th></tr></thead>

docker images</code></td> 列出本机的镜像</td></tr>
docker ps</code></td> 列出正在运行的容器；加 -a</code> 包括已停止的</td></tr>
docker run 镜像名</code></td> 用镜像启动一个容器</td></tr>
docker logs 容器名</code></td> 看容器的输出日志</td></tr>
docker stop 容器名</code></td> 停止容器</td></tr>
docker rm 容器名</code></td> 删除已停止的容器</td></tr>
docker image prune</code></td> 清理没有标签、也没有被容器使用的“悬空”镜像，释放磁盘</td></tr>
</tbody></table>
现在运行 docker images</code>，能看到刚下载的 hello-world</code>。</p>
常见问题</h2>
permission denied while trying to connect to the Docker daemon</code>？</strong> 还没有加入 docker</code> 组，或者加入后没有重新登录。</p>
下载很慢或失败？</strong> 确认服务器是香港地域。内地地域的服务器访问 Docker Hub 经常失败，需要使用云服务商提供的镜像加速，本课程不展开。</p>
Cannot connect to the Docker daemon</code>？</strong> Docker 服务没有运行，执行 sudo systemctl start docker</code>。</p>
自检</h2>


我能用集装箱的类比解释镜像、容器、仓库、Dockerfile。</li>

docker version</code> 不加 sudo</code> 也能运行。</li>

docker run --rm hello-world</code> 显示了 Hello from Docker!</code>。</li>
</ul>


域名与 Cloudflare
2026-10-06T00:00:00+00:00
本课目标</h2>

理解域名、注册商、DNS 服务器（NS）和解析记录。</li>
买一个域名，完成实名认证。</li>
把域名的 DNS 交给 Cloudflare，添加 A 记录。</li>
</ul>
先懂概念：谁负责什么</h2>
角色</th> 做什么</th> 本课用的</th></tr></thead>

注册商</td> 卖域名给你，记录这个域名归谁</td> 阿里云或腾讯云</td></tr>
DNS 服务器（NS）</td> 回答“这个域名对应哪个 IP”</td> Cloudflare</td></tr>
解析记录</td> DNS 服务器上的一条条记录</td> report</code> → 你的服务器 IP</td></tr>
</tbody></table>
域名买在注册商那里，但可以指定由别家的 DNS 服务器来回答查询，这一步叫修改 NS</strong>。我们把 DNS 交给 Cloudflare，因为它还能免费提供 HTTPS 证书、隐藏服务器真实 IP、挡掉一部分恶意访问。</p>
常见的解析记录类型：</p>
类型</th> 作用</th></tr></thead>

A</td> 域名指向一个 IPv4 地址，我们用这个</td></tr>
CNAME</td> 域名指向另一个域名</td></tr>
TXT</td> 存放一段文字，常用于验证域名所有权</td></tr>
</tbody></table>
跟着做</h2>
1. 买域名</h3>
在阿里云或腾讯云的“域名注册”页面搜索你想要的名字。几点建议：</p>

后缀选 .com</code> 最稳妥；.cn</code> 等国内后缀的实名要求更严格。</li>
注意续费价格</strong>。很多域名首年很便宜，第二年起恢复原价。</li>
购买时需要创建“域名信息模板”并完成实名认证</strong>，上传身份证件，审核通常需要几个小时到几天。审核通过前，域名可能无法正常解析。</li>
</ul>
后文用 example.com</code> 指代你买的域名，遇到时换成你自己的。</p>
2. 把域名添加到 Cloudflare</h3>

打开 cloudflare.com</a> 注册账号（免费）。</li>
在控制台点 Add a domain</strong>（添加域），输入 example.com</code>。</li>
套餐选择 Free</strong>。</li>
Cloudflare 会扫描域名已有的解析记录，确认后继续。</li>
Cloudflare 给出两个 NS 地址，类似 xxx.ns.cloudflare.com</code> 和 yyy.ns.cloudflare.com</code>，先复制下来。</li>
</ol>
3. 到注册商那里修改 NS</h3>
回到阿里云或腾讯云的域名控制台，找到这个域名的“修改 DNS 服务器”（具体名称可能略有不同），把原来的 DNS 服务器替换成 Cloudflare 给的两个地址，保存。</p>
修改后需要等待全球生效，通常几分钟到几小时，最长可能 48 小时。生效后 Cloudflare 会发邮件通知，控制台里域名的状态会变成 Active</strong>。</p>
4. 添加 A 记录</h3>
在 Cloudflare 里进入这个域名，打开 DNS</strong> → Records</strong>，点 Add record</strong>：</p>
字段</th> 填写</th></tr></thead>

Type</td> A</code></td></tr>
Name</td> report</code></td></tr>
IPv4 address</td> 你的服务器 IP</td></tr>
Proxy status</td> 开启（橙色云朵，Proxied）</td></tr>
TTL</td> Auto</td></tr>
</tbody></table>
保存后，report.example.com</code> 就指向你的服务器了。</p>
橙色云朵</strong>表示访问者先连到 Cloudflare，再由 Cloudflare 转发到你的服务器。好处是访问者看不到你服务器的真实 IP，HTTPS 证书也由 Cloudflare 自动提供。</p>
5. 检查解析</h3>
在自己电脑上运行：</p>
nslookup</span> report.example.com</span></span></code></pre>你应该看到</h2>
nslookup</code> 返回了 IP 地址，但不是你服务器的 IP</strong>，而是 Cloudflare 的 IP。这正说明橙色云朵在起作用。</p>
现在用浏览器访问 http://report.example.com</code>，会看到 Cloudflare 的错误页，比如 521 Web server is down</strong> 或 522 Connection timed out</strong>。这是正常的：服务器的防火墙还没开放 80/443 端口，上面也还没有接收网页请求的程序。下一课解决。</p>
关于备案和访问速度</h2>

服务器在中国香港</strong>，所以不需要 ICP 备案。如果将来把网站放到中国内地的服务器上，必须先完成备案。</li>
Cloudflare 的免费套餐在中国内地没有节点，国内访问会绕到境外节点，速度一般，个人工具够用。</li>
</ul>
常见问题</h2>
Cloudflare 一直显示 Pending，没有变成 Active？</strong> NS 还没生效。确认注册商那里填的是 Cloudflare 给的两个地址、没有拼错，然后耐心等待。域名实名审核没通过时，修改也可能不生效。</p>
nslookup</code> 返回的是服务器真实 IP？</strong> 说明那条记录没开代理，把 Proxy status 改成橙色云朵。</p>
nslookup</code> 提示找不到域名？</strong> 解析还没生效，或者 Name 写错了，检查 Cloudflare 里的记录。</p>
自检</h2>


我能说出注册商、NS、A 记录分别是什么。</li>

域名已经实名认证，在 Cloudflare 里显示 Active。</li>

report</code> 的 A 记录指向服务器 IP，并且是橙色云朵。</li>

nslookup</code> 返回的是 Cloudflare 的 IP。</li>
</ul>
第一次使用

退出</h2>
输入 `/exit</code>，或者连按两次 Ctrl + D</code>。下次在同一个文件夹里运行 claude -c</code>，可以接着上次的对话继续。</p>`

进阶：Hooks、MCP 与插件

下载与安装

权限与安全

排错与更新

Claude Code 是什么

日常工作流

凭证与接入 XSI Router

获取 Key</h2>
在 m.xsirouter.com</a> 注册账号，系统会把 API Key 发到注册邮箱。Key 等同于你的钱包，不要截图、外发或提交到代码仓库。</p>

让 AI 动手改文件

你应该看到</h2>

让 AI 帮你运维服务器

自检</h2>

`AGENTS.md</code> 里写清了服务器信息和规矩。</li>`
`Codex 通过 SSH 完成了一次体检，每条命令都经过我批准。</li>`
`我知道为什么不能对 ssh ai-server</code> 选“不再询问”。</li> </ul>`

周报助手·AI 版

跟着做</h2>

`自检</h2> 我能解释为什么 Key 不能写在网页里。</li> 周报助手能用 AI 生成周报。</li> 用错误的 Key 启动时，会自动退回规则版并说明原因。</li> git grep --untracked -l "sk-"</code> 没有找到含真正 Key 的文件，AI 版已经存档。</li> </ul>`

接入 API 与环境变量

你应该看到</h2>
几秒钟后，Codex 用中文回复你。输入 `/status</code> 回车，可以看到当前使用的模型和配置。</p>`
`输入 /quit</code> 回车，退出 Codex。</p>`

买一台云主机

1. 注册并实名认证</h3>
在阿里云或腾讯云注册账号，按提示完成个人实名认证。购买云产品前必须实名。</p>

你应该看到</h2>
控制台里有一台运行中的 Ubuntu 24.04 服务器，你记下了它的公网 IP、用户名和密码，防火墙只开放了 22 端口。</p>

Cloudflare Tunnel：不开端口也能上线

跟着做</h2>

容器化：把周报助手装进镜像

正式部署：让它一直运行

Docker 是什么

域名与 Cloudflare

跟着做</h2>

`自检</h2> 我能说出注册商、NS、A 记录分别是什么。</li> 域名已经实名认证，在 Cloudflare 里显示 Active。</li> report</code> 的 A 记录指向服务器 IP，并且是橙色云朵。</li> nslookup</code> 返回的是 Cloudflare 的 IP。</li> </ul>`

𝐗𝐒𝐈

进阶：子代理与技能

配置与自检

𝐗𝐒𝐈

进阶：子代理与技能

配置与自检

第一次使用

退出</h2> 输入 /exit</code>，或者连按两次 Ctrl + D</code>。下次在同一个文件夹里运行 claude -c</code>，可以接着上次的对话继续。</p>

进阶：Hooks、MCP 与插件

下载与安装

系统要求</h2> macOS 13 或更高版本；Windows 10（1809）或更高版本；Ubuntu 20.04+、Debian 10+ 等主流 Linux。</li> 4 GB 以上内存，x64 或 ARM64 处理器。</li>

Windows</h2> 在 PowerShell</strong> 中运行：</p>

权限与安全

排错与更新

Claude Code 是什么

日常工作流

凭证与接入 XSI Router

获取 Key</h2> 在 m.xsirouter.com</a> 注册账号，系统会把 API Key 发到注册邮箱。Key 等同于你的钱包，不要截图、外发或提交到代码仓库。</p>

让 AI 动手改文件

你应该看到</h2>

让 AI 帮你运维服务器

自检</h2> AGENTS.md</code> 里写清了服务器信息和规矩。</li> Codex 通过 SSH 完成了一次体检，每条命令都经过我批准。</li> 我知道为什么不能对 ssh ai-server</code> 选“不再询问”。</li> </ul>

周报助手·AI 版

跟着做</h2>

自检</h2> 我能解释为什么 Key 不能写在网页里。</li> 周报助手能用 AI 生成周报。</li> 用错误的 Key 启动时，会自动退回规则版并说明原因。</li> git grep --untracked -l "sk-"</code> 没有找到含真正 Key 的文件，AI 版已经存档。</li> </ul>

接入 API 与环境变量

你应该看到</h2> 几秒钟后，Codex 用中文回复你。输入 /status</code> 回车，可以看到当前使用的模型和配置。</p> 输入 /quit</code> 回车，退出 Codex。</p>

买一台云主机

1. 注册并实名认证</h3> 在阿里云或腾讯云注册账号，按提示完成个人实名认证。购买云产品前必须实名。</p>

你应该看到</h2> 控制台里有一台运行中的 Ubuntu 24.04 服务器，你记下了它的公网 IP、用户名和密码，防火墙只开放了 22 端口。</p>

Cloudflare Tunnel：不开端口也能上线

跟着做</h2>

容器化：把周报助手装进镜像

退出</h2>
输入 `/exit</code>，或者连按两次 Ctrl + D</code>。下次在同一个文件夹里运行 claude -c</code>，可以接着上次的对话继续。</p>`

获取 Key</h2>
在 m.xsirouter.com</a> 注册账号，系统会把 API Key 发到注册邮箱。Key 等同于你的钱包，不要截图、外发或提交到代码仓库。</p>

自检</h2>

`AGENTS.md</code> 里写清了服务器信息和规矩。</li>`
`Codex 通过 SSH 完成了一次体检，每条命令都经过我批准。</li>`
`我知道为什么不能对 ssh ai-server</code> 选“不再询问”。</li> </ul>`

`自检</h2> 我能解释为什么 Key 不能写在网页里。</li> 周报助手能用 AI 生成周报。</li> 用错误的 Key 启动时，会自动退回规则版并说明原因。</li> git grep --untracked -l "sk-"</code> 没有找到含真正 Key 的文件，AI 版已经存档。</li> </ul>`

你应该看到</h2>
几秒钟后，Codex 用中文回复你。输入 `/status</code> 回车，可以看到当前使用的模型和配置。</p>`
`输入 /quit</code> 回车，退出 Codex。</p>`

1. 注册并实名认证</h3>
在阿里云或腾讯云注册账号，按提示完成个人实名认证。购买云产品前必须实名。</p>

你应该看到</h2>
控制台里有一台运行中的 Ubuntu 24.04 服务器，你记下了它的公网 IP、用户名和密码，防火墙只开放了 22 端口。</p>
