Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具，可在终端中与 Claude 对话，进行代码编写、项目管理、Git 操作等。它基于 Node.js 开发，支持多平台运行。

AnyRouter 注册链接（邀请码：bAUl）：

https://anyrouter.top/register?aff=bAUl

macOS 安装教程

1. 安装 Node.js

Node.js 官网链接：

https://nodejs.org/zh-cn/

2. Claude Code 安装

1

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

3. 配置环境变量

如果使用 AnyRouter 或自定义网关，请在 ~/.zshrc 添加环境变量；如果是 Bash，请改为 ~/.bashrc。

1
2
3

echo 'export ANTHROPIC_BASE_URL="https://anyrouter.top"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-token-here"' >> ~/.zshrc
source ~/.zshrc

将 sk-your-token-here 替换为你的实际 API 密钥。

Windows 安装教程

方案一：通过 WSL 安装（推荐）

步骤一：启用 WSL 功能

  1. 以管理员身份打开 PowerShell
  2. 执行命令：
1

wsl --install
  1. 重启电脑

步骤二：安装 Linux 发行版

重启后系统会自动安装 Ubuntu。如需指定版本：

1

wsl --install -d Ubuntu-24.04

步骤三：安装 Node.js

在 WSL 终端中执行：

1
2
3

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version

步骤四：安装 Claude Code

1

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

步骤五：配置环境变量

1
2
3

echo 'export ANTHROPIC_BASE_URL="https://anyrouter.top"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-token-here"' >> ~/.bashrc
source ~/.bashrc

方案二：原生 Windows 安装

步骤一：安装 Node.js

Node.js 官网链接：

https://nodejs.org/zh-cn/

在 PowerShell 执行安装命令：

1
2
3

winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
node --version
npm --version

步骤二：安装 Claude Code

1

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

步骤三：配置环境变量

可以通过“系统属性 → 高级 → 环境变量”新增以下变量：

  • 变量名：ANTHROPIC_BASE_URL
  • 变量值：https://anyrouter.top
  • 变量名：ANTHROPIC_AUTH_TOKEN
  • 变量值：sk-your-api-key-here

也可以用 PowerShell 一键写入（需管理员）：

1
2

setx ANTHROPIC_BASE_URL "https://anyrouter.top" /M
setx ANTHROPIC_AUTH_TOKEN "sk-your-api-key-here" /M

Claude Code 搭配 AnyRouter

生成令牌：https://anyrouter.top/console/token

推荐使用 ~/.claude/settings.json 配置（没有就新建）：

1

vi ~/.claude/settings.json
1
2
3
4
5
6
7

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-u79lXXXUlQZswuDd28Ncq4KiifN3shUqOrYlwhdWP2YwG0tN",
    "ANTHROPIC_BASE_URL": "https://anyrouter.top",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

注意事项：

  • settings.json 必须是合法 JSON，注意引号与逗号
  • 如已在系统环境变量中设置 ANTHROPIC_*，请保持一致或移除避免冲突

验证安装

安装完成后，运行：

1

claude --version

如果安装成功，会显示 Claude Code 的版本号。

基本使用

  1. 打开终端（macOS）或 WSL/PowerShell（Windows）
  2. 进入项目目录：
1

cd /path/to/your/project
  1. 启动 Claude Code：
1

claude

常用命令：

  • claude help：查看帮助信息
  • claude "你的问题"：直接提问
  • Ctrl+D：退出 Claude Code

高级功能与实战技巧

核心命令与上下文管理

初始化项目

1

/init

让 Claude Code 通读当前文件夹下所有文件，分析项目结构，并生成 CLAUDE.md 文件。

CLAUDE.md 文件类似于 Cursor 的 .cursorrules，保存项目相关的知识库。Claude Code 后续对话都会携带此文件作为上下文。

技巧：可手动编辑此文件，补充 CSS 框架、编码规范等关键信息。

压缩上下文

1

/compact

