Claude Code 使用教程

Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具，也被称为世界最强编程 Agent 之一。它能够直接在终端、IDE、桌面应用或浏览器中与你的代码库交互，帮助你更快地将想法变为代码。

本文档提供 Claude Code 各平台使用教程的总览，以及通过 AceData Cloud 代理服务接入的通用配置说明。

申请流程

要使用 Claude Code，首先可以到 Claude Messages 服务页面点击「Acquire」按钮，获取请求所需要的凭证：

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

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

支持的平台

Claude Code 可以在多种开发环境中使用，请根据你的使用场景选择对应的教程：

平台	说明	教程链接
终端 (CLI)	核心体验，在任意终端运行 `claude` 即可开始	终端使用教程
VS Code	原生扩展，支持内联 Diff、@-mentions、计划审查	VS Code 使用教程
JetBrains IDE	支持 IntelliJ IDEA、PyCharm、WebStorm 等	JetBrains 使用教程
桌面应用	独立应用，支持 Diff 审查和并行会话	桌面应用使用教程
GitHub Actions	用 `@claude` 自动化代码审查和 Issue 处理	GitHub Actions 使用教程

通用配置说明

无论你使用哪种平台，通过 AceData Cloud 代理接入都需要配置以下两个核心环节：

1. 创建 config.json

创建 Claude Code 的配置文件，告诉 Claude Code 使用自定义 API 密钥：

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

文件内容：

1
2
3

{
  "primaryApiKey": "self"
}

macOS / Linux 快速创建：

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

2. 配置环境变量

需要设置两个关键环境变量，将 {token} 替换为你在 AceData Cloud 控制台获取的 API 令牌：

变量	值	说明
`ANTHROPIC_AUTH_TOKEN`	`{token}`	你的 API 令牌（会自动添加 Bearer 前缀）
`ANTHROPIC_BASE_URL`	`https://api.acedata.cloud`	AceData Cloud 代理端点

不同平台的配置方式如下：

终端 / JetBrains / 桌面应用 — 在 Shell 配置文件中设置：

1
2
3

# 添加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

或者在 ~/.claude/settings.json 中设置：

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

VS Code — 在 VS Code settings.json 中设置：

{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "{token}"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.acedata.cloud"
    }
  ]
}

GitHub Actions — 在 Workflow 的 env 或仓库 Secret 中设置：

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    env:
      ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

提示：API 令牌可在 AceData Cloud 控制台中查看。

常见问题

连接失败怎么办？

检查 ~/.claude/config.json 文件是否正确创建，内容为 {"primaryApiKey": "self"}
确认环境变量 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 已正确配置
确认 API 令牌有效（可在控制台查看）
重启对应的应用或终端后重试

如何查看剩余额度？

了解更多

📖 Claude Code 官方文档
🏠 Claude Code 产品页面
🔧 AceData Cloud Claude Code 服务
💬 如有任何问题，欢迎通过平台客服联系我们