2.1 安装 Claude Code#

前提条件：

• 安装 【Node.js 18 或更新版本环境】。
• Windows 用户需安装 【Git for Windows】。 在命令行界面，执行以下命令安装 Claude Code。

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

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

1
claude --version

2.2 配置工具#

完成 Claude Code 安装后，配置以下信息：

• ANTHROPIC_BASE_URL：https://ark.cn-beijing.volces.com/api/coding
• ANTHROPIC_AUTH_TOKEN：【获取API Key】
• ANTHROPIC_MODEL: ark-code-latest

自 Claude Code v2.0.7x 起，环境变量的加载逻辑发生变化。首次登录或执行 logout 后重新登录时，~/.claude/settings.json 中的 env 配置可能不会生效，推荐将环境变量写入 Shell 启动配置文件中。

2.2.1 macOS & Linux#

1. 在终端执行以下命令查看当前使用的 Shell 类型。

   1
   echo $SHELL
   

2. 根据 Shell 类型配置环境变量。

   1
   # SHELL 类型为 zsh，执行以下命令。
   2
   nano ~/.zshrc
   3
   # SHELL 类型为 bash，执行以下命令。
   4
   nano ~/.bashrc
   

   在文件末尾追加以下内容，将 <ARK_API_KEY> 替换为你的方舟 API Key，保存并退出：

   1
   export ANTHROPIC_BASE_URL=\"https://ark.cn-beijing.volces.com/api/coding\"
   2
   export ANTHROPIC_AUTH_TOKEN=\"<ARK_API_KEY>\"
   3
   export ANTHROPIC_MODEL=\"ark-code-latest\"
   4
   
   5
   export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=\"1\"
   6
   
   7
   # Avoid conflicts with local Anthropic configuration
   8
   export ANTHROPIC_API_KEY=\"\"
   

3. 在终端执行以下命令，使配置生效。

   1
   # SHELL 类型为 zsh，执行以下命令。
   2
   source ~/.zshrc
   3
   # SHELL 类型为 bash，执行以下命令。
   4
   source ~/.bashrc
   

4. 在终端执行以下命令验证环境变量是否生效。

   1
   echo $ANTHROPIC_BASE_URL
   2
   echo $ANTHROPIC_MODEL
   

2.2.2 Windows#

CMD#

1. 在CMD中执行以下命令，设置环境变量。

   1
   setx ANTHROPIC_AUTH_TOKEN ARK_API_KEY
   2
   setx ANTHROPIC_BASE_URL https://ark.cn-beijing.volces.com/api/coding
   3
   setx ANTHROPIC_MODEL ark-code-latest
   

2. 在新的CMD窗口执行以下命令，检查环境变量是否生效。

   1
   echo %ANTHROPIC_AUTH_TOKEN%
   2
   echo %ANTHROPIC_BASE_URL%
   3
   echo %CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC%
   4
   echo %ANTHROPIC_MODEL%
   

PowerShell#

1. 在PowerShell中执行以下命令，设置环境变量。

   1
   [System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'ARK_API_KEY', 'User')
   2
   [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://ark.cn-beijing.volces.com/api/coding', 'User')
   3
   [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'ark-code-latest', 'User')
   

2. 在新的PowerShell窗口执行以下命令，检查环境变量是否生效。

   1
   echo $env:ANTHROPIC_AUTH_TOKEN
   2
   echo $env:ANTHROPIC_BASE_URL
   3
   echo $env:ANTHROPIC_MODEL
   

2.3 切换模型#

1. 在【开通管理页面】选择要使用的模型，切换后 3-5 分钟即可生效。可选：Kimi-K2.5、GLM 4.7、Deepseek v3.2、Kimi-k2-thinking。
2. 在命令行窗口启动 Claude Code 后，输入 /status 确认模型状态。

2.4 使用 Claude Code#

• 启动 Claude Code：进入项目目录，执行 claude 命令即可开始使用。

  1
  cd my-project
  2
  claude
  

• 模型状态验证：输入 /status 确认模型状态。

如果提示以下错误，可能是之前已登录过 Claude Code，输入 /logout 退出登录后重新启动即可。

1
{
2
    "error": {
3
        "code": "AuthenticationError",
4
        "message": "The API key format is incorrect. Request id:0217xxxxxxx",
5
        "param": "",
6
        "type": "Unauthorized"
7
    }
8
}