文章总结： 本文介绍如何通过AceDataCloud代理服务在本地终端安装配置ClaudeCodeCLI，包括申请APIToken流程、原生与npm两种安装方式、环境变量配置方法、验证步骤及工作原理。文档提供了具体的操作命令和配置示例，指导用户完成代理服务切换并开始使用ClaudeCode进行代码阅读、文件修改等开发任务。 综合评分： 72 文章分类： 安全工具,技术标准,解决方案

Claude Code 终端使用教程

进击的Coder

2026年6月9日 14:31 江苏

在小说阅读器读本章

去阅读

Claude Code 是 Anthropic 推出的编程 Agent。除了 VS Code 扩展，它也提供了终端 CLI，你可以在任意项目目录中运行 claude，让它阅读代码、修改文件、运行命令、解释错误并协助完成开发任务。

本文介绍如何通过 Ace Data Cloud 的 Claude Code 代理服务，在本地终端中安装、配置和使用 Claude Code CLI。配置完成后，Claude Code 会把请求发送到 https://api.acedata.cloud，无需单独订阅 Anthropic 官方账号。

申请流程

要使用 Claude Code，首先可以到 Ace Data Cloud 控制台，或者识别下方二维码：

然后获取您的 API Token，留作备用。

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

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

安装 Claude Code

Claude Code 支持 macOS、Linux、Windows 和 WSL。你可以使用官方原生安装方式，也可以通过 npm 安装。

原生安装（推荐）

官方原生安装方式会安装 claude 命令，并自动处理后续更新。

macOS、Linux、WSL 可以运行：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell 可以运行：

irm https://claude.ai/install.ps1 | iex

Windows CMD 可以运行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

npm 安装

如果你已经安装了 Node.js，也可以通过 npm 安装 Claude Code。该方式要求 Node.js 18 或更高版本。

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

检查安装

安装完成后，重新打开终端，然后检查命令是否可用：

claude --version

如果提示 command not found，通常是当前终端还没有加载新的 PATH。请关闭并重新打开终端，或检查安装脚本输出中提示的 PATH 配置。

配置

安装完成后，Claude Code 默认会尝试连接 Anthropic 官方服务。要改用 Ace Data Cloud，需要配置 Claude Code 使用我们的代理地址和您刚才获取的 API Token。

方式一：Shell 配置文件

推荐把配置写入 Shell 配置文件，例如 ~/.zshrc、~/.bashrc 或 ~/.bash_profile：

export ACEDATACLOUD_API_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
export ANTHROPIC_AUTH_TOKEN="$ACEDATACLOUD_API_TOKEN"

其中 {token} 替换为您在 Ace Data Cloud 控制台复制的 API Token。

配置后重新打开终端，或执行对应的 source 命令让配置立即生效：

source ~/.zshrc

这种方式适合希望所有项目都默认使用 Ace Data Cloud 的场景。

方式二：项目 Settings 文件

如果你只想让某一个项目使用 Ace Data Cloud，也可以在项目根目录创建 .claude/settings.local.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud",
  }
}

这种方式只对当前项目生效。它同时适用于终端 CLI 和 Claude Code 的 VS Code 扩展：你在 VS Code 中打开同一个项目后，扩展也会读取这份项目级配置。

建议把 .claude/settings.local.json 加入 .gitignore，避免把个人 Token 提交到远程仓库。配置完成后，请重新打开终端；如果是在 VS Code 中使用，也请重启或重新加载 VS Code。

“

注意：ANTHROPIC_API_KEY 建议显式设置为空字符串，避免 Claude Code 读取到旧的 Anthropic 官方 Key 后产生认证冲突。

清理已缓存的 Anthropic 登录

如果你之前已经用 Anthropic 官方账号登录过 Claude Code，本地可能缓存了官方登录状态。切换到 Ace Data Cloud 代理前，建议先清理一次旧登录。

启动 Claude Code：

claude

在 Claude Code 交互界面中输入：

/logout

退出 Claude Code 后重新打开终端，再次运行 claude。如果你从未登录过 Anthropic 官方账号，可以跳过这一步。

启动会话

进入你的项目目录，然后启动 Claude Code：

cd /path/to/your/project
claude

看到 Claude Code 的交互界面后，就可以直接输入需求，例如：

解释这个项目的目录结构

也可以用一次性命令让 Claude Code 完成单个任务：

claude "帮我检查最近的 git diff，找出可能的 bug"

如果希望 Claude Code 输出结果后直接退出，可以使用 -p：

claude -p "总结 README.md 的作用"

验证配置

进入 Claude Code 后，可以输入 /status 检查当前连接配置：

/status

你应该能看到类似信息：

Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.acedata.cloud

如图所示：

如果 Anthropic base URL 不是 https://api.acedata.cloud，说明当前终端没有读取到正确配置。请检查 Shell 配置文件是否保存成功，并重新打开终端。

你也可以通过 Ace Data Cloud 控制台 – 使用历史 查看请求记录和扣费详情，通过 Ace Data Cloud 控制台 – 应用列表 查看剩余额度。

工作原理

Claude Code 原生使用 Anthropic Messages API 协议。Ace Data Cloud 在 https://api.acedata.cloud 提供兼容 Anthropic API 的代理服务，因此 Claude Code 不需要本地代理程序，也不需要额外插件。

工作流程如下：

1. Claude Code 从环境变量或 .claude/settings.local.json 读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。
2. 当 ANTHROPIC_BASE_URL 指向 https://api.acedata.cloud 时，请求会直接发送到 Ace Data Cloud。
3. Ace Data Cloud 使用您的 API Token 验证身份、检查额度，并把请求转发到可用的 Claude Code 服务通道。
4. 请求完成后，平台根据实际使用量记录用量并扣减额度。

这意味着你仍然使用原版 claude 命令和 Claude Code 的原生交互体验，只是把底层 API 服务切换为 Ace Data Cloud。

配置模型

Claude Code 会根据任务类型选择不同级别的模型。你也可以通过环境变量指定默认模型。

例如，可以在 Shell 配置文件中加入：

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"

常用变量说明如下：

| 变量 | 作用 | | — | — | | ANTHROPIC_DEFAULT_OPUS_MODEL | 用于复杂推理、规划和高难度编码任务的模型 | | ANTHROPIC_DEFAULT_SONNET_MODEL | 用于日常编码、阅读代码和常规修改任务的模型 | | ANTHROPIC_DEFAULT_HAIKU_MODEL | 用于较快、较轻量任务的模型 | | CLAUDE_CODE_SUBAGENT_MODEL | Claude Code 创建子 Agent 时使用的模型 |

如果不确定该怎么选，可以先不配置这些模型变量，直接使用 Claude Code 默认选择。后续如果你希望固定使用某个模型，再根据 Ace Data Cloud Claude 服务文档 中支持的模型名称进行配置。

“

注意：Claude Code 对 Claude 系列模型兼容性最好。建议优先使用 Ace Data Cloud 提供的 Claude 模型，不建议随意切换到非 Claude 模型。

了解更多

• Claude Code CLI 官方文档
• CLI 命令参考
• Ace Data Cloud Claude Code 服务

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：进击的Coder 《Claude Code 终端使用教程》