工具大全
AI 教程作者:Coocon2026年3月29日195 次阅读约 3 分钟阅读

Claude Code 快速上手指南:你的第一次实战会话

Claude Code 是 Anthropic 推出的终端式编程助手。想快速看到效果,不需要先把所有命令背下来。更有效的方式是先完成一次干净的首次会话,让 Claude 先读懂代码库,再去执行一个明确的改动任务。

Anthropic 的快速上手与概览文档给出的路径很直接:安装 CLI、使用 Claude.ai 或 Anthropic Console 账号登录、进入项目目录,然后运行 claude 开始会话。之后,Claude 可以帮助你理解代码库、提出修改方案、运行测试,并在同一个对话里继续推进。

开始前准备什么

在打开 Claude Code 之前,先准备好下面几项:

  1. 一个可用的终端窗口
  2. 一个真实的项目仓库
  3. Claude.ai 或 Anthropic Console 账号
  4. 如果打算用 npm 安装,需要 Node.js 18 或更高版本

这些就够了。第一次体验不需要复杂的配置流程,也不需要先准备额外的项目模板。

安装并启动 Claude Code

Anthropic 文档提供了两种安装方式:

npm install -g @anthropic-ai/claude-code

或者使用新的原生安装方式:

curl -fsSL claude.ai/install.sh | bash

安装完成后,进入项目目录并启动:

cd /path/to/your/project
claude

如果需要登录,Claude 会在会话中提示你完成认证。认证成功后,就可以直接开始使用。

先问代码库本身的问题

第一次提问最好是“描述性”的,而不是直接要求修改。可以先问 Claude:

  • 这个项目是做什么的?
  • 主入口文件在哪里?
  • 这个仓库用了哪些技术栈?
  • 请解释一下文件夹结构

这样做的好处是让 Claude 先读取项目上下文,再进入修改阶段。它会更像一个同事,而不是只能靠猜测回答的工具。

做第一次修改

等 Claude 理解了代码库,再给它一个具体任务:

这里有一个 bug:用户可以提交空表单。请找出原因并修复。

Anthropic 对典型工作流的描述很清楚:Claude 会定位相关代码、理解上下文、实现修复,并在可用时运行测试。这就是你应该建立的使用预期。

用后续追问控制节奏

Claude Code 最适合“边做边调整”:

  • 大改动前先让它列计划
  • 对风险较高的改动要求先解释
  • 输出范围太大时让它收缩
  • 让它用测试或更小的复现来验证结果

第一周真正要养成的习惯,不是立刻得到完美答案,而是把工作拆成可检查的小步骤。

常用命令

Anthropic 的快速上手文档里列了几个最常用的命令:

claude
claude "fix the build error"
claude -p "explain this function"
claude -c
claude -r

在会话中,/help 可以查看命令列表,/clear 可以重置对话历史,方便重新开始。

第一次会话检查清单

建议按下面的顺序尝试:

  1. 安装 CLI
  2. 登录
  3. 打开一个真实项目
  4. 让 Claude 解释仓库
  5. 交给它一个小而明确的任务
  6. 先审查结果,再决定是否扩大范围

这个流程刻意保持简单,就是为了让你先了解 Claude 在你的环境里是怎么工作的,再逐步把它用到更大的改动中。

官方参考资料

以上资料检索于 2026年3月29日。功能可用性、套餐限制和界面细节可能会变化,发布前请以链接中的 Anthropic 官方资料为准。

相关文章

Claude Code 报错 temporarily unavailable, so auto mode cannot determine the safety of bash 怎么解决

Claude Code auto 模式弹出「temporarily unavailable, so auto mode cannot determine the safety of bash」?先说结论:不是你的命令危险,是安全判定器(一次额外的模型调用)暂时联不上。本文给出四步处理、模型名×工具名×原因的完整变体速查,以及只读操作为何不受影响的机制解释。

llmclaude-code+3
pitfalls2026年9月4日4 min
227

复现一条能打穿 Claude Code auto 模式的注入链:模型拒跑恶意二进制,却自写代码把自己坑了

embracethered 8 月底放出一条攻击链,让一句『总结这个网页』把 auto 模式的 Claude Code 拖到 60~80% 的代码执行成功率——而 Anthropic 委托第三方测出的数字是 0.00%。我在隔离环境里把这条链拆开逐段实测:诱导模型从 WebFetch 降级到 curl 的分流端点、以及最关键的一环——模型『拒绝运行陌生二进制、改自己写 Python 解码器』这个安全决定本身,反而踩中了同目录下的同名 struct.py 投毒。确定性部分(分流 + 同名模块投毒 + 缓解对照)在本机完整复现并给出真实证据;live 端我这台机器因判定器限流 fail-closed 而没能跑通完整 RCE,如实标注。文末给出真正有用的缓解手段。

claude-codeauto-模式+5
hands-on2026年8月31日9 min
263

抓包拆开 Claude Code auto 模式的判定器:11 万字系统提示词逐段解析

上一篇复测确认了 auto 模式在放行 Bash 前会调一次会话模型当判定器,但那个判定器收到的到底是什么,一直是黑盒。这次我用本地日志代理把判定请求整包抓了下来:一份 116,879 字符的系统提示词,开头写着 You are a security monitor for autonomous AI coding agents。本文逐段引用抓包原文,拆开它的威胁模型、两级规则(1 条 HARD BLOCK / 68 条 SOFT BLOCK / 17 条 ALLOW)和两阶段判定流程——第一阶段只评估危害、明确不看用户意图,第二阶段才叠加意图和豁免。附三张真实终端截图和抓包证据,所有数字均来自本次读出,未经估计。

claude-code提示词+5
hands-on2026年8月30日11 min
286
把家里的 Mac mini 变成 24 小时在线的 Claude Code 工作站:claudecodeui + SSH 反向隧道,手机浏览器随时接管

把家里的 Mac mini 变成 24 小时在线的 Claude Code 工作站:claudecodeui + SSH 反向隧道,手机浏览器随时接管

家里的 Mac mini 常年开机跑 Claude Code,人在外面怎么用浏览器接管会话?这是一套上线一周、每天在用的真实方案:claudecodeui 做 Web 界面(选型对比了官方 Web 版、ttyd、code-server),SSH 反向隧道把它推到 VPS,nginx 加 TLS 和登录限流反代成一个普通网址。附完整配置、真实运行数据(隧道五天零掉线、内存 170MB)、上线一周就踩到并自己修掉的 <synthetic> 占位符 bug,以及「为什么不用 Tailscale」的正反论证。

claude-codeclaude-code-lab+7
claude2026年8月29日10 min
360