【macos用镜像站体验】Claude Code入门使用教程和常用命令
一、下载安装nodejs
# macOS 用户安装nodejs
brew update
brew install node
二、安装官方Claude Code
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 查看版本
claude --version
三、正式使用（国内镜像站）
今天发现的一个镜像站，只能被推荐用不能充值，注册好就送50美金额度刚好用来体验
https://anyrouter.top/register?aff=OLyW
新建一个token用来测试
claude一般是这样使用的
# 终端进入项目文件夹后运行
cd your-project-directory
claude
我是直接打开IDE，就可以省去进入文件夹的那一步骤，还方便看git等情况
#IDE控制台设置token和镜像站点网址，我是体验就没修改电脑环境变量，每次打开终端需要重新设置
export ANTHROPIC_AUTH_TOKEN=sk-P7XXXXXXXXXXX
export ANTHROPIC_BASE_URL=https://anyrouter.top
#运行
claude
随便测试的结果
项目初始化命令：
/init
Claude 会自动分析项目结构并生成 CLAUDE.md 项目说明文档（可附加“请生成中文”的指令）。
四、Claude Code 常用命令及其使用方法
| 命令类别 | 命令 | 描述 | 示例 | 用途 |
|---|---|---|---|---|
| 基本交互命令 | claude | 启动一个新的交互式会话，确保干净的上下文。 | claude "checkout a new branch and lint this project" | 开始新任务或处理简单命令。 |
claude --continue 或 claude -c | 恢复最近的会话，保留完整历史记录。 | claude -c | 节省时间，避免重新解释上下文，适合连续工作。 | |
claude --resume 或 claude -r | 显示过去的会话列表，允许选择恢复某个会话。 | claude -r | 在多个项目间切换时，如为每个项目分配专属 AI 助手。 | |
claude -p | 以无头模式运行，直接输出结果到终端，不进入交互界面。 | claude -p "How many files are in this project?" | 适合自动化脚本或快速查询。 | |
| 管道操作 | 将其他命令的输出管道输入 Claude Code，或反之。 | cat data.csv | claude -p "Who won the most games?" | 处理数据分析任务，如日志或 CSV 文件处理。 | |
| 项目设置和配置 | /init | 分析当前代码库，创建 CLAUDE.md 文件存储项目上下文。 | > /init | 新项目启动时使用，提升上下文感知能力。 |
claude config set --global preferredNotifChannel terminal_bell | 设置全局通知渠道为终端铃声，任务完成时提醒。 | 支持多任务处理，保持专注。 | ||
| 上下文管理 | /clear | 重置当前会话的对话历史，但保留 CLAUDE.md 和文件。 | 开始新任务时清除无关历史，避免混淆，速度快于新会话。 | |
/compact | 总结对话历史，减少令牌数，保留关键信息。 | 避免上下文限制，适合长时间交互，如智能笔记功能。 | ||
# | 将信息保存到 CLAUDE.md 文件，提供保存选项（1-3）。 | > # always use single responsibility principle when creating new methods | 记录重要原则或信息，供后续任务参考。 | |
| 代码分析和审查 | /review | 让 Claude Code 审查代码，提供改进建议。 | 发现 bug、检查风格、加速审查，提升学习效率。 | |
> summarize this project | 提供项目的高层概述，包括目的、功能和技术栈。 | > summarize this project | 新团队成员快速了解项目，节省阅读时间。 | |
> explain the folder structure | 分析并解释项目目录结构。 | > explain the folder structure | 快速理解组织方式，避免手动查找，节省时间。 | |
> find the files that handle user authentication | 定位处理用户身份验证的文件。 | > find the files that handle user authentication | 超强搜索功能，准确快速，节省手动查找时间。 | |
> explain the main architecture patterns used here | 识别主要架构模式（如 MVC、微服务）。 | > explain the main architecture patterns used here | 理解代码设计，确保新代码与架构一致，关键决策支持。 | |
| 任务自动化 | /bug-fix | 修复代码中的 bug。 | 快速定位并解决问题。 | |
/commit | 提交代码更改。 | 自动化提交流程，确保代码整洁。 | ||
/create-pr | 创建拉取请求（pull request）。 | 简化代码审查流程。 | ||
/fix-github-issue | 修复 GitHub 上的问题。 | > /fix-github-issue 39 | 从终端直接处理问题跟踪。 | |
/pr-review | 审查拉取请求。 | 快速提供反馈，提高代码质量。 | ||
/optimize | 优化代码性能或结构。 | 提高代码效率。 | ||
/repro-issue | 重现某个问题。 | 帮助调试，理解问题根源。 | ||
/tdd | 实施测试驱动开发（Test-Driven Development）。 | 确保代码质量和测试覆盖率。 | ||
| 文档和发布管理 | /add-to-changelog | 将更改添加到变更日志。 | 保持项目历史记录清晰。 | |
/create-docs | 创建项目文档。 | 自动化生成文档，减少手动编写。 | ||
/docs | 管理项目文档。 | 更新或扩展现有文档。 | ||
/explain-issue-fix | 解释某个问题是如何被修复的。 | 为文档或团队提供清晰说明。 | ||
/update-docs | 更新项目文档。 | 确保文档与代码同步。 | ||
/release | 管理发布流程。 | 自动化版本发布。 | ||
| 自定义命令 | 创建自定义命令 | 在 .claude/commands 目录中创建 Markdown 文件，每个文件对应一个自定义命令。 | 创建 test.md，内容为： # /project:test Run tests for the project | 自动化个人工作流，如运行测试、部署代码或生成模板。 |
| MCP（多通道插件） | claude mcp add playwright npx @playwright/mcp@latest | 添加 Playwright MCP，用于浏览器控制，如登录网站、截图。 | 扩展 Claude Code 能力，处理复杂任务。 |