手动配置

← Claude Code 概览 · 配置成功后如何验证手动配置需要先安装 Claude Code CLI，再写入以下配置项：

ANTHROPIC_BASE_URL：https://api.nonelinear.com.cn/anthropic
ANTHROPIC_AUTH_TOKEN：从 NoneLinear 官网获取 API Key
ANTHROPIC_MODEL：按需选择模型，可在模型列表查看可用模型

安装 Claude Code

使用 npm 安装需要 Node.js 18 或更高版本。在命令行界面执行：

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

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功：

claude --version

macOS 和 Linux 手动配置

在终端执行以下命令打开 Claude Code 配置文件（也可以用任意文本编辑器打开该文件）：

vim ~/.claude/settings.json

编辑配置文件，文件内容如下。请将 你的 NoneLinear API Key 替换为实际 API Key。如果文件里已经有 env，不要新建第二个 env，把下面的配置项追加到现有 env 对象里即可。

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "你的 NoneLinear API Key",
        "ANTHROPIC_BASE_URL": "https://api.nonelinear.com.cn/anthropic",
        "ANTHROPIC_MODEL": "gpt-5.5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro",
        "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
    }
}

然后重新打开终端窗口，配置才能生效。启动 Claude Code：进入项目目录，执行 claude 命令，即可开始使用。下面的 your_project 需要替换为你的项目路径。

cd your_project
claude

Linux 多用户与权限注意事项在多用户共享的 Linux 服务器上，或者存在 root 账户交替操作时，请注意以下两点，避免配置失效或启动时报错：

避免使用 sudo 启动或配置 Claude Code：使用 sudo 可能会将 ~/.claude 目录的所有权变更为 root，导致普通用户无法读取配置。若配置未生效，可以执行：

sudo chown -R $USER:$USER ~/.claude

共享临时沙箱冲突：若因其他用户或 root 优先启动，导致出现 /tmp/claude 权限不足报错，可以清理 Claude Code 的临时沙箱目录：

sudo rm -rf /tmp/claude

Windows 手动配置

在 Windows 系统下长期开发，可以使用 setx 写入用户环境变量。以下命令在 CMD 中执行。请将下方的 你的 NoneLinear API Key 替换为实际 API Key。写入 ANTHROPIC_AUTH_TOKEN 时，需要用英文双引号包裹，避免 API Key 中的特殊字符被 CMD 解析或截断。模型 ID 同样建议用英文双引号包裹。

setx ANTHROPIC_AUTH_TOKEN "你的 NoneLinear API Key"
setx ANTHROPIC_BASE_URL "https://api.nonelinear.com.cn/anthropic"
setx ANTHROPIC_MODEL "gpt-5.5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "gpt-5.5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-4.8"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "deepseek-v4-pro"
setx CLAUDE_CODE_ATTRIBUTION_HEADER "0"

setx 更改后，必须关闭当前 CMD（或 Git CMD）窗口，重新打开一个新窗口，新的值才会生效。在新窗口中执行以下命令检查环境变量是否生效：

if defined ANTHROPIC_AUTH_TOKEN (echo Token is configured) else (echo Token is missing)
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

启动 Claude Code：进入项目目录，执行 claude 命令，即可开始使用。下面的 your_project 需要替换为你的项目路径。

cd your_project
claude

工具目录

编程工具

办公与 Agent

聊天客户端

工作流

官方 Skills

安装 Claude Code

macOS 和 Linux 手动配置

Windows 手动配置

​安装 Claude Code

​macOS 和 Linux 手动配置

​Windows 手动配置

安装 Claude Code

macOS 和 Linux 手动配置

Windows 手动配置