安装与使用 Claude Code

在用 Codex 还是 Claude Code？里我分析了近年 AI 编程工具的演进，最终建议使用 Codex。但如果你还是想尝试一下 Claude Code 的话，可以按照本文的介绍进行安装和配置。

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，这篇文章讲解 Claude Code 的安装和配置。

在此之前，建议新手一定要先读一下 LLM 和 Agent 的核心术语和原理，否则会被很多名词搞晕。

正如 LLM 和 Agent 的核心术语和原理所讲，Claude Code 只是一个在命令行使用的 Agent 工具，它底层需要调用 LLM 模型来驱动。

Claude Code 是 Anthropic 这家公司开发的，所以默认使用的模型是自家的 Claude 模型。

Claude 模型又分 Sonnet 和 Opus 两个系列，可以理解为 Sonnet 是标准版，Opus 是专业版，Opus 的能力比 Sonnet 更强，但价格也贵不少。

对于同一系列的模型，还有版本号。比如目前最新的 Sonnet 模型是 Sonnet 4.6，最新的 Opus 模型是 Opus 4.7，一般我们默认用最新的版本就行。

但是 Claude 系列模型是目前价格最贵的模型，如果不是非常专业的用户，用这么贵的模型性价比很低，怎么办呢？

有办法，你可以在 Claude Code 里面用其他模型的，只要模型提供商适配 Claude Code 的 API 接口格式就行。所以你会看到很多国产模型都可以在 Claude Code 里面使用，以及本文后面会介绍如何在 Claude Code 里面使用 GPT 模型。

好，有了这些基本的概念，我们开始安装和使用。

安装

Claude Code 官方支持 macOS 13+、Ubuntu 20.04+ / Debian 10+、Windows 10 1809+ / 11。

根据你的操作系统，运行对应命令即可：

curl -fsSL https://claude.ai/install.sh | bash -s stable

如果你遇到 App unavailable in region 错误，或者下载很慢的话，可以换成 npm 安装。要求本机已经安装 Node.js 18+，然后执行以下命令安装：

npm install -g @anthropic-ai/claude-code

如果下载很慢，可以临时切换 npm 下载源：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

装完后验证：

claude --version

能打印出版本号就算装好了。

配置 Claude Code

默认情况下直接运行 claude 会引导你登录 Anthropic 官方账号，但官方订阅在中国很难搞，而且非常容易被封号。

一般的解决方案就是用中转站，中转站作为代理，帮你把请求转发到 Anthropic 官方接口，你只需要接入中转站的 API 就可以了：

我一直在用 aicode007.com 这个中转站，支持在 Claude Code 中使用满血的 Claude 模型，同时也支持在 Claude Code 中使用 GPT 模型（性价比更高），有需要的读者可以用用看。

不管用哪家中转站，配置思路都一样：通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个环境变量把请求转发到中转站的接口，就能正常使用了。

下面我就以 aicode007.com 为例，讲一下配置过程。

创建 API key

访问 https://aicode007.com/keys 页面，创建一个 apikey。

Claude 模型有多种渠道，不同渠道的优劣不同，网页上已经写得很清楚了，总的来说你只能在稳定性、价格、模型能力这几点上做取舍：

除了 Claude 模型，aicode007 还支持让你在 Claude Code 中使用 GPT 模型。GPT 模型性价比高，能力也不差，对大部分项目绰绰够用：

选择好你要用的模型（建议选择 GPT 模型），创建对应的 apikey 之后，把 apikey 秘钥（sk- 开头的那串字符）复制下来。

在终端里执行如下命令设置环境变量，并启动 claude 命令（把 sk-your-api-key 替换成你刚才复制的 apikey 秘钥）：

export ANTHROPIC_BASE_URL="https://api.aicode007.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="gpt-5.6-sol"
claude

其中 ANTHROPIC_MODEL 是给 GPT 模型渠道用的，作用是把默认模型指定为最强的 gpt-5.6-sol；如果你创建的是 Claude 模型渠道的 apikey，去掉这一行即可。

进入交互式页面后，输入 /status 查看当前配置，确保 Anthropic base URL 这一项是 https://api.aicode007.com：

