Claude Code 新手小白使用指南

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。你可以在终端里让它阅读项目、解释代码、修改文件、运行命令、排查报错，也可以把它当成一个会操作本地项目的开发搭档。

本教程面向第一次使用 Claude Code 的新手，目标是让你完成三件事：

安装 Claude Code
配置 API Key 和接口地址
在一个真实项目里跑通第一次对话

关于密钥

ANTHROPIC_AUTH_TOKEN 是你的 API Key，不要发给别人，也不要提交到 GitHub。本文示例里的空字符串需要换成你自己的密钥。

一、使用前准备

1. 准备 Node.js

Claude Code 通过 npm 安装，所以电脑上需要先有 Node.js。

在终端执行：

bash

node -v
npm -v

如果能看到版本号，说明已经装好了。比如：

bash

v20.11.1
10.2.4

如果提示命令不存在，先去安装 Node.js：

https://nodejs.org/

2. 准备 API Key

你需要有一个可用于 Claude Code 的 API Key。拿到以后先保存好，后面会写入 Claude Code 的配置文件。

常见配置会用到这两个值：

配置项	作用
`ANTHROPIC_AUTH_TOKEN`	你的 API Key
`ANTHROPIC_BASE_URL`	Claude Code 请求接口的地址

二、安装 Claude Code

打开终端，执行：

bash

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

安装完成后，检查命令是否可用：

bash

claude --version

如果能输出版本号，说明安装成功。

如果提示没有权限

macOS 或 Linux 上全局安装 npm 包时可能遇到权限问题。可以先尝试给命令前面加 sudo：

bash

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

Windows 用户建议使用管理员身份打开终端后再安装。

三、找到 Claude Code 配置目录

Claude Code 的配置一般放在用户目录下的 .claude 文件夹里。

Windows

在 CMD 或 PowerShell 里执行：

bash

start "" "%USERPROFILE%\.claude"

如果文件夹不存在，可以手动创建：

bash

mkdir "%USERPROFILE%\.claude"

macOS

在终端执行：

bash

open "$HOME/.claude"

如果文件夹不存在，可以先创建：

bash

mkdir -p "$HOME/.claude"
open "$HOME/.claude"

Linux

在终端执行：

bash

mkdir -p "$HOME/.claude"
xdg-open "$HOME/.claude"

如果你的 Linux 环境没有图形界面，只创建文件夹即可。

四、创建 settings.json

在 .claude 文件夹里创建一个文件：

text

settings.json

写入下面内容：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://coding-play.codes/claude",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

需要修改的地方只有两个：

把 你的 API Key 换成你后台生成的真实 API Key
如果你使用的不是示例接口，把 ANTHROPIC_BASE_URL 换成你的服务商提供的地址

参考配置

参考文档中给出的示例渠道包括：

https://coding-play.codes/claude
https://coding-play.codes/claude-aws

你实际使用哪个地址，取决于你的账号后台或服务商说明。

五、第一次运行 Claude Code

进入你想让 Claude Code 处理的项目目录，例如：

bash

cd ~/Desktop/my-project

然后执行：

bash

claude

第一次进入时，它可能会询问是否信任当前目录。确认这是你自己的项目后，可以选择信任。

进入对话后，可以先发一个简单任务：

text

请帮我看一下这个项目是用什么技术栈写的

也可以让它解释项目结构：

text

请阅读当前项目，告诉我主要目录分别是做什么的

如果 Claude Code 能正常回答，并且能看到当前项目文件，就说明基础配置已经跑通。

六、新手常用问法

了解项目

text

请先阅读这个项目，不要改代码，告诉我它的技术栈、启动方式和主要目录结构

修改文档

text

帮我在 docs 目录新增一篇新手教程，并把首页入口也加上

排查报错

text

我运行 npm run dev 报错了，请帮我定位原因并修复

修改代码前先给方案

text

先不要改代码，请先给我一个实现方案，说明会改哪些文件

让它自己验证

text

修改完成后，请运行项目已有的检查命令，确认没有报错

七、常见问题

claude: command not found

说明 Claude Code 没有安装成功，或者 npm 全局命令目录没有加入环境变量。

先重新安装：

bash

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

再检查：

bash

npm list -g --depth=0

401 或 authentication failed

通常是 API Key 不正确。检查 .claude/settings.json 里的 ANTHROPIC_AUTH_TOKEN：

是否漏填
是否多复制了空格
是否复制错了 Key
当前 Key 是否还有余额或权限

连接失败或超时

检查 ANTHROPIC_BASE_URL 是否正确。如果你使用的是第三方接口，确认它提供的是 Claude Code 可用的接口地址。

也可以临时换一个网络环境测试，排除本机网络问题。

修改了 settings.json 但没生效

先完全退出 Claude Code，再重新执行：

bash

claude

如果仍然没生效，检查文件名是否写成了：

text

settings.json

不要写成：

text

settings.json.txt

八、推荐使用习惯

刚开始用 Claude Code 时，建议养成几个习惯：

让它先读项目、再动手改
大改之前先让它给方案
每次只提一个明确任务
涉及删除、重构、提交代码时，让它先说明影响范围
不要把 API Key、密码、私密文件粘贴进对话

完成

到这里，你已经完成 Claude Code 的安装、配置和第一次运行。后续只要进入项目目录执行 claude，就可以让它协助你阅读、修改和验证项目。

Claude Code 新手小白使用指南 ​

一、使用前准备 ​

1. 准备 Node.js ​

2. 准备 API Key ​

二、安装 Claude Code ​

三、找到 Claude Code 配置目录 ​

Windows ​

macOS ​

Linux ​

四、创建 settings.json ​

五、第一次运行 Claude Code ​

六、新手常用问法 ​

了解项目 ​

修改文档 ​

排查报错 ​

修改代码前先给方案 ​

让它自己验证 ​

七、常见问题 ​

claude: command not found ​

401 或 authentication failed ​

连接失败或超时 ​

修改了 settings.json 但没生效 ​

八、推荐使用习惯 ​

Claude Code 新手小白使用指南

一、使用前准备

1. 准备 Node.js

2. 准备 API Key

二、安装 Claude Code

三、找到 Claude Code 配置目录

Windows

macOS

Linux

四、创建 settings.json

五、第一次运行 Claude Code

六、新手常用问法

了解项目

修改文档

排查报错

修改代码前先给方案

让它自己验证

七、常见问题

claude: command not found

401 或 authentication failed

连接失败或超时

修改了 settings.json 但没生效

八、推荐使用习惯