Claude Code CLI 配置指南

最近更新：2026 年 10 月 17 日（Asia/Shanghai）

关联：帮助中心 · VS Code / Cursor · 大模型 API

适用：在终端使用 Anthropic Claude Code 做 Agentic 编程，并把请求转到词源探索。

配置要点

项	值
Node.js	≥ 18（建议 LTS）
Base URL	https://ai.afp.net（不要加 /v1）
推荐模型	claude-sonnet-4-6（日常）；复杂任务可用 claude-opus-4-8
快速模型	claude-haiku-4-5

---

1. 环境准备

node --version   # 应 ≥ v18
# 若过低，可用 nvm：
# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# nvm install --lts && nvm use --lts

Windows 可用 winget install OpenJS.NodeJS.LTS 或 nvm-windows。

---

2. 获取令牌

在控制台「令牌管理」创建令牌（名称如 claude-code），复制 sk- 密钥。建议单独令牌并设额度上限。

---

3. 安装

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

---

4. 写入配置

编辑（不存在则新建）~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.afp.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": true
}

说明：

• ANTHROPIC_BASE_URL：词源探索根地址，无 /v1
• ANTHROPIC_AUTH_TOKEN：你的 sk- 令牌（部分版本也认 ANTHROPIC_API_KEY）
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1：减少非必要遥测流量
• alwaysThinkingEnabled：默认开启思考（更吃 token，按预算开关）

可选：若存在 ~/.claude.json，可设置 "hasCompletedOnboarding": true 跳过引导；已有文件时只增改字段，勿整文件覆盖。

也可用环境变量临时生效：

export ANTHROPIC_BASE_URL="https://ai.afp.net"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"

---

5. 验证

cd /path/to/your/project
claude
# 会话内可用 /model 切换，例如 claude-opus-4-8

或：

claude -p "用一句话介绍当前目录是做什么的"

---

6. 故障排查

现象	处理
连不上 / 404	Base URL 是否多了 /v1；改完后重启终端
invalid beta flag	增加 "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
Node 版本过低	升到 18+ 后重装 CLI
权限错误	避免随意 sudo npm；配置用户级 npm 全局目录
额度不足	控制台查余额与令牌额度
模型不存在	用 /v1/models 核对 ID，检查令牌分组

可用 Claude 模型见 帮助中心。

---

返回：帮助中心