跳转到主要内容

​
简短答案

Claude Code 是面向软件开发的 coding agent。它不是普通聊天页面，而是可以读取代码库、编辑文件、运行命令，并通过终端、IDE、桌面端或浏览器参与开发任务的工具。 Claude Code 的核心工作方式是：先读取你的项目上下文，再根据你的请求制定计划、调用工具、修改文件，并在需要时运行命令验证结果。它能处理多文件修改、测试修复、代码审查、脚本化任务和长周期开发工作。 你仍然要控制它能访问哪些目录、能运行哪些命令、是否允许自动执行。模型 API 只负责推理，Claude Code 的本地权限、工具调用和工作流边界仍由 Claude Code 自己控制。

​
什么时候需要理解它

  • 第一次安装 Claude Code，不确定它和 Claude 网页聊天有什么区别
  • 准备让 Claude Code 修改本地代码库
  • 想知道 Claude Code 为什么会读取文件、运行命令或消耗较多 token
  • 准备接入自定义 API Key 和 Base URL
  • 在 Claude Code、Claude Desktop、Cursor、Codex CLI 之间选择工具

​
核心概念

​
推荐工作流

  1. 在一个真实项目目录中启动 Claude Code。
  2. 让它先阅读相关文件，而不是直接要求它大范围改代码。
  3. 对复杂任务先进入计划阶段，确认范围后再执行。
  4. 让它修改小批量文件，然后运行最快的相关检查。
  5. 把长期稳定的项目规则写入 CLAUDE.md，把一次性要求留在当前对话里。
如果你要通过 API gateway 使用 Claude Code，先确认工具使用的是 Anthropic-compatible endpoint。这个文档站里的 Claude Code 接入页使用 https://www.bettertoken.ai，不要把 OpenAI-compatible 的 https://www.bettertoken.ai/v1 填进 Claude Code 的 Anthropic 协议配置里。

​
常见误区

  • 把 Claude Code 当作普通聊天网页，以为它不会触碰本地文件。
  • 以为 Claude Code 会自动理解整个仓库；实际上它需要读取相关文件或加载项目说明。
  • 把 MCP 当作模型 API。MCP 是工具和数据源层，不替代 API Key、Base URL 和 Model ID。
  • 把 Claude.ai 订阅、Claude Console API、第三方 API gateway 混在一起。它们是不同的认证和计费路径。
  • 放开所有本地权限，却没有代码审查、测试和命令执行边界。

​
关于 BetterToken

如果 Claude Code 使用自定义 API Key 和 Base URL，它可以通过 Anthropic-compatible API gateway 发送模型请求。BetterToken 属于模型 API 层，可以集中管理 API Key、余额和用量记录。 但 BetterToken 不替代 Claude Code 的本地权限系统、文件访问控制、hooks、MCP 配置或项目规则。你仍然需要在 Claude Code 里设置合理的执行边界。

​
References