👾Code Agent với MODAS (FPT Cloud API)

Sử dụng hiệu quả với Code Agent

Để tối ưu khả năng của các model từ MODAS, cần hướng dẫn rõ ràng để tránh agent loop vô tận hoặc sinh code sai hướng...

Nguyên tắc khi ra lệnh (recommend dùng tiếng Anh):

Tận dụng AGENTS.md — đặt file AGENTS.md ở root repo để agent tự đọc context, working principles, và common commands khi bắt đầu session. Các tool như OpenCode, Cline, Roocode đều hỗ trợ đọc file này tự động. Instruction này đã đính kèm một file AGENTS.md để sử dụng
- AGENTS.md → dành cho OpenCode (Sisyphus)
- CLAUDE.md → dành cho Claude CLI (claude)
Ngắn, cụ thể, có ví dụ — thay vì "fix the auth", viết: "In auth.py:45, replace token = req.headers.get('token') with token = req.headers.get('Authorization', '').removeprefix('Bearer ')"
Kiểm soát code loop — nếu agent lặp lại nhiều lần mà không tiến triển, dùng: "Stop. Summarize what you've tried and what's blocking you." Hoặc thêm điều kiện dừng: "If you can't fix it in 3 attempts, stop and explain."
Chia nhỏ task — "Only do step 1: write the function. Don't run or test yet." Luôn yêu cầu agent plan trước, thực hiện sau — "List the steps you'll take. Don't execute yet."

API Endpoint: https://mkp-api.fptcloud.com/v1 Proxy công ty: http://10.36.232.10:8080

1. OpenCode

Cài đặt

# Xin quyền Admin tại: https://uservice.fci.vn/secure/SSC01CreateTicket.jspa?processId=147&catalogId=2&issueKeys=
# (tích ô Whitelist)

# Cài Node.js LTS
winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements

# Cài OpenCode (npm hoặc scoop/chocolatey)
npm install -g opencode-ai
# Hoặc: scoop install opencode  /  choco install opencode

Cấu hình API

File: %USERPROFILE%\.config\opencode\opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "fpt": {
      "name": "fpt",
      "npm": "@ai-sdk/openai-compatible",
      "models": {
        "Qwen3.6-27B": { "name": "Qwen3.6-27B" }
      },
      "options": {
        "baseURL": "https://mkp-api.fptcloud.com/v1",
        "headers": {
          "Authorization": "Bearer <API_KEY>"
        }
      }
    }
  }
}

Chạy (Windows)

$env:HTTPS_PROXY = "http://10.36.232.10:8080"
$env:HTTP_PROXY  = "http://10.36.232.10:8080"
$env:NO_PROXY    = "localhost,127.0.0.1"

opencode

Ubuntu

Cài đặt:

# Xin quyền Admin tại: https://uservice.fci.vn/secure/SSC01CreateTicket.jspa?processId=147&catalogId=2&issueKeys=
# (tích ô Whitelist)

# Cài Node.js LTS (yêu cầu cho OpenCode)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Cài OpenCode (official installer)
export https_proxy="http://10.36.232.10:8080"
export http_proxy="http://10.36.232.10:8080"
export no_proxy="localhost,127.0.0.1"

curl -fsSL https://opencode.ai/install | bash

Hoặc dùng npm:

npm install -g opencode-ai

Cấu hình API:

Tạo folder opencode (nếu chưa có): mkdir $HOME/.config/opencode

Tạo file opencode.jsonc: touch $HOME/.config/opencode/opencode.jsonc

Tạo API key cho model: Qwen 3.6-27B trên AI marketplace: https://marketplace.fptcloud.com/

Cập nhật file: $HOME/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "fpt": {
      "name": "fpt",
      "npm": "@ai-sdk/openai-compatible",
      "models": {
        "Qwen3.6-27B": { "name": "Qwen3.6-27B" }
      },
      "options": {
        "baseURL": "https://mkp-api.fptcloud.com/v1",
        "headers": {
          "Authorization": "Bearer <API_KEY>"
        }
      }
    }
  }
}

Chạy:

export HTTPS_PROXY="http://10.36.232.10:8080"
export HTTP_PROXY="http://10.36.232.10:8080"
export NO_PROXY="localhost,127.0.0.1"

opencode

OPTIONAL:

