Claude Code 终端 (CLI) 使用教程

无头gui
0 阅读5分钟

Claude Code 终端 (CLI) 使用教程

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，无需官方订阅。

步骤一：创建 config.json

首先需要创建 Claude Code 的配置文件 config.json：

系统路径
macOS / Linux~/.claude/config.json
WindowsC:\Users\{用户名}\.claude\config.json

在该文件中写入以下内容并保存：

{
  "primaryApiKey": "self"
}

你可以使用以下命令快速创建（macOS / Linux）：

mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json

步骤二：配置环境变量

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

方式一：在 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 控制台，即可查看当前账户的剩余额度和使用情况。

了解更多

avatar
文章
阅读
粉丝