---
title: Claude Code 使用教程
sidebarTitle: Claude Code
description: 安装 Claude Code，配置无限星河AI鉴权与模型，并在终端中验证项目读取和编程请求。
---

Claude Code 是一个终端 AI 编程工具，可以读取项目、修改文件和运行命令。只想聊天的用户不需要安装它。

![Claude Code 运行界面](/images/tutorials/claude-code/claude-code-terminal.png)

## 安装 Claude Code

按照 [Claude Code 安装说明](https://code.claude.com/docs/en/setup) 安装。使用 npm 时可以执行：

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

## 配置并启动

Windows PowerShell：

```powershell
$env:ANTHROPIC_BASE_URL = "https://infistar.cc"
$env:ANTHROPIC_AUTH_TOKEN = "你的_API_Key"
claude
```

macOS 或 Linux：

```bash
export ANTHROPIC_BASE_URL="https://infistar.cc"
export ANTHROPIC_AUTH_TOKEN="你的_API_Key"
claude
```

地址不要添加 `/v1`。Claude Code 会自动补全请求路径。

## 检查是否成功

进入 Claude Code 后输入 `/status`，确认地址显示为 `https://infistar.cc`。然后发送：

```text
请只回复“配置成功”，不要读取或修改文件，也不要运行命令。
```

## 保存配置

测试成功后，可以把配置保存到 `%USERPROFILE%\.claude\settings.json` 或 `~/.claude/settings.json`：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://infistar.cc",
    "ANTHROPIC_AUTH_TOKEN": "你的_API_Key"
  }
}
```

这个文件包含 API Key，不要分享或上传到 Git。

## 遇到问题

- **提示 404**：地址中不要填写 `/v1`。
- **提示 401**：使用 `ANTHROPIC_AUTH_TOKEN`，并重新复制 API Key。
- **仍然要求登录**：从设置过变量的同一个终端运行 `claude`，再用 `/status` 检查。
- **提示模型不可用**：确认当前 API Key 可以使用对应模型。