Sử dụng thêm plugin oh my openagent để có trải nghiệm tốt hơn https://github.com/code-yeongyu/oh-my-openagent

2. Cline (VS Code Extension)

Cài extension Cline trong VS Code
Mở Settings của Cline → chọn API Provider: OpenAI Compatible
Điền:

Trường

Giá trị

Base URL

https://mkp-api.fptcloud.com/v1

API Key

<API_KEY>

Model

Qwen3.6-27B

Cấu hình proxy trong VS Code settings (settings.json):

"http.proxy": "http://10.36.232.10:8080"

3. Roocode (VS Code Extension)

Xem hướng dẫn kết nối OpenAI-compatible provider: https://docs.roocode.com/providers/openai-compatible

Điền thông tin:

Base URL: https://mkp-api.fptcloud.com/v1
API Key: <API_KEY>
Model: Qwen3.6-27B

4. Claude CLI với FPT MKP

Claude CLI gửi API key qua header x-api-key (kiểu Anthropic), nhưng MKP yêu cầu Authorization: Bearer. Cách dưới đây override env vars để Claude CLI hoạt động đúng với MKP, dùng config directory riêng tránh xung đột với tài khoản claude.ai.

Lưu ý: Cấu hình ở dưới sử dụng MODAS site VN (Việt Nam). Nếu muốn sử dụng từ site JP, đổi base URL về https://mkp-api.fptcloud.jp và dùng API key tạo từ MODAS JP là được.

Cấu hình (thêm vào PowerShell Profile)

Mở profile:

notepad $PROFILE

Thêm vào cuối file:

$env:MKP_API_BASE = "https://mkp-api.fptcloud.com"
$env:MKP_API_KEY  = "sk-..."

function claude-mkp {
    $model = if ($env:CLAUDE_MKP_MODEL) { $env:CLAUDE_MKP_MODEL } else { "Qwen3.6-27B" }

    $savedApiKey = $env:ANTHROPIC_API_KEY
    $savedOAuth  = $env:CLAUDE_CODE_OAUTH_TOKEN
    Remove-Item Env:ANTHROPIC_API_KEY        -ErrorAction SilentlyContinue
    Remove-Item Env:CLAUDE_CODE_OAUTH_TOKEN  -ErrorAction SilentlyContinue

    $env:CLAUDE_CONFIG_DIR              = "$env:USERPROFILE\.claude-mkp"
    $env:ANTHROPIC_BASE_URL             = $env:MKP_API_BASE
    $env:ANTHROPIC_AUTH_TOKEN           = $env:MKP_API_KEY
    $env:ANTHROPIC_MODEL                = $model
    $env:ANTHROPIC_SMALL_FAST_MODEL     = $model
    $env:ANTHROPIC_DEFAULT_SONNET_MODEL = $model
    $env:ANTHROPIC_DEFAULT_OPUS_MODEL   = $model
    $env:ANTHROPIC_DEFAULT_HAIKU_MODEL  = $model
    $env:HTTPS_PROXY                    = "http://10.36.232.10:8080"
    $env:HTTP_PROXY                     = "http://10.36.232.10:8080"
    $env:NO_PROXY                       = "localhost,127.0.0.1"

    try {
        claude @args
    } finally {
        if ($savedApiKey) { $env:ANTHROPIC_API_KEY = $savedApiKey }
        else { Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue }
        if ($savedOAuth)  { $env:CLAUDE_CODE_OAUTH_TOKEN = $savedOAuth }
        else { Remove-Item Env:CLAUDE_CODE_OAUTH_TOKEN -ErrorAction SilentlyContinue }
        @("CLAUDE_CONFIG_DIR","ANTHROPIC_BASE_URL","ANTHROPIC_AUTH_TOKEN",
          "ANTHROPIC_MODEL","ANTHROPIC_SMALL_FAST_MODEL","ANTHROPIC_DEFAULT_SONNET_MODEL",
          "ANTHROPIC_DEFAULT_OPUS_MODEL","ANTHROPIC_DEFAULT_HAIKU_MODEL",
          "HTTPS_PROXY","HTTP_PROXY","NO_PROXY") | ForEach-Object {
            Remove-Item "Env:$_" -ErrorAction SilentlyContinue
        }
    }
}

function ccdm { claude-mkp --dangerously-skip-permissions @args }

Các lệnh

