跳轉到主要內容
Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具，也被称为世界最强编程 Agent 之一。终端 CLI 是 Claude Code 的核心体验，你可以在任意终端中运行 claude 命令，通过自然语言与 AI 进行编程协作。 本文档主要介绍如何通过 AceData Cloud 的代理服务，在终端中安装、配置和使用 Claude Code CLI。

​
申请流程

要使用 Claude Code，首先可以到 Claude Messages 服务页面 点击「Acquire」按钮，获取请求所需要的凭证： 如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送，可以免费体验 Claude Code 服务。

​
安装 Claude Code

​
系统要求

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

​
安装方式

Claude Code 支持多种安装方式： 方式一：原生安装（推荐） 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
方式二：Homebrew（macOS / Linux） 
brew install claude-code
方式三：WinGet（Windows） 
winget install Claude.ClaudeCode
原生安装会在后台自动更新，始终保持最新版本。

​
配置 AceData Cloud API

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

​
配置环境变量

有两种方式配置环境变量，任选其一即可。 方式一：在 Shell 配置文件中设置（推荐） 将以下内容添加到你的 Shell 配置文件（~/.zshrc、~/.bashrc 或 ~/.bash_profile）中，将 {token} 替换为你在 AceData Cloud 控制台获取的 API 令牌： 
# AceData Cloud - Claude Code 代理配置
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
修改后执行以下命令使配置生效： 
source ~/.zshrc  # 或 source ~/.bashrc
方式二：在 Claude Code settings.json 中设置 编辑 ~/.claude/settings.json（如果不存在则创建），添加 env 配置： 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
这种方式的好处是环境变量只作用于 Claude Code，不影响其他程序。
提示：API 令牌可在 AceData Cloud 控制台 中查看。ANTHROPIC_AUTH_TOKEN 的值会被自动添加 Bearer 前缀发送到服务端。

​
开始使用

​
启动交互模式

打开终端，进入你的项目目录，然后运行： 
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退出

​
对话交互示例

# 分析项目
> 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 哲学，支持管道和脚本化操作： 
# 监控日志并自动报警
tail -f app.log | claude -p "如果发现异常就通知我"

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

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

​
环境变量参考

以下是 Claude Code 支持的常用环境变量：
变量说明
ANTHROPIC_AUTH_TOKEN自定义 Authorization 头的值（自动添加 Bearer 前缀）
ANTHROPIC_API_KEYAPI 密钥（作为 X-Api-Key 头发送）
ANTHROPIC_BASE_URLAPI 基础 URL
ANTHROPIC_MODEL覆盖默认模型
ANTHROPIC_SMALL_FAST_MODELHaiku 级别模型（后台任务用）
MAX_THINKING_TOKENS设置思考 Token 预算（设为 0 禁用思考模式）
DISABLE_COST_WARNINGS设为 1 禁用费用提醒

​
CLAUDE.md 项目记忆

在项目根目录创建 CLAUDE.md 文件，可以为 Claude Code 提供项目特定的指令和上下文。Claude 会在启动时自动加载这个文件。 
# 项目说明
这是一个 Django + Vue.js 的全栈项目。

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

​
常见问题

​
连接失败怎么办？

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

​
command not found: claude

如果安裝後提示 command not found，請嘗試：
  1. 關閉並重新打開終端
  2. 檢查 PATH：echo $PATH
  3. 重新安裝：curl -fsSL https://claude.ai/install.sh | bash

​
如何查看剩余额度？

登錄 AceData Cloud 控制台，即可查看當前賬戶的剩餘額度和使用情況。

​
了解更多