/status 命令显示配置成功

如果 base URL 不对，说明环境变量没正确加载，请重新执行上面的命令。

如果一切正常，就可以和 Claude 愉快地对话了：

Claude Code CLI 使用示例

小技巧

使用 /model 命令可以切换模型。如果你用 GPT 模型的话，中转站会自动把 Claude 模型按档位映射为对应的 GPT 模型：Opus → gpt-5.6-sol、Sonnet → gpt-5.6-terra、Haiku → gpt-5.6-luna，你可以按需选择。

具体的请求明细和花费可以在用量页面查看。

上面通过环境变量配置的方式只在当前终端会话里生效，关掉窗口或者新开终端就没了，每次使用需要重新导入环境变量。如果嫌麻烦，下面介绍一种持久化的配置方式。

持久化配置

最推荐的持久化方式是写入 Claude Code 的 settings.json 文件。

Claude Code 启动时会读取 ~/.claude/settings.json 的 env 字段，Windows 对应 C:\Users\<你的用户名>\.claude\settings.json。

所以我们在 settings.json 文件里添加如下内容（文件不存在就新建，没有 env 字段就加上）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicode007.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "gpt-5.6-sol"
  }
}

注意，如果这个文件里已经有其他服务配置的 ANTHROPIC_BASE_URL 或 ANTHROPIC_AUTH_TOKEN，记得替换成中转站的配置，否则请求会发送到错误的服务。

这样配置之后，就可以不需要每次都 export / set 环境变量了，直接启动 claude 命令就能用。

接下来你可以看一下 Claude Code 的常用技巧，看看如何更高效地使用 Claude Code。

在 VSCode 里使用

以我个人的使用经验，CLI 才是最顺手的形态。在编辑器里用 Claude Code 的最简单方式，就是把编辑器内置终端调到右侧，直接在里面跑 claude，它能自动感知当前打开的文件作为上下文：

在 VSCode 终端里运行 Claude Code

这种方式不需要装任何插件，CLI 装好就能用，我强烈推荐这种方式。

如果你实在想要更集成的体验，比如用 UI 按钮触发会话、直接点击文件引用，Claude Code 也提供了 VSCode 和 JetBrains 插件。下面以 VSCode 为例讲一下配置。

安装 VSCode 插件

打开 VSCode，打开插件市场列表，搜索 Claude Code，找到 Anthropic 官方发布的那个（ID 是 anthropic.claude-code），点 Install 安装：

在 VSCode 扩展市场搜索并安装 Claude Code

装好之后 VSCode 侧边栏和右下角状态栏会出现 Claude Code 图标。

关闭官方登录提示

因为我们走的是中转站网关，不需要官方登录。

打开 VSCode 设置，搜索 claude code login，勾选 Disable Login Prompt 把默认的登录弹窗关掉：

关闭 VSCode Claude Code 插件的登录提示

配置中转站

继续在 VSCode 设置里搜索 claude-code.environmentVariables，点 Edit in settings.json，把下面这段加上：

{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-your-api-key"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.aicode007.com"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "gpt-5.6-sol"
    }
  ]
}

在 VSCode settings.json 中配置环境变量

保存后，完全退出并重新打开 VSCode 才能生效。这是个坑，很多人改完配置发现没用，就是因为没重启 VSCode。

开始使用

配置完成后，打开任意代码文件，点击编辑器右上角的 ✱ 图标可以打开 Claude 对话面板。

VSCode 侧边栏也会新增 Claude Code 图标，点开能看到对话框和历史会话列表：

VSCode 中使用 Claude Code 插件的效果

对话框里同样用 /model 命令切换模型：

VSCode 插件切换模型

接下来就可以和 Claude 对话了，让它帮你写代码、改bug、写文档等等。

Claude Code 的一些常用命令和技巧，可以参考 Claude Code 的常用技巧。

安装与使用 Claude Code

¶安装

¶配置 Claude Code

¶创建 API key

¶持久化配置

¶在 VSCode 里使用

¶安装 VSCode 插件

¶关闭官方登录提示

¶配置中转站

¶开始使用

安装