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 12+、Ubuntu 20.04+ / Debian 10+、Windows 10 / 11。
根据你的操作系统,运行对应命令:
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
装完后验证:
claude --version
能打印出版本号就算装好了。
配置 Claude Code
默认情况下直接运行 claude 会引导你登录 Anthropic 官方账号,但官方订阅在中国很难搞,而且非常容易被封号。
一般的解决方案就是用中转站,中转站作为代理,帮你把请求转发到 Anthropic 官方接口,网络和封号的问题都由中转站解决,你只需要接入中转站的 API 就可以了:
中转站海鲜市场有很多

不管用哪家中转站,配置思路都一样:通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个环境变量把请求转发到中转站的接口,就能正常使用了。
创建 API key
访问中转站创建一个 apikey。获得key和BaseURL以我的中转站为例子


Claude 模型有多种渠道,不同渠道的优劣不同,
选择好你要用的模型(建议选择 GPT 模型),创建对应的 apikey 之后,把 apikey 秘钥(sk- 开头的那串字符)复制下来。
在终端里执行如下命令设置环境变量,并启动 claude 命令(把 sk-your-api-key 替换成你刚才复制的 apikey 秘钥):
Windows CMD
set ANTHROPIC_BASE_URL=https://api.aicode007.co
set ANTHROPIC_AUTH_TOKEN=sk-your-api-key
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.aicode007.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
claude
进入交互式页面后,输入 /status 查看当前配置,确保 Anthropic base URL 这一项是 https://api.aicode007.com:

如果 base URL 不对,说明环境变量没正确加载,请重新执行上面的命令。
如果一切正常,就可以和 Claude 愉快地对话了:

使用 /model 命令可以切换模型,不过建议保持默认的 Sonnet 4.6 就可以。
上面通过环境变量配置的方式只在当前终端会话里生效,关掉窗口或者新开终端就没了,每次使用需要重新导入环境变量。如果嫌麻烦,下面介绍一种持久化的配置方式。
持久化配置
最推荐的持久化方式是写入 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"
}
}
这样配置之后,就可以不需要每次都 export / set 环境变量了,直接启动 claude 命令就能用。
在真正发起请求前,通常需要准备三类核心信息:
| 参数 | 说明 |
|---|---|
api_key | 访问模型服务时的身份凭证 |
base_url | 模型服务接口的基础地址 |
model | 具体要调用的模型名称 |
只要有这三个核心信息就能在各种图形化界面或者插件中调用大模型了