一、前置准备与安装

1. 安装 Node.js：确保系统已安装 Node.js（版本需 ≥ 18.0），可通过终端输入 node -v 验证。

2. 全局安装工具：在命令行执行以下命令完成安装：

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

3. 验证安装：运行 claude --version，成功输出版本号即代表安装完毕。

二、核心配置（解决国内网络与模型限制）

由于官方服务存在地域限制且默认调用不兼容的模型，必须通过配置文件接入国内大模型（以阿里云百炼为例）。

1. 找到配置文件：

  • Windows 路径：C:\Users\<你的用户名>\.claude\settings.json

  • macOS/Linux 路径：~/.claude/settings.json

2. 写入配置代码：将以下内容填入配置文件并保存：

{
  "env": {
    // 【接口地址】指定阿里云百炼的 Anthropic 兼容接口 Base URL
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    // 【身份凭证】填入你在阿里云百炼控制台获取的 API Key
    "ANTHROPIC_AUTH_TOKEN": "sk-b5e****3a01",
    // 【全局默认模型】当 AI 没有明确指定级别时使用的兜底模型（推荐性价比高的 qwen-plus）
    "ANTHROPIC_MODEL": "qwen-plus",
    // 【最强算力映射】对应官方 Opus 级别。遇到复杂架构或深度 Debug 时调用（可替换为 qwen-max）
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen-plus",
    // 【主力干活映射】对应官方 Sonnet 级别。处理日常 90% 的代码编写与问答任务
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen-plus",
    // 【轻量助手映射】对应官方 Haiku 级别。处理简单格式化等重复任务，响应快且省 Token
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen-turbo"
  },
  // 【界面主题】设置终端界面的显示风格
  "theme": "dark"
}

注：修改后必须彻底重启终端或 IDE 才能生效。

三、启动与初始化流程

1. 进入项目目录：使用 cd 命令进入你的代码工程文件夹。

2. 启动程序：输入 claude 并回车。首次运行会提示信任当前文件夹，输入 1 确认即可。

3. 生成项目记忆：强烈建议在对话框首先输入 /init。该指令会扫描项目并生成 CLAUDE.md 规则文件，帮助 AI 深度理解你的技术栈和开发规范。

四、工作模式与高频命令

1. 三种工作模式切换：在对话界面按 Shift + Tab 可循环切换：

  • Default：每次修改文件或执行 Shell 命令前都会请求确认（最安全）。

  • Auto-Accept：自动接受文件修改，仅在执行系统命令时询问（适合批量操作）。

  • Plan Mode：只读分析模式，AI 仅规划方案而不做实质性修改（适合需求梳理）。

2. 常用斜杠命令

  • /init：初始化项目，生成规则文档。

  • /memory：手动编辑项目规则（CLAUDE.md）。

  • /compact：压缩上下文，缓解长对话导致的卡顿与 Token 消耗。

  • /clear：清空当前会话历史。

  • /model <模型名>：动态切换当前使用的模型（如 /model qwen-max）。

  • /status：检查当前连接的模型、接口及权限状态。

  • Ctrl+C：随时中断 AI 正在执行的操作。