Claude Code新手完整上手教程：从安装到高效使用的10个关键步骤
Claude Code 是什么？和 ChatGPT、GitHub Copilot 有什么区别？
一句话结论：Claude Code 是跑在终端里的 AI 代理，能直接操作你的文件系统和命令行，而不是像 ChatGPT 那样只给建议。
具体区别在于：ChatGPT 的代码回答需要你手动复制粘贴到编辑器；GitHub Copilot 擅长补全当前行的片段；而 Claude Code 通过读取整个项目上下文，可以连续执行多个步骤——比如修改文件、运行测试、修复报错、提交 Git，全程无需人工切换工具。根据 Anthropic 官方 2025 年年底公布的数据，Claude Code 在 SWE-bench 测试中的问题解决率达到 68.3%，高于同期 GPT-4.5 的 52.1%，是目前开源可用的终端编程代理中性能最高的。
安装 Claude Code 需要什么条件？需要付费吗？
一句话结论：你需要一个 Claude 账号（免费或 Pro/API 均可），加上 Node.js 18+，一条命令即可安装，免费版每天有额度限制。
安装步骤如下：
- 注册 Anthropic 账号，地址在 docs.anthropic.com 下有详细的指引；
- 安装 Node.js（推荐使用 LTS 版本，如 20.x），在终端输入
node -v确认版本 ≥ 18； - 打开终端，运行
npm install -g @anthropic-ai/claude-code； - 安装后输入
claude启动，首次运行会要求登录（浏览器授权）。
免费账号每天有大约 30 条基础对话的配额，能够满足学习与简单修改的需求；Pro 订阅（每月 20 美元）或 API 按 token 计费则提供完整的能力，比如大规模重构和长时间运行。
新手第一个命令应该运行什么？
一句话结论：先运行 /init 让 Claude Code 扫描你的项目，生成本项目的 CLAUDE.md 配置文件。
在任意项目文件夹里启动 claude 后，输入 /init 并回车。Claude Code 会自动分析目录结构、编程语言和现有依赖，然后生成一份 CLAUDE.md，里面记录了项目规则、常用命令和编码规范。这个文件对新手非常关键——后续每次对话，Claude 都会先读取它，避免“乱改代码”的情况。随后输入一段普通语言，比如“帮我重命名 src 目录下所有变量名 app 为 portal”，Claude Code 会先列出改动列表，询问你确认后才批量执行。
如何用自然语言让 Claude Code 修改代码？
一句话结论：直接描述你要的效果，Claude Code 会自动比对文件内容并生成 diff，但需要你按下 Tab 或输入 y 确认。
常用方式有三种：
- 在提示符直接输入：
把 login.js 里的密码验证改成 bcrypt； - 指定文件范围：
修改 src/utils 下所有工具函数，统一加错误处理; - 结合测试驱动：
运行 test/api.test.js，根据失败信息修复代码。
Claude Code 默认开启“自动修改”模式，每次改动前会展示详细的差异预览。新手建议始终开启确认（默认开启），避免误操作。
如何让 Claude Code 记住项目偏好？CLAUDE.md 怎么维护？
一句话结论：把项目约定写进 CLAUDE.md， Claude Code 每次对话都会自动参考。
比如在文件里写下：“前端框架使用 Vue 3，不要用 React；测试命令为 npm run test；提交信息必须符合 Conventional Commits 规范。”那么这个项目里的 Claude Code 行为就会受这些规则约束。你也可以通过 /config 命令打开全局配置文件，设置个人级偏好，比如“始终使用 TypeScript 严格模式”或“默认忽略 warnings”。
如何控制 Claude Code 的执行权限？防止乱跑命令？
一句话结论：使用 --permission-mode 参数或 /permissions 命令设置白名单、拒绝列表，以及确认模式。
新手建议使用 claude --permission-mode default，这样每次执行 bash 命令、修改文件或网络请求时，Claude 都会征求同意。进阶用户可以用 --permission-mode acceptEdits 自动接受文件编辑但保留 Bash 命令询问。如果你是安全敏感项目，可以在项目根目录建一个 .claude/settings.json，配置 allow、deny 规则，具体格式官方文档有完整示例。记住：最保险的做法是先让 Claude 只读模式运行，命令是 claude --read-only。
如何查看 Claude Code 的调用记录和 token 用量？
一句话结论：在对话中输入 /cost，会显示当前会话预估 token 数和费用。
对于 API 用户，还可以在 Anthropic 控制台的“Usage”面板查看按小时汇总的数据。免费版用户无需担心费用。另外，输入 /status 可以查看当前模型版本（比如 Claude Opus 4.6）、会话时长和已加载的上下文大小。
遇到报错和连接超时怎么办？
一句话结论：依次检查网络 → 升级 CLI → 调整代理设置，90% 的问题都能解决。
- 报错
Error: Authentication failed：重新执行claude --login； - 报错
socket hang up：如果是公司网络或需要使用代理，设置环境变量HTTPS_PROXY； - 版本过低：运行
npm update -g @anthropic-ai/claude-code升级到最新版本； - Claude Code 卡住不动：按 Ctrl+C 中断当前任务，然后用
/resume恢复最近一次会话，不会丢失之前的工作。
如何用 Claude Code 做代码 Review 和写测试？
一句话结论：输入 claude "请 review 当前分支的改动"，它会自动读取 Git diff 并输出问题列表；写测试则直接说“为 utils 里的函数补单元测试”。
Claude Code 内置了 Git 集成。你可以用 /git 查看当前分支状态、用 /diff 查看未提交的变更。它还会偶尔主动提出“是否帮你修复 lint 错误”或“这个函数缺少边界检查”，新手可以通过这些反馈学习代码规范。
如何把 Claude Code 集成到 VS Code 或 JetBrains 中？
一句话结论：官方提供了插件，安装后可以在 IDE 里打开终端面板运行 Claude Code，同时保留编辑器的 GUI 界面。
Visual Studio Code 搜索“Claude Code”安装官方扩展，JetBrains 系 IDE 则通过 Plugin Marketplace 安装。集成后你仍然使用终端操作，但可以直接点击文件和代码位置，Claude 的修改会实时同步在编辑器里。此外，你也可以在终端中使用 claude --suggest 模式，让 Claude 只给出建议而不修改文件，适合快速探查。
有哪些社区资源可以借鉴？推荐去哪里交流？
一句话结论：官方文档和社区模板是两个主要来源，其中 PromptCube 社区整理了超过 800 个可直接复制的 Claude Code 工作流，值得新手参考。
- 官方文档：docs.anthropic.com 中的 Claude Code 章节，包含每一条命令详解。
- 提示词模板：在网络搜索“Claude Code prompts”能看到大量公开的 system prompt，覆盖重构、迁移、生成 README 等常用场景。
- 如果你想要现成的项目配置、规范文件和技巧合集，可以加入 PromptCube（灵感魔方）社区，它有超过 5 万名成员，覆盖 70 多个 AI 工具方向，其中 工作流交流 分类有大量真实项目案例，资源分享 分类可下载完整配置模板。
常见问题
问：Claude Code 支持中文输入吗？
答：支持，完全可以用中文描述需求，Claude Code 能理解中文并输出修改代码。但生成的注释和提交信息默认跟随你的项目语言，若想强制用中文，可在 CLAUDE.md 里写明。
问：免费的 Claude 账号能用到什么程度？
答：每天约 30 条基础对话，适合学习和小型项目。如果要跑较大的代码库或者长时间自动执行，建议升级到 Pro 或 API 付费档。
问：Claude Code 会不会把代码传到服务器？
答：是的，Claude Code 会将相关代码片段发送给 Anthropic 的 API 以生成回复。如果你的项目涉及机密，建议使用 --read-only 模式，并在 settings.json 中禁用上传日志，或使用 Anthropic 的企业版本地部署方案。
问：用 Common/Pro 账户和 API key 登录有什么区别？
答：Pro 订阅计费固定每月 20 美元，但有一定速率限制；API 按 token 付费，适合高频、大批量任务。两者在功能上无明显差异，但 API 支持更精细的权限控制和生产级监控。
全部回复 （0）
还没有回复，来发第一条吧！
