安装node.js

https://nodejs.cn/download/

前提条件：
在命令行界面，执行以下命令安装 Claude Code。

打开nodejs命令对话框，

执行以下命令安装 Claude Code。

 

安装claude

npm install -g @anthropic-ai/claude-code
 
安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。
 
claude --version

配置工具

完成Claude Code安装后，配置以下信息。
  • ANTHROPIC_BASE_URL：https://ark.cn-beijing.volces.com/api/coding
  • ANTHROPIC_MODEL: 支持配置ark-code-latest、配置 Model Name 两种方式，具体见核心配置。
配置步骤如下：
  1. 编辑或新增 settings.json 文件，需要替换配置信息中的、。
说明
不同系统配置文件路径不同，具体如下：
  • MacOS & Linux：~/.claude/settings.json
  • Windows：C:\Users\<用户名>\.claude\settings.json

 

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
"ANTHROPIC_MODEL": ""
}
}
 
  1. 编辑或新增 .claude.json 文件，修改或新增 hasCompletedOnboarding 字段值为 true。
    说明
    不同系统配置文件路径不同，具体如下：
    • MacOS & Linux：~/.claude.json
    • Windows：C:\Users\<用户名>\.claude.json
    {
    "hasCompletedOnboarding": true
    }
保存配置文件后，在新的终端窗口执行后续命令。

切换模型

请根据模型配置方式，选择对应的模型切换方案。
配置方式
配置ark-code-latest
配置 Model Name
切换模型操作
  1. 在开通管理页面选择要使用的模型，切换后3-5分钟即可生效。
  1. 在命令行窗口，启动 Claude Code 后，输入/status确认模型状态。
  • 启动时：执行claude --model ，可指定对应的模型。
  • 对话期间：执行/model 切换模型。

使用 Claude Code

  • 启动Claude Code：进入项目目录，执行claude命令，即可开始使用Claude Code。
    cd my-project
    claude
启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。
  • 模型状态验证：输入/status确认模型状态。

关于接入 AI 编程工具

Claude Code 如何开启深度思考模式？

启动 Claude Code 后，输入/config，将 Thinking mode 调整为 true。

OpenCode 如何开启深度思考模式？

  1. 编辑 OpenCode 的配置文件~/.config/opencode/opencode.json，在模型配置中新增options配置，内容为{"thinking": {"type": "enabled"}}。参考示例如下：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "volcengine",
"options": {
"baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3",
"apiKey": ""
},
"models": {
"": {
"name": "",
"options": {
"thinking": {
"type": "enabled"
}
}
}
}
}
}
}
 

配置完成后执行命令opencode重新启动。如果在对话时仍看不到Thinking信息，可以在输入框按ctrl+p，搜索think，选中Show thinking，则可以查看思考的信息。

 

OpenClaw 如何开启深度思考模式？

OpenClaw 支持以下几种方式开启深度思考模式：
说明
OpenClaw 支持设置的深度思考 level：off、minimal、low、medium、high、xhigh。具体参见 Thinking Levels。
 
  1. 在当前消息临时开启深度思考模式
在消息前面添加内联指令：/think: 或/t ，示例如下：
 
/think:high 你的问题
# 或者使用简写模式
/t high 你的问题
  1. 在会话级别开启深度思考模式
单独发送一条指令消息：/think: 或/t ，示例如下：
/think:high
# 或者使用简写模式
/t high
  1. 全局配置开启深度思考模式
使用 config 命令修改全局配置：openclaw config set agents.defaults.thinkingDefault ，示例如下：
openclaw config set agents.defaults.thinkingDefault high
# 重启 gateway 才能生效
openclaw gateway restart
# 查看配置是否生效
openclaw config get agents.defaults.thinkingDefault
 

使用 OpenClaw 时，出现不支持 developer role 的报错，如何解决？

问题描述
在 OpenClaw Chat 中发送消息后没有响应，错误信息如下：
HTTP 400: The parameter messages.role specified in the request are not valid:
invalid value: developer, supported values are: system, assistant, user, tool.
 
问题原因
API 兼容性问题：方舟 API 不支持 developer role（OpenAI 新版 API 格式）。
解决方案
  1. 在 model 对象内部添加 compat 兼容性配置 "compat": { "supportsDeveloperRole": false }，示例如下：
说明
compat 配置必须放在 model 级别，不能放在 provider 级别，否则会报 Unrecognized key: "compat"错误。
 
{
"models": {
"providers": {
"doubao": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
"apiKey": "",
"api": "openai-completions",
"models": [
{
"id": "",
"name": "",
"reasoning": true,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192,
"compat": {
"supportsDeveloperRole": false
}
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "doubao/"
}
}
}
}
 
  1. 配置修改完成后，执行以下命令重启 gateway。
pkill -f openclaw
openclaw gateway restart
 

在 OpenClaw 中无法识别图片，如何处理？

  1. 确认模型支持图片输入。
检查配置文件 ~/.openclaw/openclaw.json 中的模型input字段是否包含 image 输入类型。以模型 kimi-k2.5 为例，配置信息如下：
"models": {
"providers": {
"volcengine": {
"models": [
{
"id": "kimi-k2.5",
"name": "kimi-k2.5",
"input": ["text", "image"],
...
}
]
}
}
}
  1. 配置 Image Model，并检查模型别名配置。
在 agents.defaults.imageModel 中显式设置用于图片识别的模型，确保 agents.defaults.models 中包含正确的模型别名。
"agents": {
"defaults": {
"imageModel": {
"primary": "volcengine/kimi-k2.5"
},
"models": {
"volcengine/kimi-k2.5": {
"alias": "volcengine"
}
},
...
}
}
  1. 重启 Gateway 使配置生效，然后即可在 OpenClaw 中识别图片。
openclaw gateway restart

安装 OpenClaw 时报错 “gateway connect failed: Error: pairing required”，如何处理？

执行以下命令删除设备和身份，然后重新安装网关并重启解决该问题。
 
rm -rf ~/.openclaw/devices
rm -rf ~/.openclaw/identity
openclaw gateway install --force
openclaw gateway start
 
 
end