Claude Code 使用

Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.

本文档介绍在 Quectel Pi M1 上安装、配置并使用 Claude Code 的基本方法。Claude Code 可在终端中协助完成代码编写、文件修改、命令执行和项目分析等工作，适合用于板端应用开发、脚本调试和示例工程验证。

Claude Code 官方文档请参考：Claude Code Docs。

准备工作

在开始安装前，请确认满足以下条件：

  • 设备使用的是Debian系统固件

  • 设备已连接网络；

  • 当前用户具有 sudo 权限；

  • 已获取 Claude Code 服务地址、访问令牌和模型名称等配置参数。

本文示例中的 <your_api_token>、<your_base_url> 和 <model_name> 请替换为实际获取到的参数。

安装步骤

安装基础工具

更新系统软件源，并安装 curl、git 等基础工具：

sudo apt update
sudo apt install -y curl git ca-certificates build-essential jq

安装 Node.js 22

Claude Code 通过 npm 安装，建议使用 Node.js 22 或更新版本。可通过 NodeSource 安装 Node.js 22：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

安装完成后，验证 Node.js 和 npm 版本：

node -v
npm -v

若终端能够正常输出版本号，则表示 Node.js 环境已安装完成。

安装 Claude Code

使用 npm 全局安装 Claude Code：

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

安装完成后，验证 Claude Code 是否可用：

claude --version

若终端能够正常输出版本号，则表示安装成功。

配置访问参数

使用官方服务

如果直接使用官方 Claude Code 服务，在当前终端中设置访问令牌：

export ANTHROPIC_AUTH_TOKEN=<your_api_token>

使用代理或企业网关

如果通过代理服务或企业网关访问，同时配置服务地址、访问令牌和模型参数：

export ANTHROPIC_BASE_URL=<your_base_url>export ANTHROPIC_AUTH_TOKEN=<your_api_token>export API_TIMEOUT_MS=600000export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1export ANTHROPIC_MODEL=<model_name>export ANTHROPIC_SMALL_FAST_MODEL=<small_fast_model_name>

参数说明如下：

参数

说明

ANTHROPIC_BASE_URL

API 服务地址。使用官方服务时通常无需设置。

ANTHROPIC_AUTH_TOKEN

Claude Code 访问令牌。

API_TIMEOUT_MS

API 请求等待时间，网络较慢或模型响应较慢时可适当调大。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

设置为 1 后关闭非必要流量。

ANTHROPIC_MODEL

默认使用的主模型。

ANTHROPIC_SMALL_FAST_MODEL

默认使用的轻量快速模型。

上述 export 命令只对当前终端会话生效。若需要长期生效，可将环境变量写入 ~/.bashrc 或其他 shell 配置文件中。

启动 Claude Code

完成安装和环境变量配置后，在终端中执行以下命令启动 Claude Code：

claude

首次启动时，Claude Code 可能会进行登录校验、配置确认或权限提示。请根据终端提示完成初始化。

使用示例

分析项目代码结构

进入需要分析的项目目录，启动 Claude Code 后输入分析指令：

cd ~/my_project
claude

在 Claude Code 交互界面中输入任务描述，例如：

分析当前项目的代码结构，列出主要模块、入口文件和依赖关系。

Claude Code 会自动读取项目中的文件和目录，输出代码结构概览、模块划分及调用关系等信息，帮助快速了解陌生项目的整体架构。

../../_images/image_Y2RwbiKGboZfyqxh0IGcp6rlnRf.webp ../../_images/image_GPa7be8zyoDfevxhu2rcS52wnXc.webp

常用命令

查看 Claude Code 版本：

claude --version

查看 Claude Code 帮助信息：

claude --help

进入项目目录并启动 Claude Code：

cd <project_path>
claude

管理对话：

命令

功能

claude --continue

恢复当前目录中最近的会话

claude --resume

打开会话管理器

claude --resume

直接恢复命名的会话

claude --from-pr

恢复链接到该拉取请求的会话

/resume

从活跃会话内切换到不同的对话

问题处理

  • 若执行 claude 后提示命令不存在，请重新确认 npm 全局安装是否成功，并检查 npm 全局命令目录是否已加入 PATH；

  • 若 npm install 下载较慢，可根据实际网络环境配置 npm 镜像源后重新安装；

  • 若启动后提示认证失败，请检查 ANTHROPIC_AUTH_TOKEN 是否配置正确；

  • 若使用代理或企业网关后无法连接，请检查 ANTHROPIC_BASE_URL、模型名称和网络连通性；

  • 若执行硬件控制任务，请先确认引脚复用关系、GPIO 访问权限和外设连接方式。