Lệnh

Mô tả

claude-mkp

Chạy Claude CLI qua MKP

claude-mkp <args>

Truyền thêm args như bình thường

ccdm

Chạy với --dangerously-skip-permissions

Đổi model tạm thời:

$env:CLAUDE_MKP_MODEL = "other-model"; claude-mkp

Ubuntu

Thêm vào ~/.bashrc hoặc ~/.zshrc:

export MKP_API_BASE="https://mkp-api.fptcloud.com"
export MKP_API_KEY="sk-..."

claude-mkp() {
    local model="${CLAUDE_MKP_MODEL:-Qwen3.6-27B}"

    local saved_api_key="$ANTHROPIC_API_KEY"
    local saved_oauth="$CLAUDE_CODE_OAUTH_TOKEN"
    unset ANTHROPIC_API_KEY
    unset CLAUDE_CODE_OAUTH_TOKEN

    export CLAUDE_CONFIG_DIR="$HOME/.claude-mkp"
    export ANTHROPIC_BASE_URL="$MKP_API_BASE"
    export ANTHROPIC_AUTH_TOKEN="$MKP_API_KEY"
    export ANTHROPIC_MODEL="$model"
    export ANTHROPIC_SMALL_FAST_MODEL="$model"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="$model"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="$model"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="$model"
    export HTTPS_PROXY="http://10.36.232.10:8080"
    export HTTP_PROXY="http://10.36.232.10:8080"
    export NO_PROXY="localhost,127.0.0.1"

    claude "$@"
    local exit_code=$?

    if [ -n "$saved_api_key" ]; then
        export ANTHROPIC_API_KEY="$saved_api_key"
    else
        unset ANTHROPIC_API_KEY
    fi
    if [ -n "$saved_oauth" ]; then
        export CLAUDE_CODE_OAUTH_TOKEN="$saved_oauth"
    else
        unset CLAUDE_CODE_OAUTH_TOKEN
    fi
    unset CLAUDE_CONFIG_DIR ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN \
          ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL \
          ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL \
          HTTPS_PROXY HTTP_PROXY NO_PROXY

    return $exit_code
}

ccdm() { claude-mkp --dangerously-skip-permissions "$@"; }

Đổi model tạm thời:

CLAUDE_MKP_MODEL="other-model" claude-mkp

Tại sao dùng `ANTHROPIC_AUTH_TOKEN` thay vì `ANTHROPIC_API_KEY`?

Header gửi đi

Biến dùng

MKP chấp nhận?

x-api-key: sk-...

ANTHROPIC_API_KEY

Không → 401

Authorization: Bearer sk-...

ANTHROPIC_AUTH_TOKEN

Có → 200 OK

Kiểm tra kết nối

curl.exe -sS -X POST "$env:MKP_API_BASE/v1/messages" `
  -H "Authorization: Bearer $env:MKP_API_KEY" `
  -H "anthropic-version: 2023-06-01" `
  -H "Content-Type: application/json" `
  -d '{"model":"Qwen3.6-27B","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Xử lý sự cố

Triệu chứng

Nguyên nhân / Giải pháp

Auth conflict warning

Kiểm tra CLAUDE_CONFIG_DIR được set bên trong function, không phải global

Retrying in Xs · attempt N/10

MKP từ chối auth — đảm bảo dùng ANTHROPIC_AUTH_TOKEN, không phải ANTHROPIC_API_KEY

401 "Missing API Key"

Sai header — phải dùng Authorization: Bearer, không phải x-api-key

PreviousHow to Use OpenClaw with FPT AI Inference NextAGENTS.md

Last updated 25 days ago

Was this helpful?

Sử dụng hiệu quả với Code Agent

1. OpenCode

Cài đặt

Cấu hình API

Chạy (Windows)

Ubuntu

OPTIONAL:

2. Cline (VS Code Extension)

3. Roocode (VS Code Extension)

4. Claude CLI với FPT MKP

Cấu hình (thêm vào PowerShell Profile)

Các lệnh

Ubuntu

Tại sao dùng ANTHROPIC_AUTH_TOKEN thay vì ANTHROPIC_API_KEY?

Kiểm tra kết nối

Xử lý sự cố

Tại sao dùng `ANTHROPIC_AUTH_TOKEN` thay vì `ANTHROPIC_API_KEY`?