Claude Code 安装使用指南

kaituoC

550人浏览 · 2026-03-24 00:02:32

kaituoC · 2026-03-24 00:02:32 发布

文章目录

1. 安装 Claude Code
- 1.1 macOS/Linux
- 1.2 Windows
2. 配置模型
- 2.1 macOS/Linux
- 2.2 Windows
3. 使用 Claude Code
4. 常见命令
5. 最佳实践

1. 安装 Claude Code

1.1 macOS/Linux

安装或更新 Node.js（v18.0 或更高版本）。
在终端中执行下列命令，安装 Claude Code。
```
npm install -g @anthropic-ai/claude-code
```
运行以下命令验证安装。若有版本号输出，则表示安装成功。
```
claude --version
```

1.2 Windows

在 Windows 上使用 Claude Code，需要安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行以下命令。

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

详情可以参考Claude Code官方文档的Windows安装教程。

2. 配置模型

2.1 macOS/Linux

创建并打开配置文件~/.claude/settings.json。

~ 代表用户主目录。如果 .claude 目录不存在，需要先行创建。可在终端执行 mkdir -p ~/.claude 来创建。
```
nano ~/.claude/settings.json
```

编辑配置文件。将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。

{    
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.5-plus"
    }
}

保存配置文件，重新打开一个终端即可生效。

编辑或新增 ~/.claude.json 文件，将hasCompletedOnboarding 字段的值设置为 true并保存文件。
```
{
  "hasCompletedOnboarding": true
}
```
hasCompletedOnboarding 作为顶层字段，请勿嵌套于其他字段。

该步骤可避免启动Claude Code时报错：Unable to connect to Anthropic services。

2.2 Windows

创建并打开配置文件C:\Users\您的用户名\.claude\settings.json。

CMD 使用以下方式：

1.  创建目录
    
    ```
    if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
    ```
    
2.  创建并打开文件
    
    ```
    notepad "%USERPROFILE%\.claude\settings.json"
    ```

PowerShell 使用以下方式：

1.  创建目录
    
    ```
    mkdir -Force $HOME\.claude
    ```
    
2.  创建并打开文件
    
    ```
    notepad $HOME\.claude\settings.json
    ```

编辑配置文件。将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。

{    
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.5-plus"
    }
}

保存配置文件，重新打开一个终端即可生效。

编辑或新增 C:\Users\您的用户名\.claude.json 文件，将hasCompletedOnboarding 字段的值设置为 true，并保存文件。
```
{
  "hasCompletedOnboarding": true
}
```

3. 使用 Claude Code

打开终端，并进入项目所在的目录。运行以下命令启动程序 Claude Code：
```
cd path/to/your_project
claude
```
启动后，需要授权 Claude Code 执行文件。
3. 输入/status确认模型、Base URL、API Key 是否配置正确。
在 Claude Code 中对话。

4. 常见命令

命令	说明	示例
/init	在项目根目录生成 CLAUDE.md 文件，用于定义项目级指令和上下文。	/init
/status	查看当前模型、API Key、Base URL 等配置状态。	/status
/model <模型名称>	切换模型。	/model qwen3-coder-next
/clear	清除对话历史，开始全新对话。	/clear
/plan	进入规划模式，仅分析和讨论方案，不修改代码。	/plan
/compact	压缩对话历史，释放上下文窗口空间。	/compact
/config	打开配置菜单，可设置语言、主题等。	/config

更多命令与用法详情，请参考 Claude Code 官方文档。

5. 最佳实践

5.1 上下文管理

及时清理： 使用 /clear 定期重置对话，防止旧的上下文干扰新任务并节省 Token。
主动压缩：使用 /compact 命令让 Claude 总结关键决策和修改的文件，保留核心记忆。
明确指定文件： 提问时使用 @ 引用文件（如 write a test for @auth.py），避免模型无效扫描整个项目。
善用子代理（Sub-agents）： 对于大规模任务，让 Claude 启动子代理执行。子代理完成任务后返回精炼结论，保护主对话的上下文空间。

5.2 先计划，再执行

启用 Plan 模式：复杂任务前，先分析方案，不实际修改文件。
- 快捷操作：连续按两次 Shift + Tab 进入 Plan Mode。
- 提示词约束：提示词明确要求“先输出详细实施计划，经我确认后再修改文件”。
降低试错成本：确保逻辑闭环后再进行代码变更。

5.3 沉淀项目核心知识：编写 CLAUDE.md

包含关键信息：每次会话启动时自动加载CLAUDE.md，建议填入构建命令、代码规范及工作流等通用规则。
动态维护：内容应简短易读，仅记录广泛适用的全局约定，并随项目演进持续补充新规则。

5.4 扩展能力： MCP 与 Skills

MCP：安装成熟的 MCP Server，连接外部服务。例如：添加联网搜索MCP。
Skills：编写详细的 Skill 描述文案。Claude 决定是否调用该工具，取决于对该工具用途的定义。例如：添加视觉理解能力Skill。
Skills vs MCP：Skills 教会 Claude “怎么做”（工作流知识），MCP 给 Claude“做的工具”（外部接口）。两者互补，Skills 也可集成外部接口。

5.5 自动化守护：Hooks

使用Hooks：Hooks 是确定性规则。它在 Claude 工作流的特定生命周期节点（如 PreToolUse 工具执行前校验等）自动运行本地脚本，确保关键校验或操作 100% 执行。
配置方式：
1. 运行 /hooks 进行交互式配置。
2. 直接编辑 .claude/settings.json。
3. 让 Claude 帮你编写，如：“编写一个在每次文件编辑后运行 eslint 的 hook”。