Skip to main content

Coding Agent Integration FAQs

  • Updated

Here are some of the most frequently asked questions regarding the Coding Agent integration.

 

Table of Contents

For more detailed information, please also refer to the Coding Agent documentation available on Matlantis.

 

 

Q: When will the installer be available?

A: It is already available.

Please refer to the release notes dated June 8, 2026. We have released installers for the CLI tools that enable Claude Code and Codex to run on Matlantis. Installing these will automatically implement the Matlantis Agent Skills plugin.

For installation instructions, please refer to this section.

To learn more about Matlantis Agent Skills, please see the next section.

 

Back to Table of Contents ⏎

 

 

Q: What is the "Matlantis Agent Skills" library?

A: It is a collection of skills designed to help Claude Code and Codex support atomistic simulations on the Matlantis platform.

It is publicly available on GitHub:
https://github.com/matlantis/matlantis-agent-skills

You can also load and use these skills with other coding agents for which an installer is not currently provided.
For instructions on how to install it for GitHub Copilot, please see this section.

 

Back to Table of Contents ⏎

 

 

 

Q: Is it free to use?

A: The installers provided by Matlantis are free of charge.

While the installers for Claude Code and Codex—available via the Matlantis Package Launcher—are free, you will need separate active subscriptions or contracts with their respective providers to use Claude Code and Codex.

 

Back to Table of Contents ⏎

 

 

Q: How do I install it?

A: You can install it via the Package Launcher. Please see below for detailed instructions.

 

Installation Steps:

1. Enable the Feature (Admin Only)

Go to "Organization" > "External Tool" to enable the feature. Once enabled, the installer will appear in the Package Launcher.

Note: In the screenshot, both options are enabled, but the default setting for both is "Disabled".
Note: This setting applies to the entire tenant.

 

 

2. Install via the Package Launcher

Open the Package Launcher, and you will find the installers under "Third Party Tools". Click "install" to proceed.

Note: After installation, the button will change to "update" or "reinstall".
Note: When "update" is displayed, it means a new update is available. Please update the tool.

 

 

 

Alternative: Installation via Terminal

You can also install the tools directly from the terminal.

For Claude Code:

curl -fsSL https://claude.ai/install.sh | bash

 

For Codex CLI:

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

 

3. Log In on First Launch

3-1. Activate the Python Virtual Environment

Open the terminal. First, activate your Python virtual environment.

For Python 3.13:

use_venv python313

Note: If (.py313) is already displayed in your terminal, the Python 3.13 virtual environment is already active, so you can skip the use_venv command.

 

 

 

 

3-2. Log In

Run the claude command for Claude Code, or codex login for Codex.

 

For Claude Code:

claude

 

For Codex:

codex login

 

 

3-3. Authentication Setup (Claude Code Example)

The authentication process will begin. The following steps use Claude Code as an example. Authentication methods may vary depending on the service.

First, configure the color scheme. Use the Up/Down arrow keys (↑↓) to select and press Enter to confirm.

 

 

 

3-4. Select Authentication Method

Note: 3rd-party platforms are not currently supported.

 

 

3-5. Authenticate via Browser

Your browser should open automatically for authentication. 

 

 

If it does not, copy the URL and open it manually in your browser. (You can select the URL and right-click to copy).

 

 

Approve the request in your browser to obtain your authentication code.

Paste the authentication code into the terminal and press Enter.

 

 

3-6. Login Successful

Once logged in, you will not need to repeat this authentication process in the future.

 

A disclaimer will also be displayed.

 

Select "Yes" to continue working.
Select "No" if you just want to finish the installation for now.

 

Back to Table of Contents ⏎

 

Q: How do I use it?

A: You can use it by launching and operating the CLI tool from the terminal.

The following steps use Claude Code as an example.

First, open the terminal and navigate to your working directory (folder). The working directory is the folder where Claude Code is permitted to perform operations, such as reading and writing files.
If you already have a notebook open in that same folder, it is convenient to open the terminal by clicking "Open in Terminal" directly from the notebook.


For other ways to open the terminal, please see that page.

 

How to Use

1. Activate the Python virtual environment.

 

for Python 3.13 

use_venv python313

 

2. Launch the tool using the claude command.

claude

 

 

3. You can now operate the tool via the prompt. (Naturally, it also supports Japanese).

 

Back to Table of Contents ⏎

 

 

Q: How do I uninstall it?

A: You can uninstall it via the terminal.

For Claude Code, run the following command in the terminal:

uninstall claude

After running the command, please follow the on-screen instructions.

Note: Since Claude Code does not have the necessary permissions to execute commands like rm (remove), you will need to manually run those file-deletion commands yourself when prompted.

 

 

Back to Table of Contents ⏎

 

 

Q: Is GitHub Copilot supported?

A: Currently, operations on Matlantis have not been verified for tools where an installer is not officially provided.

However, it is possible to operate Matlantis via an SSH connection by installing the GitHub Copilot extension in VS Code.

Additionally, to use the matlantis-agent-skills library with GitHub Copilot, please follow the steps below:

  1. git clone or download the repository from https://github.com/matlantis/matlantis-agent-skills
  2. Save the plugins/matlantis/skills folder into your root directory (/home/jovyan//home/jovyan/) as a .copilot folder (so the path becomes /home/jovyan/.copilot/skills).
  3. Open the root directory in VS Code to use GitHub Copilot.

Note: If it does not work as expected, try placing the skills folder at the root of the workspace folder currently open in VS Code (e.g., .github/skills/).

Please also refer to the official Microsoft documentation for further details:
"Use Agent Skills with GitHub Copilot" https://learn.microsoft.com/en-us/visualstudio/ide/copilot-agent-skills?view=visualstudio

 

 

Back to Table of Contents ⏎

Related to

Related articles