排除对话中无关紧要的内容，提高 AI 专注力并降低 Token 消耗。

技巧：可附加指令告诉 AI 如何压缩（保留哪些重点）。

清除记忆

1

/clear

清除对话记录，开启新任务时使用，保持上下文干净。

临时 Shell 模式

1

!npm install

用法：输入 ! 后接命令。

优势：无需另开终端窗口；执行过程和结果会进入上下文，避免 AI 重复执行已知操作。

记忆模式

1

#

用法：输入 # 进入记忆模式，后续对话会被记录为长期记忆。

存储级别：

  • 项目级别：保存在当前项目的 CLAUDE.md 中
  • 用户级别：保存在用户配置目录（Windows 下通常为 C:\Users\用户名\.claude\config.json 或类似），对所有项目生效（适合保存全局 System Prompt）

IDE 集成与交互模式

VS Code 集成

  1. 安装插件：Claude Code VS Code（需搜索对应名称）
  2. 连接命令：
1

/ide

然后选择 VS Code

功能：

  • 代码感知：在 VS Code 中选中的代码，Claude Code 终端能直接读取并解释
  • Diff 视图：AI 修改代码时，VS Code 会弹出对比页面，方便直观查看差异并决定是否接受

非交互模式

1

claude -p "你的问题"

用法：类似命令行工具，后台思考并处理问题后直接输出结果，适合单次任务。

Claude Code 原生支持 Chrome

Claude Code 最新版原生支持调用 Chrome 浏览器的功能。相比于以往的自动化工具，它能直接复用用户日常使用的 Chrome 浏览器环境（包括登录状态、插件、历史记录等），极大地简化了自动化任务、UI 调试和 API 测试的流程。

1. 核心功能与设置

启用方式：

  • 将 Claude Code 升级到最新版。
  • 使用 /chrome 命令进入设置。
  • 设置默认为“启用” (Enabled) 并管理权限。
  • 首次使用可能需要安装浏览器扩展，按提示操作即可。

主要优势：

  • 复用环境：不同于传统的自动化工具（如 Playwright 或 Chrome DevTools 开启的新实例），Claude Code 调用的 Chrome 保留了用户的账号登录状态、浏览记录、插件扩展等。
  • 省时省力：不需要每次执行任务时重新登录所有账号（如 Google、Twitter/X 等）。
  • 能力全面：支持点击、输入、表单填写、多标签页管理（分组）、读取 Console Logs 和 Network Requests。

但需登录,请确保已经开通了付费订阅

MCP (Model Context Protocol) 协议集成

MCP 是 AI 与外部工具的中间层，能极大扩展 Claude Code 的能力。

安装 MCP Server

1

claude mcp add [名字] -- [启动命令]

示例 1：文档搜索工具

1

npx -y @modelcontextprotocol/server-name

作用：让 AI 能够实时查阅最新技术文档（如 Tailwind v4），解决知识库滞后问题。

示例 2：数据库工具

安装 SQLite 或 PostgreSQL 的 MCP Server，让 AI 直接查询数据库表结构、执行 SQL。

管理 MCP

查看列表：

1

/mcp

删除服务：

1

claude mcp remove [名字]

其他说明：

  • 远程 MCP：支持 SSE 或 Stdio 协议连接远程服务
  • 作用域：安装时加 --scope user 可设置为用户级（全局生效），否则默认项目级

权限管理

查看/配置权限：

1

/permissions

自动化授权 (Allow List)

将特定工具（如 git commit、特定 MCP）加入白名单，AI 调用时无需人工确认。

配置：支持按工具名称（如 bash）或 MCP 名称配置。

禁用工具 (Block List)

明确禁止 AI 使用某些工具。

上帝模式

启动参数：

1

claude --dangerously-skip-permissions

效果：AI 拥有最高权限，执行任何命令都不需要再次申请，全自动执行。

自定义扩展

自定义命令

位置：项目目录下 .claude/commands/ 文件夹

