Claude Code Terminal (CLI) 用户指南

用户00045392116
8 阅读5分钟

Claude Code 是由 Anthropic 推出的 Agentic Coding 工具，被称为全球最强大的编程代理之一。Claude Code 的终端 CLI 是其核心体验，用户可以在任何终端中运行 claude 命令，通过自然语言与 AI 进行编程协作。本文将详细介绍如何通过 AceData Cloud 代理服务在终端中安装、配置和使用 Claude Code CLI。

背景

Ace Data Cloud 是一个为开发者提供强大 API 和服务的平台，Claude Code 则是其中一个重要的编程工具。通过这个工具，开发者可以实现代码的自动化生成、调试和优化等功能，大大提高开发效率。

申请使用 Claude Code

要使用 Claude Code，首先访问 Claude Messages 服务页面，点击“获取”按钮以获取请求所需的凭证：

获取凭证

如果您尚未登录或注册，将自动重定向到登录页面。在登录或注册后，您将自动返回到当前页面。首次申请者可以享受免费配额，体验 Claude Code 服务。

安装 Claude Code

系统要求

  • 支持 macOS、Linux 或 Windows（包括 WSL）
  • Node.js 不是必需的，原生安装方式将自动处理依赖

安装方法

Claude Code 支持多种安装方法：

方法 1：原生安装（推荐）

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

方法 2：通过 Homebrew （macOS / Linux）

brew install claude-code

方法 3：通过 WinGet （Windows）

winget install Claude.ClaudeCode

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

配置 AceData Cloud API

安装完成后，默认会提示您登录 Anthropic 官方账户。我们可以使用环境变量配置 AceData Cloud 代理 API，无需官方订阅。

配置环境变量

有两种方式可以配置环境变量，您可以选择其中一种。

方法 1：在 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

方法 2：在 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 "task"执行一次性任务claude "修复构建错误"
claude -p "query"执行查询并退出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退出

交互示例

# 分析项目
> 这个项目是做什么的？

# 修复 Bug
> 用户可以提交空表单 - 修复它

# 编写测试
> 为计算器函数编写单元测试

# 重构代码
> 将认证模块重构为使用 async/await

# Git 操作
> 提交我的更改并附上描述信息
> 为这个功能创建一个 PR

高级用法

管道与脚本

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

# 监控日志并自动报警
tail -f app.log | claude -p "如果检测到异常，请通知我"

# 自动翻译新文本
claude -p "将任何新文本字符串翻译为法语并创建 PR"

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

环境变量参考

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

变量描述
ANTHROPIC_AUTH_TOKEN自定义授权头的值（自动添加 Bearer 前缀）
ANTHROPIC_API_KEYAPI 密钥（作为 X-Api-Key 头发送）
ANTHROPIC_BASE_URLAPI 基础 URL
ANTHROPIC_MODEL覆盖默认模型
ANTHROPIC_SMALL_FAST_MODELHaiku 级别模型（用于后台任务）
MAX_THINKING_TOKENS设置思考令牌预算（设置为 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. 尝试重启终端

命令未找到：claude

如果安装后出现 command not found，请尝试：

  1. 关闭并重新打开终端
  2. 检查 PATH：echo $PATH
  3. 重新安装：curl -fsSL https://claude.ai/install.sh | bash

如何查看剩余配额？

登录 AceData Cloud 控制台 查看当前账户的剩余配额和使用情况。

总结

Claude Code CLI

avatar
文章
阅读
粉丝