跳转到正文

ClaudeCode Cli 配置教程 ​

Claude Code 的配置目录为 .claude,位于用户主目录下。请先完成 Node.js 配置,再按照下面步骤写入 Yuan API 配置。

一、打开配置目录 ​

请根据你的系统打开 .claude 目录:

text
按下 Win + R,输入:
%userprofile%\.claude
bash
open ~/.claude
bash
cd ~/.claude
# 如需图形界面,可使用:
xdg-open ~/.claude

如果 .claude 目录还不存在,可以先在终端运行一次 claude,让客户端自动创建;也可以手动创建该目录。

提示

不同 Claude Code 版本的配置文件行为可能会变化。如果你已经使用 CC-Switch,可以优先按 CC-Switch ClaudeCode 配置教程操作。

二、编辑 settings.json ​

在 .claude 目录下创建或打开 settings.json,写入:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://api.apixhm.com"
  }
}

Claude Code 使用 Yuan API 时,Base URL 不要添加 /v1。模型 ID 请从 Yuan API 模型与价格页面复制,例如:

text
claude-sonnet-4-5

保存后重新打开终端,运行:

bash
claude

发送 hi 或“你好”验证是否可以正常回复。

注意

如果启动时仍然要求登录,可能是旧 OAuth 状态或系统环境变量覆盖了 settings.json。请先查看Claude Code 专项问题。