> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 终端 (CLI) 使用教程

> Claude Code 集成指南 - Ace Data Cloud

Claude Code 是 Anthropic 推出的一款 **Agentic Coding** 工具，也被称为世界最强编程 Agent 之一。终端 CLI 是 Claude Code 的核心体验，你可以在任意终端中运行 `claude` 命令，通过自然语言与 AI 进行编程协作。

本文档主要介绍如何通过 AceData Cloud 的代理服务，在终端中安装、配置和使用 Claude Code CLI。

## 申请流程

要使用 Claude Code，首先可以到 [Claude Messages 服务页面](https://platform.acedata.cloud/documents/claude-messages) 点击「Acquire」按钮，获取请求所需要的凭证：

![](https://cdn.acedata.cloud/nyq0xz.png)

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 Claude Code 服务。

## 安装 Claude Code

### 系统要求

* macOS、Linux 或 Windows（含 WSL）
* Node.js 不是必须的，原生安装方式会自动处理依赖

### 安装方式

Claude Code 支持多种安装方式：

**方式一：原生安装（推荐）**

macOS / Linux / WSL：

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

Windows PowerShell：

```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```

Windows CMD：

```cmd theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

**方式二：Homebrew（macOS / Linux）**

```bash theme={null}
brew install claude-code
```

**方式三：WinGet（Windows）**

```cmd theme={null}
winget install Claude.ClaudeCode
```

原生安装会在后台自动更新，始终保持最新版本。

## 配置 AceData Cloud API

安装完成后，默认会要求你登录 Anthropic 官方账号。我们可以通过配置环境变量来使用 AceData Cloud 的代理 API，**无需官方订阅**。

### 配置环境变量

有两种方式配置环境变量，任选其一即可。

**方式一：在 Shell 配置文件中设置（推荐）**

将以下内容添加到你的 Shell 配置文件（`~/.zshrc`、`~/.bashrc` 或 `~/.bash_profile`）中，将 `{token}` 替换为你在 AceData Cloud 控制台获取的 API 令牌：

```bash theme={null}
# AceData Cloud - Claude Code 代理配置
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
```

修改后执行以下命令使配置生效：

```bash theme={null}
source ~/.zshrc  # 或 source ~/.bashrc
```

**方式二：在 Claude Code settings.json 中设置**

编辑 `~/.claude/settings.json`（如果不存在则创建），添加 `env` 配置：

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

这种方式的好处是环境变量只作用于 Claude Code，不影响其他程序。

> **提示**：API 令牌可在 [AceData Cloud 控制台](https://platform.acedata.cloud/console) 中查看。`ANTHROPIC_AUTH_TOKEN` 的值会被自动添加 `Bearer` 前缀发送到服务端。

## 开始使用

### 启动交互模式

打开终端，进入你的项目目录，然后运行：

```bash theme={null}
cd /path/to/your/project
claude
```

你会看到 Claude Code 的欢迎界面，直接输入自然语言即可开始交互。

### 常用命令

| 命令               | 说明          | 示例                   |
| ---------------- | ----------- | -------------------- |
| `claude`         | 启动交互模式      | `claude`             |
| `claude "任务"`    | 执行一次性任务     | `claude "修复构建错误"`    |
| `claude -p "查询"` | 执行查询后退出     | `claude -p "解释这个函数"` |
| `claude -c`      | 继续当前目录最近的对话 | `claude -c`          |
| `claude -r`      | 恢复之前的对话     | `claude -r`          |
| `claude commit`  | 创建 Git 提交   | `claude commit`      |

### 交互模式命令

在交互模式中，可以使用以下内置命令：

| 命令                | 功能        |
| ----------------- | --------- |
| `/help`           | 显示帮助信息    |
| `/clear`          | 清除对话历史    |
| `/config`         | 打开设置面板    |
| `/model`          | 切换模型      |
| `/mcp`            | 管理 MCP 服务 |
| `/compact`        | 压缩上下文     |
| `/memory`         | 管理记忆      |
| `/login`          | 切换账号      |
| `exit` 或 `Ctrl+C` | 退出        |

### 对话交互示例

```bash theme={null}
# 分析项目
> what does this project do?

# 修 Bug
> there's a bug where users can submit empty forms - fix it

# 编写测试
> write unit tests for the calculator functions

# 重构代码
> refactor the authentication module to use async/await

# Git 操作
> commit my changes with a descriptive message
> create a pr for this feature
```

## 高级用法

### 管道和脚本化

Claude Code 遵循 Unix 哲学，支持管道和脚本化操作：

```bash theme={null}
# 监控日志并自动报警
tail -f app.log | claude -p "如果发现异常就通知我"

# 自动翻译新增文本
claude -p "如果有新增的文本字符串，翻译成法语并创建 PR"

# 代码审查
git diff main | claude -p "审查这些改动"
```

### 环境变量参考

以下是 Claude Code 支持的常用环境变量：

| 变量                           | 说明                                    |
| ---------------------------- | ------------------------------------- |
| `ANTHROPIC_AUTH_TOKEN`       | 自定义 Authorization 头的值（自动添加 Bearer 前缀） |
| `ANTHROPIC_API_KEY`          | API 密钥（作为 X-Api-Key 头发送）              |
| `ANTHROPIC_BASE_URL`         | API 基础 URL                            |
| `ANTHROPIC_MODEL`            | 覆盖默认模型                                |
| `ANTHROPIC_SMALL_FAST_MODEL` | Haiku 级别模型（后台任务用）                     |
| `MAX_THINKING_TOKENS`        | 设置思考 Token 预算（设为 0 禁用思考模式）            |
| `DISABLE_COST_WARNINGS`      | 设为 1 禁用费用提醒                           |

### CLAUDE.md 项目记忆

在项目根目录创建 `CLAUDE.md` 文件，可以为 Claude Code 提供项目特定的指令和上下文。Claude 会在启动时自动加载这个文件。

```markdown theme={null}
# 项目说明
这是一个 Django + Vue.js 的全栈项目。

## 编码规范
- 使用 Python 3.12
- 遵循 PEP 8 代码风格
- 所有 API 需要写单元测试
```

## 常见问题

### 连接失败怎么办？

1. 檢查 `~/.claude/config.json` 文件是否正確創建，內容為 `{"primaryApiKey": "self"}`
2. 確認環境變量已正確設置：
   ```bash theme={null}
   echo $ANTHROPIC_AUTH_TOKEN
   echo $ANTHROPIC_BASE_URL
   ```
3. 確認 API 令牌有效（可在 [控制台](https://platform.acedata.cloud/console) 查看）
4. 嘗試重新啟動終端

### command not found: claude

如果安裝後提示 `command not found`，請嘗試：

1. 關閉並重新打開終端
2. 檢查 PATH：`echo $PATH`
3. 重新安裝：`curl -fsSL https://claude.ai/install.sh | bash`

### 如何查看剩余额度？

登錄 [AceData Cloud 控制台](https://platform.acedata.cloud/console)，即可查看當前賬戶的剩餘額度和使用情況。

## 了解更多

* 📖 [Claude Code CLI 官方文檔](https://code.claude.com/docs/en/quickstart)
* 📋 [CLI 命令參考](https://code.claude.com/docs/en/cli-reference)
* 🔧 [AceData Cloud Claude Code 服務](https://platform.acedata.cloud/documents/claude-messages)
* 💬 如有任何問題，歡迎通過平台客服與我們聯繫