Claude Code Desktop 应用用户指南

xin35503
16 阅读5分钟

前言/背景

Claude Code 是由 Anthropic 推出的 Agentic Coding 工具，被誉为全球最强大的编程助手之一。Claude Code 的桌面应用程序提供了独立的图形界面，支持 Diff 评审、并行会话（通过 Git Worktree 隔离）和远程会话等功能，而无需依赖任何集成开发环境（IDE）。本文将重点介绍如何通过 AceData Cloud 的代理服务配置和使用 Claude Code 桌面应用程序。

注意：Claude Code 桌面应用程序目前处于预览阶段，仅支持 macOS 和 Windows。

应用流程

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

获取凭证

如果您尚未登录或注册，系统会自动重定向到登录页面，邀请您注册并登录。成功登录或注册后，您将自动返回到当前页面。

首次申请时，您将获得免费的配额，让您可以免费体验 Claude Code 服务。

安装桌面应用程序

系统要求

  • macOS（Intel 和 Apple Silicon）或 Windows（x64 / ARM64）
  • 目前不支持 Linux 桌面应用程序

下载和安装

请访问 Claude 官方下载页面 下载适合您平台的安装包：

  • macOS：下载 .dmg 文件并将其拖入应用程序文件夹
  • Windows x64：下载 .exe 安装包并按照提示进行安装
  • Windows ARM64：下载 ARM64 版本（注意：ARM64 不支持本地会话，需要远程会话）

Claude 桌面应用下载页面

安装完成后，从应用程序文件夹（macOS）或开始菜单（Windows）启动 Claude。

配置 AceData Cloud API

启动桌面应用程序后，您需要登录到您的 Anthropic 账户。您可以通过环境变量来配置 AceData Cloud 代理 API，无需官方订阅。

桌面应用程序会从您的 Shell 环境中读取环境变量，因此您需要在 Shell 配置文件中进行设置。

配置环境变量

macOS 用户

将以下内容添加到 ~/.zshrc（或 ~/.bashrc），将 {token} 替换为您的 API 令牌：

# AceData Cloud - Claude Code 代理配置
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

保存后，执行：

source ~/.zshrc

Windows 用户

通过“系统属性 → 高级 → 环境变量”添加以下系统环境变量：

变量名值
ANTHROPIC_AUTH_TOKEN{token}（替换为您的 API 令牌）
ANTHROPIC_BASE_URLhttps://api.acedata.cloud

或者使用 PowerShell：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "{token}", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.acedata.cloud", "User")

您也可以通过 settings.json 配置

编辑 ~/.claude/settings.json（如果不存在则创建）：

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

提示：API 令牌可以在 AceData Cloud 控制台 中查看。配置完成后，您需要 重启桌面应用程序 以使环境变量生效。

基本使用

打开项目

  1. 启动 Claude 桌面应用程序
  2. 点击顶部的 代码 标签
  3. 选择 本地 运行模式
  4. 点击 选择文件夹 以选择您的项目目录

开始对话

在输入框中输入您需求的自然语言描述：

  • “查找 TODO 注释并修复”
  • “为主函数添加测试”
  • “解释该项目的架构”

Claude 将分析您的代码库，提出修改计划，并在 Diff 视图中显示更改。

权限模式

使用发送按钮旁边的模式选择器进行切换：

模式描述
询问在每次修改前请求确认（推荐给初学者）
代码自动接受文件编辑，但终端命令仍需确认
计划制定详细计划并在执行前等待批准

并行会话

点击侧边栏中的 + 新会话 开始多个并行会话。对于 Git 仓库，每个会话将通过 Worktree 获取独立的项目副本，不会相互干扰。

Worktree 默认存储在 ~/.claude-worktrees/ 目录中。

Diff 评审

当 Claude 修改文件时，会显示更改统计信息（例如 +12 -1），点击后将打开 Diff 查看器以逐文件审核修改。您还可以点击特定代码行添加评论，Claude 会根据您的反馈进行调整。

连接外部工具

在开始会话之前，点击 ⋯ 按钮并选择 连接器 来添加外部集成：

  • Google 日历
  • Slack
  • GitHub
  • Linear
  • Notion
  • 更多...

连接后，Claude 可以直接读取日历、发送消息、创建问题等。

CLI 关系

桌面应用程序和 CLI 使用相同的底层引擎，并共享以下配置：

  • CLAUDE.md / CLAUDE.local.md 项目记忆文件
  • ~/.claude.json / .mcp.json MCP 服务器配置
  • ~/.claude/settings.json 设置
  • Hooks 和 Skills 配置

两者可以在同一项目中同时运行，并保持独立的会话历史。

常见问题

连接失败该怎么办？

  1. 检查 ~/.claude/config.json 文件是否正确创建
  2. 确认环境变量是否正确设置（重启桌面应用程序以使其生效）
  3. 确认 API 令牌是否有效（可在 控制台 查看）
  4. 如果使用 settings.json 配置环境变量，请确保文件格式正确

安装的工具找不到怎么办？

如果 Claude 找不到 npm、node 等命令：

  1. 确认这些工具在常规终端中正常工作
  2. 检查您的 Shell 配置文件（~/.zshrc、~/.bashrc）以确保 PATH 设置正确
  3. 重启桌面应用程序以重新加载环境变量

如何查看剩余配额？

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

总结

Claude Code 桌面应用程序为开发者提供了强大的代码分析和修改能力，通过 AceData Cloud 的代理服务，用户可以便捷地进行多种操作。掌握这些基础使用方法，您将能更高效地进行开发工作。

技术标签：#ClaudeCode #AceDataCloud #开发工具 #代码评审 #编程助手

avatar
文章
阅读
粉丝