方法：新建 Markdown 文件（如 code-review.md）

内容：用自然语言描述命令逻辑（如"对比 main 分支差异并给出审核意见"）

参数传递：使用 ${argument} 占位符

全局生效：将 .claude/commands 放到用户配置目录下

钩子 (Hooks)

位置：.claude/config.json 或 settings.local.json

场景：在特定事件前后自动执行脚本

案例：post_tool_execution（工具执行后）

实现：每次 AI 修改文件后，自动运行 prettier 或 lint 检查格式。如果报错，AI 会自动读取错误并修复，形成闭环。

高级功能：Subagents (子智能体)

概念：类似编程中的"多线程"，将复杂任务拆解给多个专用的 Agent 并行执行。

创建：

1

/subagent

然后选择 create

配置：设定 Agent 的角色（如"代码审核大师"、“天气预报员”）、权限、模型和颜色

运行机制：

  1. 主 Agent 拆解任务
  2. 分发给 Subagents（每个 Subagent 只有执行任务所需的精简上下文，互不干扰）
  3. 主 Agent 汇总结果

GitHub 集成

工具：结合 GitHub CLI (gh)

场景：

  • 读取 Issue 自动修复：让 Claude Code 读取某个 Issue 的内容，创建修复分支，修改代码，最后推送代码
  • 查看仓库：列出仓库、PR 等信息

会话与历史管理

恢复话题

1

/resume

查找并继续历史对话

导出对话

1

/export

将对话内容复制到剪贴板或保存文件（可用于让其他 AI 交叉验证）

Agent Skills

Agent Skills 是将工作流程打包成可重复使用的"技能包"，能让 Claude 按照你的标准完成特定任务。

什么是 Agent Skills？

定义：把你的专业方法论写成标准化流程，让模型按流程稳定复用。

核心特性：

  • 渐进式披露：启动时只读取技能名称与简介（约 100 字），只有被调用时才加载详情，理论上可以"装备"上百个 Skills 而不会挤爆上下文
  • 高可复用性：跨项目/跨对话复用，Claude 会根据语境判断何时调用哪个 Skill
  • 团队共享：技能包可以打包分享给团队统一复用

使用场景

  • Skill：重复性强的流程类任务，如需求分析、竞品调研、PRD 产出
  • Agent：复杂独立难题，需要大量探索或开放式推理
  • Command：一次性的短操作，如 /format、/translate

创建技能

在 .claude/skills 下创建技能目录：

1

.claude/skills/product_manager_expert/

在目录内新建 SKILL.md，定义角色与能力。示例内容包括：

  • 角色定义：产品经理专家
  • 核心能力：需求分析、竞品搜索、用户痛点提炼、PRD 输出
  • 输出格式：结构化 PRD.md 文档

完整的 SKILL.md 文件应包含技能的名称、描述、使用场景、输入输出格式等详细信息。

多技能串联

增加更多技能实现工作流编排：

  • designer_expert/：生成设计规范、配色、交互稿
  • developer_expert/：负责写代码、接口定义、工程化落地

推荐输出链路：

  1. 产品技能输出 PRD
  2. 设计技能基于 PRD 输出设计规范
  3. 开发技能根据设计规范产出代码/接口/实现计划

打包分享

完成技能目录后，可直接打包为 .zip：

1

zip -r skills.zip .claude/skills/

在 Claude 网页版上传该 zip 包，即可直接获得技能。

核心理念：你的输入质量，就是 AI 的输出上限。Skill 能复用流程、提高效率，但无法替代你对业务场景的理解和专业沉淀。

常见问题解决

网络连接问题

如果在中国大陆网络环境安装缓慢或失败，可以切换 npm 镜像源：

1

npm config set registry https://registry.npmmirror.com

如需恢复官方源：

1

npm config set registry https://registry.npmjs.org

卸载方法

macOS / WSL：

1

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

Windows（原生）：

1

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

卸载后请删除系统环境变量 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。

资源链接